Skip to content

Commit cdc7ded

Browse files
committed
[css-text-decor-4] Fix links
1 parent fcdca49 commit cdc7ded

File tree

1 file changed

+34
-32
lines changed

1 file changed

+34
-32
lines changed

css-text-decor-4/Overview.bs

Lines changed: 34 additions & 32 deletions
Original file line numberDiff line numberDiff line change
@@ -71,52 +71,52 @@ Determining the Position and Thickness of Line Decorations</h3>
7171

7272
<p>Since line decorations can span elements with varying font sizes and
7373
vertical alignments, the best position for a line decoration is not
74-
necessarily the ideal position dictated by the <i>decorating box</i>.
75-
Instead, it's calculated, per line, from all text decorated by the <i>decorating box</i> on that line,
74+
necessarily the ideal position dictated by the <a>decorating box</a>.
75+
Instead, it's calculated, per line, from all text decorated by the <a>decorating box</a> on that line,
7676
the <dfn>considered text</dfn>.
77-
However, descendants of the <i>decorating box</i>
77+
However, descendants of the <a>decorating box</a>
7878
that are skipped due to 'text-decoration-skip',
7979
descendant inlines with ''text-decoration-skip: ink'',
80-
and any descendants that do not participate in the <i>decorating box</i>’s inline formatting context
81-
are excluded from the set of <i>considered text</i>.
80+
and any descendants that do not participate in the <a>decorating box</a>’s inline formatting context
81+
are excluded from the set of <a>considered text</a>.
8282

8383
<p>
8484
The line decoration positions are then calculated
8585
per line
8686
as follows
87-
(treating <a><i>over</i>-positioned underlines</a> as <i>over</i> lines
88-
and <a><i>under</i>-positioned overlines</a> as <i>under</i> lines):
87+
(treating <a>over</a>-positioned underlines</a> as <a>over</a> lines
88+
and <a>under</a>-positioned overlines</a> as <a>under</a> lines):
8989

9090
<dl>
91-
<dt><a href="https://www.w3.org/TR/css-writing-modes/#over"><i>over</i></a> lines
91+
<dt><a>over</a> lines
9292
<dd>
9393
Align the line decoration with respect to the highest
94-
<a href="https://www.w3.org/TR/css-writing-modes/#over"><i>over</i></a> EM-box edge
95-
of the <i>considered text</i>.
94+
<a>over</a> EM-box edge
95+
of the <a>considered text</a>.
9696

