Skip to content

Commit 2e3fae3

Browse files
committed
[css-inline] Add dfn for inline letter
1 parent 0b9e19c commit 2e3fae3

2 files changed

Lines changed: 11 additions & 5 deletions

File tree

css-inline/Overview.bs

Lines changed: 4 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -52,7 +52,7 @@ A <dfn>dropped initial</dfn> (or “drop cap”) is a larger-than-usual letter a
5252
<p class="caption">Three-line drop initial with E acute. Since the cap-height of the drop initial aligns with the cap-height of the main text, the accent extends above the paragraph.</p>
5353
</figure>
5454

55-
The exact size and position of a drop cap depends on the alignment of its glyph. [TK] Reference points on the drop cap must align precisely with reference points in the text. In Western scripts, the top reference points are the cap height of the initial letter and of the first line of text. The bottom reference points are the alphabetic baseline of the initial letter and the baseline of the Nth line of text. <a href="#f2">Figure 2</a> shows a simple two-line drop cap, with the relevant reference lines marked.
55+
The exact size and position of a <a>dropped initial</a> depends on the alignment of its glyph. [TK] Reference points on the drop cap must align precisely with reference points in the text. In Western scripts, the top reference points are the cap height of the initial letter and of the first line of text. The bottom reference points are the alphabetic baseline of the initial letter and the baseline of the Nth line of text. <a href="#f2">Figure 2</a> shows a simple two-line drop cap, with the relevant reference lines marked.
5656

5757

5858

@@ -144,6 +144,9 @@ This property specifies styling for dropped, raised, and sunken initial letters.
144144
<dd>This optional second argument argument defines the number of lines the initial letter should sink. Values must be greater than zero. If omitted, it duplicates the first argument, floored to the nearest positive whole number.
145145
</dl>
146146

147+
An <dfn>initial letter</dfn> is a box to which 'initial-letter' applies
148+
and is not ''normal'': this triggers the special layout considerations described below.
149+
147150
<div class="example">
148151
Here are some examples of 'initial-letter' usage:
149152

css-inline/Overview.html

Lines changed: 7 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@
6262
</p>
6363
<h1 class="p-name no-ref" id=title>CSS Inline Layout Module Level 3</h1>
6464
<h2 class="no-num no-toc no-ref heading settled" id=subtitle><span class=content>Editor’s Draft,
65-
<span class=dt-updated><span class=value-title title=20141210>10 December 2014</span></span></span></h2>
65+
<span class=dt-updated><span class=value-title title=20141211>11 December 2014</span></span></span></h2>
6666
<div data-fill-with=spec-metadata><dl><dt>This version:<dd><a class=u-url href=http://dev.w3.org/csswg/css-inline/>http://dev.w3.org/csswg/css-inline/</a><dt>Latest version:<dd><a href=http://www.w3.org/TR/css-inline/>http://www.w3.org/TR/css-inline/</a><dt>Previous Versions:<dd><a href=http://www.w3.org/TR/2002/WD-css3-linebox-20020515/ rel=previous>http://www.w3.org/TR/2002/WD-css3-linebox-20020515/</a><dt>Feedback:<dd><span><a href="mailto:www-style@w3.org?subject=%5Bcss-inline%5D%20feedback">www-style@w3.org</a> with subject line “<kbd>[css-inline] <var>… message topic …</var></kbd>” (<a href=http://lists.w3.org/Archives/Public/www-style/ rel=discussion>archives</a>)</span><dt>Issue Tracking:<dd><a href=#issues-index>Inline In Spec</a><dt class=editor>Editors:<dd class=editor><div class="p-author h-card vcard"><a class="p-name fn u-email email" href=mailto:dauwhe@gmail.com>Dave Cramer</a> (<span class="p-org org">Hachette Livre</span>)</div><dd class=editor><div class="p-author h-card vcard"><a class="p-name fn u-url url" href=http://fantasai.inkedblade.net/contact>Elika J. Etemad</a> (<span class="p-org org">Invited Expert</span>)</div><dd class=editor><div class="p-author h-card vcard"><a class="p-name fn u-email email" href=mailto:szilles@adobe.com>Steve Zilles</a> (<span class="p-org org">Adobe</span>)</div><dt>Issues list:<dd><span><a href="https://www.w3.org/Bugs/Public/buglist.cgi?query_format=advanced&amp;product=CSS&amp;component=Linebox&amp;bug_status=NEW&amp;bug_status=ASSIGNED&amp;bug_status=REOPENED">CSS3 Line Layout issues in Bugzilla</a></span></dl></div>
6767
<div data-fill-with=warning></div>
6868
<p class=copyright data-fill-with=copyright><a href=http://www.w3.org/Consortium/Legal/ipr-notice#Copyright>Copyright</a> © 2014 <a href=http://www.w3.org/><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup> (<a href=http://www.csail.mit.edu/><abbr title="Massachusetts Institute of Technology">MIT</abbr></a>, <a href=http://www.ercim.eu/><abbr title="European Research Consortium for Informatics and Mathematics">ERCIM</abbr></a>, <a href=http://www.keio.ac.jp/>Keio</a>, <a href=http://ev.buaa.edu.cn/>Beihang</a>), All Rights Reserved. W3C <a href=http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer>liability</a>, <a href=http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks>trademark</a> and <a href=http://www.w3.org/Consortium/Legal/copyright-documents>document use</a> rules apply.
@@ -160,7 +160,7 @@ <h4 class="heading settled" data-level=2.1.1 id=drop-initial><span class=secno>2
160160
<p class=caption>Three-line drop initial with E acute. Since the cap-height of the drop initial aligns with the cap-height of the main text, the accent extends above the paragraph.</p>
161161
</figure>
162162

