Skip to content

Commit 59f7513

Browse files
committed
[css-text-decor] Markup fixes
1 parent 91f7a5e commit 59f7513

File tree

2 files changed

+20
-20
lines changed

2 files changed

+20
-20
lines changed

css-text-decor-3/Overview.bs

+14-14
Original file line numberDiff line numberDiff line change
@@ -12,9 +12,9 @@ Previous Version: https://www.w3.org/TR/2018/CR-css-text-decor-3-20180703/
1212
Previous Version: https://www.w3.org/TR/2013/CR-css-text-decor-3-20130801/
1313
Previous Version: https://www.w3.org/TR/2013/WD-css-text-decor-3-20130103/
1414
Previous Version: https://www.w3.org/TR/2012/WD-css-text-decor-3-20121113/
15-
Issue Tracking: Tracker http://www.w3.org/Style/CSS/Tracker/products/10
1615
Editor: Elika J. Etemad / fantasai, Invited Expert, http://fantasai.inkedblade.net/contact, w3cid 35400
1716
Editor: Koji Ishii, Google, kojiishi@gmail.com, w3cid 45369
17+
Implementation Report: https://wpt.fyi/results/css/css-text-decor
1818
Abstract: This module contains the features of CSS relating to text decoration, such as underlines, text shadows, and emphasis marks.
1919
At Risk: The ability to place both emphasis marks and ruby on the same base text.
2020
Link Defaults: css-color-3 (property) color
@@ -68,9 +68,9 @@ Value Definitions</h3>
6868

6969
<h3 id="terms">Terminology</h3>
7070

71-
The terms <dfn><a href="https://www.w3.org/TR/css-text-3/#grapheme-cluster">character</a></dfn>,
72-
<dfn><a href="https://www.w3.org/TR/css-text-3/#letter">letter</a></dfn>, and
73-
<dfn><a href="https://www.w3.org/TR/css-text-3/#content-language">content language</a></dfn>
71+
The terms <a href="https://www.w3.org/TR/css-text-3/#grapheme-cluster">character</a>,
72+
<a href="https://www.w3.org/TR/css-text-3/#letter">letter</a>, and
73+
<a href="https://www.w3.org/TR/css-text-3/#content-language">content language</a>
7474
as used in this specification are defined in [[!CSS-TEXT-3]].
7575
Other terminology and concepts used in this specification are defined
7676
in [[!CSS2]] and [[!CSS-WRITING-MODES-4]].
@@ -103,12 +103,12 @@ Line Decoration: Underline, Overline, and Strike-Through</h2>
103103
and are drawn across all text (including white space, letter spacing, and word spacing)
104104
except spacing (white space, letter spacing, and word spacing) at the beginning and end of a line.
105105
<a>Atomic inlines</a>, such as images and inline blocks, are not decorated.
106-
Margins, borders, and padding of the <i>decorating box</i> are always skipped,
106+
Margins, borders, and padding of the [=decorating box=] are always skipped,
107107
however the margins, border, and padding of descendant <a>inline boxes</a> are not.
108108

109109
<p class='note'>
110110
Note that CSS 2.1 required skipping margins, borders, and padding always.
111-
In this level, by default only the margins, borders, and padding of the <i>decorating box</i> are skipped.
111+
In this level, by default only the margins, borders, and padding of the [=decorating box=] are skipped.
112112
In the future CSS2.1 may be updated to match this new default.
113113
Also, control over decorating leading/trailing spaces is expected in Level 4,
114114
and will be applied by default to the HTML <{ins}> and <{del}> elements.
@@ -181,7 +181,7 @@ Line Decoration: Underline, Overline, and Strike-Through</h2>
181181
(In the case of line decorations drawn over an atomic inline
182182
or across the margins/borders/padding of a non-replaced inline box,
183183
they are analogously associated with the affected atomic inline / non-replaced inline box
184-
rather than with the <i>decorating box</i>.)
184+
rather than with the [=decorating box=].)
185185

186186
<div class="example">
187187
In the following style sheet and document fragment:
@@ -402,7 +402,7 @@ Text Underline Position: the 'text-underline-position' property</h3>
402402

403403
<dt><dfn id="underline-under">under</dfn>
404404
<dd>
405-
The underline is positioned <i>under</i> the element's text content.
405+
The underline is positioned [=under=] the element's text content.
406406
In this case the underline usually does not cross the descenders.
407407
(This is sometimes called “accounting” underline.)
408408
This value can be combined with ''text-underline-position/left'' or ''text-underline-position/right''
@@ -475,7 +475,7 @@ Text Underline Position: the 'text-underline-position' property</h3>
475475
The exact position and thickness of line decorations is UA-defined in this level.
476476
However, for underlines and overlines
477477
the UA must use a single thickness and position on each line
478-
for the decorations deriving from a single <i>decorating box</i>.
478+
for the decorations deriving from a single [=decorating box=].
479479