97-
<dt><a><i>alphabetic</i></a> underlines
97+
<dt><a>alphabetic</a> underlines
9898
<dd>
9999
<p>The alphabetic underline position is calculated by taking
100-
the ideal offset (from the alphabetic baseline) of each run of <i>considered text</i>,
100+
the ideal offset (from the alphabetic baseline) of each run of <a>considered text</a>,
101101
averaging those, and then using the lowest alphabetic baseline to actually position the line.
102-
(Alphabetic baselines can differ between ''baseline''-aligned boxes
102+
(Alphabetic baselines can differ between ''vertical-align/baseline''-aligned boxes
103103
if the dominant baseline is non-alphabetic.)
104104
To prevent superscripts and subscripts from throwing this position off-kilter,
105105
an inline with a non-initial computed 'vertical-align'
106106
is treated as having the ideal underline position of its parent.
107107

108-
<dt>non-alphabetic <a href="https://www.w3.org/TR/css-writing-modes/#under"><i>under</i></a> lines
108+
<dt>non-alphabetic <a>under</a> lines
109109
<dd>
110110
Position the line decoration with respect to the lowest
111-
<a href="https://www.w3.org/TR/css-writing-modes/#under"><i>under</i></a> EM-box edge
112-
of the <i>considered text</i>.
111+
<a>under</a> EM-box edge
112+
of the <a>considered text</a>.
113113

114114
<dt>line-throughs
115115
<dd>
116116
Line-throughs essentially use the same sort of averaging as for alphabetic underlines,
117117
but recompute the position when drawing across a descendant with a different computed 'font-size'.
118118
(This ensures that the text remains effectively “crossed out” despite any font size changes.)
119-
For each run of <i>considered text</i> with the same 'font-size',
119+
For each run of <a>considered text</a> with the same 'font-size',
120120
compute an ideal position averaged from its font metrics.
121121
To prevent superscripts and subscripts from throwing this position off-kilter,
122122
an inline with a non-initial computed 'vertical-align'
@@ -129,7 +129,7 @@ Determining the Position and Thickness of Line Decorations</h3>
129129
but there doesn't appear to be any way to avoid that which is correct in all instances,
130130
and all attempts are worryingly complex.
131131
What position should line-throughts adopt over elements that have a different font-size,
132-
but no <i>considered text</i>?
132+
but no <a>considered text</a>?
133133
</dl>
134134

135135
<p>
@@ -218,7 +218,8 @@ Text Underline Offset: the 'text-underline-offset' property</h3>
218218
219219
<ul>
220220
<li>The line is aligned to the outside of the specified position.
221-
(Below for ''under''/''auto'' positions, above for ''over''.)
221+
(Below for ''text-underline-position/under''/''text-underline-position/auto'' positions,
222+
above for ''text-underline-position/over''.)
222223
<li>Positive lengths represent inward distances; negative lengths outward.
223224
<li>Automatic adjustments made to accommodate descendant content are maintained;
224225
the 'text-underline-offset' is in addition to those.
@@ -229,15 +230,15 @@ Text Underline Offset: the 'text-underline-offset' property</h3>
229230
''spelling-error'' or ''grammar-error'',
230231
the UA may ignore the value of 'text-underline-position'.
231232
232-
<h3>
233+
<h3 id="text-decoration-skipping">
233234
Text Decoration Line Continuity</h3>
234235
235236
<h4 id="text-decoration-skip-property">
236237
Text Decoration Line Continuity: the 'text-decoration-skip' property</h4>
237238
238239
<pre class="propdef">
239240
Name: text-decoration-skip
240-
Value: ''none'' | [ ''objects'' || [ ''spaces'' | [ ''leading-spaces'' || ''trailing-spaces'' ] ] || ''edges'' || ''box-decoration'' ]
241+
Value: none | [ objects || [ spaces | [ leading-spaces || trailing-spaces ] ] || edges || box-decoration ]
241242
Initial: objects leading-spaces trailing-spaces
242243
Applies to: all elements
243244
Inherited: yes
@@ -277,14 +278,14 @@ Text Decoration Line Continuity: the 'text-decoration-skip' property</h4>
277278

278279
<dt><dfn value for="text-decoration-skip">spaces</dfn></dt>
279280
<dd>
280-
Skip all spacing, i.e. all <i>characters</i> with the Unicode White_Space property [[UAX44]],
281+
Skip all spacing, i.e. all <a>typographic character units</a> with the Unicode White_Space property [[UAX44]],
281282
plus any adjacent 'letter-spacing' or 'word-spacing'.
282283

283284
<dt><dfn value for="text-decoration-skip">edges</dfn></dt>
284285
<dd>
285286
The UA should place the start and end of the line inwards slightly
286287
(e.g. by half a line thickness)
287-
from the content edge of the <i>decorating box</i> so that,
288+
from the content edge of the <a>decorating box</a> so that,
288289
e.g. two underlined elements side-by-side do not appear to have a single underline.
289290
(This is important in Chinese, where underlining is a form of punctuation.)
290291

@@ -301,20 +302,20 @@ Text Decoration Line Continuity: the 'text-decoration-skip' property</h4>
301302
<dd>
302303
Skip over the box's margin, border, and padding areas.
303304
Note that this only has an effect on decorations imposed by an ancestor;
304-
a <i>decorating box</i> never draws over its own box decoration.
305+
a <a>decorating box</a> never draws over its own box decoration.
305306

306307
<dt><dfn>leading-spaces</dfn></dt>
307308
<dd>
308309
Skip all spacing,
309-
i.e. all <i>characters</i> with the Unicode White_Space property [[UAX44]]
310+
i.e. all <a>typographic character units</a> with the Unicode White_Space property [[UAX44]]
310311
and all <a href="https://www.w3.org/TR/css3-text/#word-separator">word separators</a>
311312
plus any adjacent 'letter-spacing' or 'word-spacing',
312313
when located at the start of the line.
313314

314315
<dt><dfn>trailing-spaces</dfn></dt>
315316
<dd>
316317
Skip all spacing,
317-
i.e. all <i>characters</i> with the Unicode White_Space property [[UAX44]]
318+
i.e. all <a>typographic character units</a> with the Unicode White_Space property [[UAX44]]
318319
and all <a href="https://www.w3.org/TR/css3-text/#word-separator">word separators</a>
319320
plus any adjacent 'letter-spacing' or 'word-spacing',
320321
when located at the end of the line.
@@ -337,8 +338,8 @@ Text Decoration Line Continuity: the 'text-decoration-skip-ink' property</h4>
337338

338339
<pre class="propdef">
339340
Name: text-decoration-skip-ink
340-
Value: ''auto'' | ''none''
341-
Initial: 'auto'
341+
Value: auto | none
342+
Initial: ''auto''
342343
Applies to: all elements
343344
Inherited: yes
344345
Percentages: N/A
@@ -364,10 +365,10 @@ Text Decoration Line Continuity: the 'text-decoration-skip-ink' property</h4>
364365
</div>
365366

366367
<div class="issue">
367-
Ideographic scripts do not want to skip when 'auto'.
368+
Ideographic scripts do not want to skip when ''text-decoration-skip-ink/auto''.
368369
How can we define this behavior?
369370
Are there more scripts wanting not to skip?
370-
Need some normative text describe how 'auto' works.
371+
Need some normative text describe how ''text-decoration-skip-ink/auto'' works.
371372
See
372373
<a href="https://lists.w3.org/Archives/Public/www-style/2017Feb/0069.html">telcon minutes</a>,
373374
<a href="https://github.com/w3c/alreq/issues/86">alreq#86</a>,
@@ -389,14 +390,15 @@ Text Decoration Line Continuity: the 'text-decoration-skip-ink' property</h4>
389390

390391
</dl>
391392

392-
<h2 id="text-shadow-property">Text Shadows: the 'text-shadow' property</h2>
393+
<h2 id="text-shadow-property">
394+
Additional Conrols for Text Shadows</h2>
393395

394396
Level 4 adds a spread radius argument to 'text-shadow',
395397
using the same syntax and interpretation as for 'box-shadow',
396398
except that corners are always rounded
397399
(since the geometry of a glyph is not so simple as a box).
398400

399-
<h2 id="line-decoration">
401+
<h2 id="emphasis-marks">
400402
Additional Controls for Emphasis Marks</h2>
401403

402404
Issue: See also <a href="https://github.com/w3c/csswg-drafts/issues/1892">issue about continuity in size/position</a>.

0 commit comments

Comments
 (0)