163-
<p>The exact size and position of a drop cap depends on the alignment of its glyph. [TK] Reference points on the drop cap must align precisely with reference points in the text. In Western scripts, the top reference points are the cap height of the initial letter and of the first line of text. The bottom reference points are the alphabetic baseline of the initial letter and the baseline of the Nth line of text. <a href=#f2>Figure 2</a> shows a simple two-line drop cap, with the relevant reference lines marked.</p>
163+
<p>The exact size and position of a <a data-link-type=dfn href=#dropped-initial>dropped initial</a> depends on the alignment of its glyph. [TK] Reference points on the drop cap must align precisely with reference points in the text. In Western scripts, the top reference points are the cap height of the initial letter and of the first line of text. The bottom reference points are the alphabetic baseline of the initial letter and the baseline of the Nth line of text. <a href=#f2>Figure 2</a> shows a simple two-line drop cap, with the relevant reference lines marked.</p>
164164

165165

166166

@@ -241,6 +241,9 @@ <h3 class="heading settled" data-level=2.3 id=sizing-drop-initials><span class=s
241241
<dd>This optional second argument argument defines the number of lines the initial letter should sink. Values must be greater than zero. If omitted, it duplicates the first argument, floored to the nearest positive whole number.
242242
</dl>
243243

244+
<p>An <dfn data-dfn-type=dfn data-noexport="" id=initial-letter>initial letter<a class=self-link href=#initial-letter></a></dfn> is a box to which <a class=property data-link-type=propdesc href=#propdef-initial-letter>initial-letter</a> applies
245+
and is not <span class=css>normal</span>: this triggers the special layout considerations described below.</p>
246+
244247
<div class=example>
245248
Here are some examples of <a class=property data-link-type=propdesc href=#propdef-initial-letter>initial-letter</a> usage:
246249

@@ -277,7 +280,7 @@ <h3 class="heading settled" data-level=2.4 id=aligning-initial-letter><span clas
277280

278281
<dl data-dfn-for=initial-letter-align data-dfn-type=value>
279282
<dt>auto</dt>
280-
<dd>The user agent selects the value which corresponds to the language of the text. Western languages would default to <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-counter-styles-3/#valdef-counter-style-system-alphabetic>alphabetic</a>, CJK languages to <span class=css>ideographic</span>, and some Indic languages to <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-text-3/#valdef-text-indent-hanging>hanging</a>. </dd>
283+
<dd>The user agent selects the value which corresponds to the language of the text. Western languages would default to <span class=css>alphabetic</span>, CJK languages to <span class=css>ideographic</span>, and some Indic languages to <span class=css>hanging</span>. </dd>
281284
<dt>alphabetic</dt>
282285
<dd>As described above, the cap height of the initial letter aligns with the cap height of the first line of text. The baseline of the initial letter aligns with the baseline of the Nth text baseline.</dd>
283286

@@ -530,4 +533,4 @@ <h3 class="no-ref heading settled" id=testing><span class=content>
530533

531534

532535