480480
<div class="figure">
481481
<img src="images/underline-single.png"
@@ -489,7 +489,7 @@ Text Underline Position: the 'text-underline-position' property</h3>
489489
<div class="note">
490490
Note, since line decorations can span elements with varying font sizes and
491491
vertical alignments, the best position for a line decoration is not
492-
necessarily the ideal position dictated by the <i>decorating box</i>.
492+
necessarily the ideal position dictated by the [=decorating box=].
493493
For example, an overline positioned to a small font
494494
will effectively become a line-through if the element contains text in a significantly larger font-size.
495495
Even for underlines, if the text is not aligned to the alphabetic baseline
@@ -512,11 +512,11 @@ Text Underline Position: the 'text-underline-position' property</h3>
512512
</div>
513513

514514
UAs <em>must</em> adjust line positions
515-
to match the shifted metrics of <i>decorating boxes</i> shifted
515+
to match the shifted metrics of [=decorating boxes=] shifted
516516
with 'vertical-align' values other than ''vertical-align/baseline'' [[!CSS2]]
517517
or subscripted/superscripted via 'font-variant-position' [[!CSS-FONTS-3]],
518518
but <em>must not</em> adjust the line position or thickness
519-
in response to descendants of a <i>decorating box</i> that are so styled.
519+
in response to descendants of a [=decorating box=] that are so styled.
520520
This allows superscripts and subscripts to be properly decorated
521521
(underlined, struck through, etc.)
522522
but prevents them from distorting or breaking the positioning of such decorations on their ancestors.
@@ -616,7 +616,7 @@ Emphasis Mark Style: the 'text-emphasis-style' property</h3>
616616

617617
<dt><dfn><<string>></dfn>
618618
<dd>Display the given string as marks.
619-
Authors should not specify more than one <i>character</i> in &lt;string&gt;.
619+
Authors should not specify more than one [=character=] in &lt;string&gt;.
620620
The UA may truncate or ignore strings consisting of more than one grapheme cluster.
621621
</dl>
622622

@@ -1006,7 +1006,7 @@ Appendix B: Default UA Stylesheet</h2>
10061006
<h2 class="no-num" id="changes">Appendix C:
10071007
Changes</h2>
10081008

1009-
<h3 class="no-num" id="changes-2018">
1009+
<h3 class="no-num" id="changes-2019">
10101010
Changes since the <a href="https://www.w3.org/TR/2019/CR-css-text-decor-3-20190813/">August 2019 Candidate Recommendation</a></h3>
10111011

10121012
Changes include:

css-text-decor-4/Overview.bs

+6-6
Original file line numberDiff line numberDiff line change
@@ -562,7 +562,7 @@ Text Underline Position: the 'text-underline-position' property</h3>
562562

563563
<dt><dfn id="underline-under">under</dfn>
564564
<dd>
565-
The underline is positioned <i>under</i> the element's text content.
565+
The underline is positioned [=under=] the element's text content.
566566
In this case the underline usually does not cross the descenders.
567567
(This is sometimes called “accounting” underline.)
568568
This value can be combined with ''text-underline-position/left'' or ''text-underline-position/right''
@@ -758,7 +758,7 @@ Text Decoration Line Uniformity</h3>
758758
and is otherwise UA-defined.
759759
However, for underlines and overlines
760760
the UA must use a single thickness and position on each line
761-
for the decorations deriving from a single <i>decorating box</i>.
761+
for the decorations deriving from a single [=decorating box=].
762762

763763
<div class="figure">
764764
<img src="images/underline-single.png"
@@ -772,7 +772,7 @@ Text Decoration Line Uniformity</h3>
772772
<div class="note">
773773
Note, since line decorations can span elements with varying font sizes and
774774
vertical alignments, the best position for a line decoration is not
775-
necessarily the ideal position dictated by the <i>decorating box</i>.
775+
necessarily the ideal position dictated by the [=decorating box=].
776776
For example, an overline positioned to a small font
777777
will effectively become a line-through if the element contains text in a significantly larger font-size.
778778
Even for underlines, if the text is not aligned to the alphabetic baseline
@@ -795,11 +795,11 @@ Text Decoration Line Uniformity</h3>
795795
</div>
796796

797797
UAs <em>must</em> adjust line positions
798-
to match the shifted metrics of <i>decorating boxes</i> shifted
798+
to match the shifted metrics of [=decorating boxes=] shifted
799799
with 'vertical-align' values other than ''vertical-align/baseline'' [[!CSS2]]
800800
or subscripted/superscripted via 'font-variant-position' [[!CSS-FONTS-3]],
801801
but <em>must not</em> adjust the line position or thickness
802-
in response to descendants of a <i>decorating box</i> that are so styled
802+
in response to descendants of a [=decorating box=] that are so styled
803803
(even though it <em>may</em> adjust the position
804804
to accommodate descendants that are not so styled,
805805
such as those merely typeset in a different font size as noted above).
@@ -1283,7 +1283,7 @@ Emphasis Mark Style: the 'text-emphasis-style' property</h3>
12831283

12841284
<dt><dfn><<string>></dfn>
12851285
<dd>Display the given string as marks.
1286-
Authors should not specify more than one <i>character</i> in &lt;string&gt;.
1286+
Authors should not specify more than one [=character=] in &lt;string&gt;.
12871287
The UA may truncate or ignore strings consisting of more than one grapheme cluster.
12881288
</dl>
12891289

0 commit comments

Comments
 (0)