Skip to content

Commit ecd0e92

Browse files
committed
Update docs for previous changes
1 parent c78b885 commit ecd0e92

10 files changed

Lines changed: 27 additions & 12 deletions

File tree

docs/CSS12-user_prefs.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -147,8 +147,6 @@ Users may want to normalize text (no bold, no italics, etc.) for accessibility r
147147

148148
Supported value: `readium-a11y-on`
149149

150-
Required flag: `--USER__fontOverride: readium-font-on`
151-
152150
To disable the normalization, you can either set an empty string as a value or remove the property.
153151

154152
### Hiding Ruby Text

docs/CSS19-api.md

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -199,8 +199,6 @@ Preset: `--USER__a11yNormalize: readium-a11y-on`
199199

200200
Scope: `html`
201201

202-
Required flag: `:--fontOverride`
203-
204202
Override class: User settings advanced (optional but should be applied by any means necessary if provided to users)
205203

206204
It impacts font style, weight and variant, text decoration, super and subscripts.

docs/CSS28-migration_guide.md

Lines changed: 7 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -188,4 +188,10 @@ These settings now work without the flag. This provides with more flexibility si
188188

189189
It’s been replaced with the flag `--USER__fontSizeNormalize: readium-normalize-on`, whose purpose is to simply force ReadiumCSS 1’s normalization so that the font-size user setting can be guaranteed to work on all publications, even if the book’s font-sizing is styled using absolute units.
190190

191-
This repurposed flag can be appended as you see fit, when CSS property `zoom` is not supported: you can present it as a toggle to users, or append it programmatically, or append it automatically, etc.
191+
This repurposed flag can be appended as you see fit, when CSS property `zoom` is not supported: you can present it as a toggle to users, or append it programmatically, or append it automatically, etc.
192+
193+
## Removal of line-height compensation for A11y fonts and normalization
194+
195+
Since version `2.0.0-beta.11`, ReadiumCSS no longer applies a line-height compensation when AccessibleDfA and IA Writer Duospace are the current user font, or the accessibility normalize flag is set.
196+
197+
That was a side-effect that could be surprising to implementers, and impacting their line-height user setting experience.

docs/ReadiumCSS_docs.epub

200 Bytes
Binary file not shown.

docs/ReadiumCSS_docs/OEBPS/Text/Section-012.xhtml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -168,8 +168,6 @@ root.style.setProperty("name of var", "");</code></pre>
168168

169169
<p>Supported value: <code>readium-a11y-on</code></p>
170170

171-
<p>Required flag: <code>--USER__fontOverride: readium-font-on</code></p>
172-
173171
<p>Override class: User settings advanced (optional but should be applied by any means necessary if provided to users)</p>
174172

175173
<p>To disable the normalization, you can either set an empty string as a value or remove the property.</p>

docs/ReadiumCSS_docs/OEBPS/Text/Section-019.xhtml

Lines changed: 0 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -184,8 +184,6 @@
184184

185185
<p>Scope: <code>html</code></p>
186186

187-
<p>Required flag: <code>:--fontOverride</code></p>
188-
189187
<p>Override class: User settings advanced (optional but should be applied by any means necessary if provided to users)</p>
190188

191189
<p>It impacts font style, weight and variant, text decoration, super and subscripts.</p>

docs/ReadiumCSS_docs/OEBPS/Text/Section-028.xhtml

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -228,6 +228,14 @@ const sepiaBackground = sepiaMode.sepiaMode.RS__backgroundColor;</code></pre>
228228

229229
<p>This repurposed flag can be appended as you see fit, when CSS property <code>zoom</code> is not supported: you can present it as a toggle to users, or append it programmatically, or append it automatically, etc.</p>
230230
</section>
231+
232+
<section id="line-height-compensation" class="level2">
233+
<h2 id="sigil_toc_id_213">Removal of line-height compensation for A11y fonts and normalization</h2>
234+
235+
<p>Since version <code>2.0.0-beta.11</code>, ReadiumCSS no longer applies a line-height compensation when AccessibleDfA and IA Writer Duospace are the current user font, or the accessibility normalize flag is set.</p>
236+
237+
<p>That was a side-effect that could be surprising to implementers, and impacting their line-height user setting experience.</p>
238+
</section>
231239
</section>
232240
</body>
233241
</html>

docs/ReadiumCSS_docs/OEBPS/Text/nav.xhtml

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -747,6 +747,9 @@
747747
<li>
748748
<a href="../Text/Section-028.xhtml#sigil_toc_id_212">Removal of advanced settings flag</a>
749749
</li>
750+
<li>
751+
<a href="../Text/Section-028.xhtml#sigil_toc_id_213">Removal of line-height compensation for A11y fonts and normalization</a>
752+
</li>
750753
</ol>
751754
</li>
752755
</ol>

docs/ReadiumCSS_docs/OEBPS/content.opf

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -8,7 +8,7 @@
88
<dc:language>en</dc:language>
99
<dc:identifier id="epub-id-1">urn:uuid:527D093B-9C0A-4C83-8AF6-0A40E91D30FC</dc:identifier>
1010
<meta name="cover" content="cover_jpg" />
11-
<meta property="dcterms:modified">2025-02-21T14:18:37Z</meta>
11+
<meta property="dcterms:modified">2025-04-14T12:35:00Z</meta>
1212
<meta name="Sigil version" content="0.9.8" />
1313
<meta property="schema:accessibilityFeature">displayTransformability</meta>
1414
<meta property="schema:accessibilityFeature">readingOrder</meta>

docs/ReadiumCSS_docs/OEBPS/toc.ncx

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1359,18 +1359,24 @@
13591359
</navLabel>
13601360
<content src="Text/Section-028.xhtml#sigil_toc_id_209"/>
13611361
</navPoint>
1362-
<navPoint id="navPoint226">
1362+
<navPoint id="navPoint226">
13631363
<navLabel>
13641364
<text>Removal of Dynamic Leading</text>
13651365
</navLabel>
13661366
<content src="Text/Section-028.xhtml#sigil_toc_id_211"/>
13671367
</navPoint>
1368-
<navPoint id="navPoint227">
1368+
<navPoint id="navPoint227">
13691369
<navLabel>
13701370
<text>Removal of advanced settings flag</text>
13711371
</navLabel>
13721372
<content src="Text/Section-028.xhtml#sigil_toc_id_212"/>
13731373
</navPoint>
1374+
<navPoint id="navPoint228">
1375+
<navLabel>
1376+
<text>Removal of line-height compensation for A11y fonts and normalization</text>
1377+
</navLabel>
1378+
<content src="Text/Section-028.xhtml#sigil_toc_id_213"/>
1379+
</navPoint>
13741380
</navPoint>
13751381
</navMap>
13761382
</ncx>

0 commit comments

Comments
 (0)