533-
<h2 class="no-num heading settled" id=references><span class=content>References</span><a class=self-link href=#references></a></h2><h3 class="no-num heading settled" id=normative><span class=content>Normative References</span><a class=self-link href=#normative></a></h3><dl><dt id=biblio-rfc2119 title=rfc2119><a class=self-link href=#biblio-rfc2119></a>[rfc2119]<dd>S. Bradner. <a href=https://tools.ietf.org/html/rfc2119>Key words for use in RFCs to Indicate Requirement Levels</a>. March 1997. Best Current Practice. URL: <a href=https://tools.ietf.org/html/rfc2119>https://tools.ietf.org/html/rfc2119</a></dl><h3 class="no-num heading settled" id=informative><span class=content>Informative References</span><a class=self-link href=#informative></a></h3><dl><dt id=biblio-css2 title=CSS2><a class=self-link href=#biblio-css2></a>[CSS2]<dd>Bert Bos; et al. <a href=http://www.w3.org/TR/CSS2>Cascading Style Sheets Level 2 Revision 1 (CSS 2.1) Specification</a>. 7 June 2011. REC. URL: <a href=http://www.w3.org/TR/CSS2>http://www.w3.org/TR/CSS2</a><dt id=biblio-css21 title=CSS21><a class=self-link href=#biblio-css21></a>[CSS21]<dd>Bert Bos; et al. <a href=http://www.w3.org/TR/2011/REC-CSS2-20110607>Cascading Style Sheets Level 2 Revision 1 (CSS 2.1) Specification</a>. 7 June 2011. W3C Recommendation. URL: <a href=http://www.w3.org/TR/2011/REC-CSS2-20110607>http://www.w3.org/TR/2011/REC-CSS2-20110607</a><dt id=biblio-css3-line-grid title=CSS3-LINE-GRID><a class=self-link href=#biblio-css3-line-grid></a>[CSS3-LINE-GRID]<dd>Koji Ishii. <a href=http://dev.w3.org/csswg/css-line-grid/>CSS Line Grid Module</a>. Proposal for a CSS module. (Retrieved 26 October 2011) URL: <a href=http://dev.w3.org/csswg/css-line-grid/>http://dev.w3.org/csswg/css-line-grid/</a><dt id=biblio-css3text title=CSS3TEXT><a class=self-link href=#biblio-css3text></a>[CSS3TEXT]<dd>Elika J. Etemad; Koji Ishii. <a href=http://www.w3.org/TR/2012/WD-css3-text-20121113/>CSS Text Module Level 3</a>. 13 November 2012. W3C Working Draft. (Work in progress.) URL: <a href=http://www.w3.org/TR/2012/WD-css3-text-20121113/>http://www.w3.org/TR/2012/WD-css3-text-20121113/</a><dt id=biblio-select title=SELECT><a class=self-link href=#biblio-select></a>[SELECT]<dd>Tantek Çelik; et al. <a href=http://www.w3.org/TR/2011/REC-css3-selectors-20110929/>Selectors Level 3</a>. 29 September 2011. W3C Recommendation. URL: <a href=http://www.w3.org/TR/2011/REC-css3-selectors-20110929/>http://www.w3.org/TR/2011/REC-css3-selectors-20110929/</a></dl><h2 class="no-num heading settled" id=index><span class=content>Index</span><a class=self-link href=#index></a></h2><ul class=indexlist><li>dropped initial, <a href=#dropped-initial title="section 2.1.1">2.1.1</a><li>initial-letter, <a href=#propdef-initial-letter title="section 2.3">2.3</a><li>initial-letter-align, <a href=#propdef-initial-letter-align title="section 2.4">2.4</a><li>&lt;integer&gt;, <a href=#typedef-integer title="section 2.3">2.3</a><li>normal, <a href=#normal title="section 2.3">2.3</a><li>&lt;number&gt;, <a href=#typedef-number title="section 2.3">2.3</a><li>raised initial, <a href=#raised-initial title="section 2.1.3">2.1.3</a><li>sunken initial, <a href=#sunken-initial title="section 2.1.2">2.1.2</a></ul><h2 class="no-num heading settled" id=property-index><span class=content>Property Index</span><a class=self-link href=#property-index></a></h2><table class="proptable data"><thead><tr><th scope=col>Name<th scope=col>Value<th scope=col>Initial<th scope=col>Applies to<th scope=col>Inh.<th scope=col>%ages<th scope=col>Media<th scope=col>Animatable<th scope=col>Computed value<tbody><tr><th scope=row><a class=css data-link-type=property href=#propdef-initial-letter>initial-letter</a><td>normal | [&lt;integer&gt; &lt;number&gt;?]<td>normal<td>::first-letter pseudo-elements and inline-level first child of a block container<td>no<td>N/A<td>visual<td>no<td>as specified<tr><th scope=row><a class=css data-link-type=property href=#propdef-initial-letter-align>initial-letter-align</a><td>[ auto | alphabetic | hanging | ideographic ]<td>auto<td>::first-letter pseudo elements and inline level first child of a block container<td>no<td>N/A<td>visual<td>no<td>???</table><h2 class="no-num heading settled" id=issues-index><span class=content>Issues Index</span><a class=self-link href=#issues-index></a></h2><div style=counter-reset:issue><div class=issue>This section is being rewritten. Refer to <a href=http://www.w3.org/TR/CSS21/visudet.html#line-height>section 10.8</a> of <a data-biblio-type=informative data-link-type=biblio href=#biblio-css21 title=CSS21>[CSS21]</a> for the normative CSS definition or the <a href=http://www.w3.org/TR/2002/WD-css3-linebox-20020515/>2002 Working Draft</a> if you want pretty pictures. (But ignore the old text, half of it’s wrong. We’re not specifying which half, that’s to be determined.)<a href=#issue-469c7c8c></a></div><div class=issue>The editors would appreciate any examples of drop initials in non-western scripts, especially Arabic and Indic scripts.<a href=#issue-f90429eb></a></div><div class=issue>Add pictures.<a href=#issue-2e07b898></a></div><div class=issue>Input from those knowledgeable about non-Western typographic traditions would be very helpful in describing the appropriate alignments. More values may be required for this property.<a href=#issue-209367a3></a></div><div class=issue>Need to decide whether using margin edges or content edges for alignment. Writing Modes uses the margin edges for baseline alignment of replaced elements. There are cases for both content-alignment and margin-alignment for text. In both cases the margin box needs to be excluded.<a href=#issue-6403f978></a></div><div class=issue>Handle glyph ink above cap height of font.<a href=#issue-f77cbeb9></a></div><div class=issue>Is this the behavior we want? What if the float is on the same line as the initial letter?<a href=#issue-2ad0a0cb></a></div></div>
536+
<h2 class="no-num heading settled" id=references><span class=content>References</span><a class=self-link href=#references></a></h2><h3 class="no-num heading settled" id=normative><span class=content>Normative References</span><a class=self-link href=#normative></a></h3><dl><dt id=biblio-rfc2119 title=rfc2119><a class=self-link href=#biblio-rfc2119></a>[rfc2119]<dd>S. Bradner. <a href=http://www.ietf.org/rfc/rfc2119.txt>Key words for use in RFCs to Indicate Requirement Levels</a>. March 1997. Best Current Practice. URL: <a href=http://www.ietf.org/rfc/rfc2119.txt>http://www.ietf.org/rfc/rfc2119.txt</a></dl><h3 class="no-num heading settled" id=informative><span class=content>Informative References</span><a class=self-link href=#informative></a></h3><dl><dt id=biblio-css2 title=CSS2><a class=self-link href=#biblio-css2></a>[CSS2]<dd>Bert Bos; et al. <a href=http://www.w3.org/TR/CSS2>Cascading Style Sheets Level 2 Revision 1 (CSS 2.1) Specification</a>. 7 June 2011. REC. URL: <a href=http://www.w3.org/TR/CSS2>http://www.w3.org/TR/CSS2</a><dt id=biblio-css21 title=CSS21><a class=self-link href=#biblio-css21></a>[CSS21]<dd>Bert Bos; et al. <a href=http://www.w3.org/TR/2011/REC-CSS2-20110607>Cascading Style Sheets Level 2 Revision 1 (CSS 2.1) Specification</a>. 7 June 2011. W3C Recommendation. URL: <a href=http://www.w3.org/TR/2011/REC-CSS2-20110607>http://www.w3.org/TR/2011/REC-CSS2-20110607</a><dt id=biblio-css3-line-grid title=CSS3-LINE-GRID><a class=self-link href=#biblio-css3-line-grid></a>[CSS3-LINE-GRID]<dd>Koji Ishii. <a href=http://dev.w3.org/csswg/css-line-grid/>CSS Line Grid Module</a>. Proposal for a CSS module. (Retrieved 26 October 2011) URL: <a href=http://dev.w3.org/csswg/css-line-grid/>http://dev.w3.org/csswg/css-line-grid/</a><dt id=biblio-css3text title=CSS3TEXT><a class=self-link href=#biblio-css3text></a>[CSS3TEXT]<dd>Elika J. Etemad; Koji Ishii. <a href=http://www.w3.org/TR/2012/WD-css3-text-20121113/>CSS Text Module Level 3</a>. 13 November 2012. W3C Working Draft. (Work in progress.) URL: <a href=http://www.w3.org/TR/2012/WD-css3-text-20121113/>http://www.w3.org/TR/2012/WD-css3-text-20121113/</a><dt id=biblio-select title=SELECT><a class=self-link href=#biblio-select></a>[SELECT]<dd>Tantek Çelik; et al. <a href=http://www.w3.org/TR/2011/REC-css3-selectors-20110929/>Selectors Level 3</a>. 29 September 2011. W3C Recommendation. URL: <a href=http://www.w3.org/TR/2011/REC-css3-selectors-20110929/>http://www.w3.org/TR/2011/REC-css3-selectors-20110929/</a></dl><h2 class="no-num heading settled" id=index><span class=content>Index</span><a class=self-link href=#index></a></h2><ul class=indexlist><li>dropped initial, <a href=#dropped-initial title="section 2.1.1">2.1.1</a><li>initial-letter, <a href=#propdef-initial-letter title="section 2.3">2.3</a><li>initial letter, <a href=#initial-letter title="section 2.3">2.3</a><li>initial-letter-align, <a href=#propdef-initial-letter-align title="section 2.4">2.4</a><li>&lt;integer&gt;, <a href=#typedef-integer title="section 2.3">2.3</a><li>normal, <a href=#normal title="section 2.3">2.3</a><li>&lt;number&gt;, <a href=#typedef-number title="section 2.3">2.3</a><li>raised initial, <a href=#raised-initial title="section 2.1.3">2.1.3</a><li>sunken initial, <a href=#sunken-initial title="section 2.1.2">2.1.2</a></ul><h2 class="no-num heading settled" id=property-index><span class=content>Property Index</span><a class=self-link href=#property-index></a></h2><table class="proptable data"><thead><tr><th scope=col>Name<th scope=col>Value<th scope=col>Initial<th scope=col>Applies to<th scope=col>Inh.<th scope=col>%ages<th scope=col>Media<th scope=col>Animatable<th scope=col>Computed value<tbody><tr><th scope=row><a class=css data-link-type=property href=#propdef-initial-letter>initial-letter</a><td>normal | [&lt;integer&gt; &lt;number&gt;?]<td>normal<td>::first-letter pseudo-elements and inline-level first child of a block container<td>no<td>N/A<td>visual<td>no<td>as specified<tr><th scope=row><a class=css data-link-type=property href=#propdef-initial-letter-align>initial-letter-align</a><td>[ auto | alphabetic | hanging | ideographic ]<td>auto<td>::first-letter pseudo elements and inline level first child of a block container<td>no<td>N/A<td>visual<td>no<td>???</table><h2 class="no-num heading settled" id=issues-index><span class=content>Issues Index</span><a class=self-link href=#issues-index></a></h2><div style=counter-reset:issue><div class=issue>This section is being rewritten. Refer to <a href=http://www.w3.org/TR/CSS21/visudet.html#line-height>section 10.8</a> of <a data-biblio-type=informative data-link-type=biblio href=#biblio-css21 title=CSS21>[CSS21]</a> for the normative CSS definition or the <a href=http://www.w3.org/TR/2002/WD-css3-linebox-20020515/>2002 Working Draft</a> if you want pretty pictures. (But ignore the old text, half of it’s wrong. We’re not specifying which half, that’s to be determined.)<a href=#issue-469c7c8c></a></div><div class=issue>The editors would appreciate any examples of drop initials in non-western scripts, especially Arabic and Indic scripts.<a href=#issue-f90429eb></a></div><div class=issue>Add pictures.<a href=#issue-2e07b898></a></div><div class=issue>Input from those knowledgeable about non-Western typographic traditions would be very helpful in describing the appropriate alignments. More values may be required for this property.<a href=#issue-209367a3></a></div><div class=issue>Need to decide whether using margin edges or content edges for alignment. Writing Modes uses the margin edges for baseline alignment of replaced elements. There are cases for both content-alignment and margin-alignment for text. In both cases the margin box needs to be excluded.<a href=#issue-6403f978></a></div><div class=issue>Handle glyph ink above cap height of font.<a href=#issue-f77cbeb9></a></div><div class=issue>Is this the behavior we want? What if the float is on the same line as the initial letter?<a href=#issue-2ad0a0cb></a></div></div>

0 commit comments

Comments
 (0)