8000 [css-writing-modes] Reorder some paragraphs and add headings. (No cha… · meyerweb/csswg-drafts@6404691 · GitHub
Skip to content

Commit 6404691

Browse files
fantasaifantasai
committed
[css-writing-modes] Reorder some paragraphs and add headings. (No changes to prose, just moving things around.)
1 parent d904614 commit 6404691

2 files changed

Lines changed: 103 additions & 85 deletions

File tree

‎css-writing-modes/Overview.html‎

Lines changed: 51 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -124,8 +124,10 @@ <h2 class="no-num no-toc no-ref heading settled heading" id=contents><span class
124124
Table Caption Mappings: the <span class=property data-link-type=propdesc title=caption-side>caption-side</span> keywords</a></ul><li><a href=#page-direction><span class=secno>8</span>
125125
Page Flow: the page progression direction</a><li><a href=#text-combine><span class=secno>9</span>
126126
Glyph Composition</a><ul class=toc><li><a href=#text-combine-horizontal><span class=secno>9.1</span>
127-
Horizontal-in-Vertical Composition: the <span class=property data-link-type=propdesc title=text-combine-horizontal>text-combine-horizontal</span> property</a><ul class=toc><li><a href=#text-combine-compression><span class=secno>9.1.1</span>
128-
Compression Rules</a></ul></ul><li><a href=#changes><span class=secno></span>Changes</a><ul class=toc><li><a href=#changes-201211><span class=secno></span>
127+
Horizontal-in-Vertical Composition: the <span class=property data-link-type=propdesc title=text-combine-horizontal>text-combine-horizontal</span> property</a><ul class=toc><li><a href=#text-combine-layout><span class=secno>9.1.1</span>
128+
Layout Rules</a><li><a href=#text-combine-compression><span class=secno>9.1.2</span>
129+
Compression Rules</a><ul class=toc><li><a href=#text-combine-fullwidth><span class=secno>9.1.2.1</span>
130+
Full-width Characters</a></ul></ul></ul><li><a href=#changes><span class=secno></span>Changes</a><ul class=toc><li><a href=#changes-201211><span class=secno></span>
129131
Changes since the <span>November
130132
2012 CSS Writing Modes Module Level 3 <spanbbr title="Working Draft">WD</spanbbr></span></a><li><a href=#changes-201205><span class=secno></span>
131133
Changes since the <span>May
@@ -2318,46 +2320,9 @@ <h4 id="text-combine-runs">
23182320
<pre>&lt;tcy>12&lt;span>34&lt;/span>&lt;/tcy></pre> <p>Similarly,
23192321
</div>
23202322
-->
2321-
<h4 class="heading settled heading" data-level=9.1.1 id=text-combine-compression><span class=secno>9.1.1 </span><span class=content>
2322-
Compression Rules</span><a class=self-link href=#text-combine-compression></a></h4>
23232323

2324-
<p>In order to preserve typographic color when compressing the text to 1em,
2325-
when the combined text consists of more than one <a href=#character>character</a>,
2326-
then any full-width <a href=#character>characters</a> must first be converted to their non-full-width equivalents
2327-
by reversing the algorithm defined for <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-text-3/#text-transform0 title=text-transform>text-transform: full-width</a> in <a data-biblio-type=normative data-link-type=biblio href=#css3text title=CSS3TEXT>[CSS3TEXT]</a>.
2328-
2329-
<div class=example>
2330-
<p>For example, an author might apply both <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css-text-3/#text-transform0 title=text-transform>text-transform</a> and <a class=property data-link-type=propdesc href=#propdef-text-combine-horizontal title=text-combine-horizontal>text-combine-horizontal</a>
2331-
to a date set in vertical text.
2332-
<pre>date { text-combine-horizontal: digits 2; text-transform: full-width; }</pre> <p>Suppose this style rule is applied to a date such as.
2333-
<pre>&lt;date&gt;2010年2月23日&lt;/date&gt;</pre> <p>The "2010" is too long to be combined (4 digits), but the "2" and "23" will be affected.
2334-
Since "23" is more than one character, it will not be affected by <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-text-3/#text-transform0 title=text-transform>text-transform: full-width</a>.
2335-
However since the "2" is only one character, it will be transformed to a fullwidth "２".
2336-
Since the "2010" was not combined, its digits, too, will be transformed to fullwidth "２０１０";
2337-
and being fullwidth, they will be typeset upright, giving the following result:
2338-
<pre style="text-align: center"><!-- -->２
2339-
<!-- -->０
2340-
<!-- -->１
2341-
<!-- -->０
2342-
<!-- -->年
2343-
<!-- -->２
2344-
<!-- -->月
2345-
<!-- -->23
2346-
<!-- -->日</pre> </div>
2347-
<!--
2348-
Also, a <a property>font-variant</a> value of <span data-link-type="maybe" class="css">full-width</span> must be ignored in such cases:
2349-
whether applied via <span data-link-type="maybe" class="css">@font-face</span> descriptor or property declaration,
2350-
within the combined text this value does not not cause the UA to enable that font feature. [[!CSS3-FONTS]]
2351-
-->
2352-
2353-
<p class=note>
2354-
Full-width glyph variations can also be chosen via the <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css-fonts-3/#descdef-font-variant title=font-variant>font-variant</a> property
2355-
or <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-fonts-3/#at-font-face-rule>@font-face</a> descriptor <a data-biblio-type=normative data-link-type=biblio href=#css3-fonts title=CSS3-FONTS>[CSS3-FONTS]</a>.
2356-
However since such variations do not affect the glyph shape in contemporary fonts,
2357-
there is no explicit interaction with this feature currently.
2358-
A future revision of this specification may require ignoring such declarations
2359-
within the combined text
2360-
if common usage makes such behavior desirable.
2324+
<h4 class="heading settled heading" data-level=9.1.1 id=text-combine-layout><span class=secno>9.1.1 </span><span class=content>
2325+
Layout Rules</span><a class=self-link href=#text-combine-layout></a></h4>
23612326

23622327
<p>When combining text as for <a class=css data-link-type=maybe href=#propdef-text-combine-horizontal title=text-combine-horizontal>text-combine-horizontal: all</a>,
23632328
the glyphs of the combined text are composed horizontally
@@ -2375,6 +2340,9 @@ <h4 class="heading settled heading" data-level=9.1.1 id=text-combine-compression
23752340
etc. the resulting composition is treated as a single glyph
23762341
representing the Object Replacement Character U+FFFC.
23772342

2343+
<h4 class="heading settled heading" data-level=9.1.2 id=text-combine-compression><span class=secno>9.1.2 </span><span class=content>
2344+
Compression Rules</span><a class=self-link href=#text-combine-compression></a></h4>
2345+
23782346
<p>The UA must ensure that the combined advance width of the composition
23792347
fits within 1em by compressing the combined text if necessary.
23802348
(This does not necessarily mean that the glyphs will fit within 1em,
@@ -2413,6 +2381,48 @@ <h4 class="heading settled heading" data-level=9.1.1 id=text-combine-compression
24132381
font; and its shape is very full in both dimensions, so it would be
24142382
unlikely to be shortened in a proportional font -->
24152383

2384+
<h5 class="heading settled heading" data-level=9.1.2.1 id=text-combine-fullwidth><span class=secno>9.1.2.1 </span><span class=content>
2385+
Full-width Characters</span><a class=self-link href=#text-combine-fullwidth></a></h5>
2386+
2387+
<p>In order to preserve typographic color when compressing the text to 1em,
2388+
when the combined text consists of more than one <a href=#character>character</a>,
2389+
then any full-width <a href=#character>characters</a> must first be converted to their non-full-width equivalents
2390+
by reversing the algorithm defined for <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-text-3/#text-transform0 title=text-transform>text-transform: full-width</a> in <a data-biblio-type=normative data-link-type=biblio href=#css3text title=CSS3TEXT>[CSS3TEXT]</a>
2391+
before applying other compression techniques.
2392+
2393+
<div class=example>
2394+
<p>For example, an author might apply both <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css-text-3/#text-transform0 title=text-transform>text-transform</a> and <a class=property data-link-type=propdesc href=#propdef-text-combine-horizontal title=text-combine-horizontal>text-combine-horizontal</a>
2395+
to a date set in vertical text.
2396+
<pre>date { text-combine-horizontal: digits 2; text-transform: full-width; }</pre> <p>Suppose this style rule is applied to a date such as.
2397+
<pre>&lt;date&gt;2010年2月23日&lt;/date&gt;</pre> <p>The "2010" is too long to be combined (4 digits), but the "2" and "23" will be affected.
2398+
Since "23" is more than one character, it will not be affected by <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-text-3/#text-transform0 title=text-transform>text-transform: full-width</a>.
2399+
However since the "2" is only one character, it will be transformed to a fullwidth "２".
2400+
Since the "2010" was not combined, its digits, too, will be transformed to fullwidth "２０１０";
2401+
and being fullwidth, they will be typeset upright, giving the following result:
2402+
<pre style="text-align: center"><!-- -->２
2403+
<!-- -->０
2404+
<!-- -->１
2405+
<!-- -->０
2406+
<!-- -->年
2407+
<!-- -->２
2408+
<!-- -->月
2409+
<!-- -->23
2410+
<!-- -->日</pre> </div>
2411+
<!--
2412+
Also, a <a property>font-variant</a> value of <span data-link-type="maybe" class="css">full-width</span> must be ignored in such cases:
2413+
whether applied via <span data-link-type="maybe" class="css">@font-face</span> descriptor or property declaration,
2414+
within the combined text this value does not not cause the UA to enable that font feature. [[!CSS3-FONTS]]
2415+
-->
2416+
2417+
<p class=note>
2418+
Full-width glyph variations can also be chosen via the <a class=property data-link-type=propdesc href=http://dev.w3.org/csswg/css-fonts-3/#descdef-font-variant title=font-variant>font-variant</a> property
2419+
or <a class=css data-link-type=maybe href=http://dev.w3.org/csswg/css-fonts-3/#at-font-face-rule>@font-face</a> descriptor <a data-biblio-type=normative data-link-type=biblio href=#css3-fonts title=CSS3-FONTS>[CSS3-FONTS]</a>.
2420+
However since such variations do not affect the glyph shape in contemporary fonts,
2421+
there is no explicit interaction with this feature currently.
2422+
A future revision of this specification may require ignoring such declarations
2423+
within the combined text
2424+
if common usage makes such behavior desirable.
2425+
24162426
<!--
24172427
<h3 id="text-combine-mode">
24182428
Horizontal-in-Vertical Glyph Scaling: the 'text-combine-mode' property</h3>

‎css-writing-modes/Overview.src.html‎

Lines changed: 52 additions & 44 deletions
Original file line numberDiff line numberDiff line change
@@ -2217,7 +2217,7 @@ <h3 id="text-combine-horizontal">
22172217
Canonical order: n/a
22182218
</pre>
22192219

2220-
<p class="issue">The WG would appreciate a better (more obvious / more concise) name for this, if anyone can come up with one.
2220+
<p class="issue">The WG would appreciate a better (more obvious / easier to type) name for this, if anyone can come up with one.
22212221

22222222
<p>This property specifies the combination of multiple characters into the space of a single character.
22232223
If the combined text is wider than 1em, the UA must fit the contents within 1em, see below.
@@ -2337,50 +2337,9 @@ <h4 id="text-combine-runs">
23372337
<p>Similarly,
23382338
</div>
23392339
-->
2340-
<h4 id="text-combine-compression">
2341-
Compression Rules</h4>
2342-
2343-
<p>In order to preserve typographic color when compressing the text to 1em,
2344-
when the combined text consists of more than one <i>character</i>,
2345-
then any full-width <i>characters</i> must first be converted to their non-full-width equivalents
2346-
by reversing the algorithm defined for ''text-transform: full-width'' in [[!CSS3TEXT]].
2347-
2348-
<div class="example">
2349-
<p>For example, an author might apply both 'text-transform' and 'text-combine-horizontal'
2350-
to a date set in vertical text.
2351-
<pre>date { text-combine-horizontal: digits 2; text-transform: full-width; }</pre>
2352-
<p>Suppose this style rule is applied to a date such as.
2353-
<pre>&lt;date>2010年2月23日&lt;/date></pre>
2354-
<p>The "2010" is too long to be combined (4 digits), but the "2" and "23" will be affected.
2355-
Since "23" is more than one character, it will not be affected by ''text-transform: full-width''.
2356-
However since the "2" is only one character, it will be transformed to a fullwidth "２".
2357-
Since the "2010" was not combined, its digits, too, will be transformed to fullwidth "２０１０";
2358-
and being fullwidth, they will be typeset upright, giving the following result:
2359-
<pre style="text-align: center">
2360-
<!-- -->２
2361-
<!-- -->０
2362-
<!-- -->１
2363-
<!-- -->０
2364-
<!-- -->年
2365-
<!-- -->２
2366-
<!-- -->月
2367-
<!-- -->23
2368-
<!-- -->日</pre>
2369-
</div>
2370-
<!--
2371-
Also, a <a property>font-variant</a> value of ''full-width'' must be ignored in such cases:
2372-
whether applied via ''@font-face'' descriptor or property declaration,
2373-
within the combined text this value does not not cause the UA to enable that font feature. [[!CSS3-FONTS]]
2374-
-->
23752340

2376-
<p class="note">
2377-
Full-width glyph variations can also be chosen via the 'font-variant' property
2378-
or ''@font-face'' descriptor [[!CSS3-FONTS]].
2379-
However since such variations do not affect the glyph shape in contemporary fonts,
2380-
there is no explicit interaction with this feature currently.
2381-
A future revision of this specification may require ignoring such declarations
2382-
within the combined text
2383-
if common usage makes such behavior desirable.
2341+
<h4 id="text-combine-layout">
2342+
Layout Rules</h4>
23842343

23852344
<p>When combining text as for ''text-combine-horizontal: all'',
23862345
the glyphs of the combined text are composed horizontally
@@ -2398,6 +2357,9 @@ <h4 id="text-combine-compression">
23982357
etc. the resulting composition is treated as a single glyph
23992358
representing the Object Replacement Character U+FFFC.
24002359

2360+
<h4 id="text-combine-compression">
2361+
Compression Rules</h4>
2362+
24012363
<p>The UA must ensure that the combined advance width of the composition
24022364
fits within 1em by compressing the combined text if necessary.
24032365
(This does not necessarily mean that the glyphs will fit within 1em,
@@ -2436,6 +2398,52 @@ <h4 id="text-combine-compression">
24362398
font; and its shape is very full in both dimensions, so it would be
24372399
unlikely to be shortened in a proportional font -->
24382400

2401+
<h5 id="text-combine-fullwidth">
2402+
Full-width Characters</h5>
2403+
2404+
<p>In order to preserve typographic color when compressing the text to 1em,
2405+
when the combined text consists of more than one <i>character</i>,
2406+
then any full-width <i>characters</i> must first be converted to their non-full-width equivalents
2407+
by reversing the algorithm defined for ''text-transform: full-width'' in [[!CSS3TEXT]]
2408+
before applying other compression techniques.
2409+
2410+
<div class="example">
2411+
<p>For example, an author might apply both 'text-transform' and 'text-combine-horizontal'
2412+
to a date set in vertical text.
2413+
<pre>date { text-combine-horizontal: digits 2; text-transform: full-width; }</pre>
2414+
<p>Suppose this style rule is applied to a date such as.
2415+
<pre>&lt;date>2010年2月23日&lt;/date></pre>
2416+
<p>The "2010" is too long to be combined (4 digits), but the "2" and "23" will be affected.
2417+
Since "23" is more than one character, it will not be affected by ''text-transform: full-width''.
2418+
However since the "2" is only one character, it will be transformed to a fullwidth "２".
2419+
Since the "2010" was not combined, its digits, too, will be transformed to fullwidth "２０１０";
2420+
and being fullwidth, they will be typeset upright, giving the following result:
2421+
<pre style="text-align: center">
2422+
<!-- -->２
2423+
<!-- -->０
2424+
<!-- -->１
2425+
<!-- -->０
2426+
<!-- -->年
2427+
<!-- -->２
2428+
<!-- -->月
2429+
<!-- -->23
2430+
<!-- -->日</pre>
2431+
</div>
2432+
<!--
2433+
Also, a <a property>font-variant</a> value of ''full-width'' must be ignored in such cases:
2434+
whether applied via ''@font-face'' descriptor or property declaration,
2435+
within the combined text this value does not not cause the UA to enable that font feature. [[!CSS3-FONTS]]
2436+
-->
2437+
2438+
<p class="note">
2439+
Full-width glyph variations can also be chosen via the 'font-variant' property
2440+
or ''@font-face'' descriptor [[!CSS3-FONTS]].
2441+
However since such variations do not affect the glyph shape in contemporary fonts,
2442+
there is no explicit interaction with this feature currently.
2443+
A future revision of this specification may require ignoring such declarations
2444+
within the combined text
2445+
if common usage makes such behavior desirable.
2446+
24392447
<!--
24402448
<h3 id="text-combine-mode">
24412449
Horizontal-in-Vertical Glyph Scaling: the 'text-combine-mode' property</h3>

0 commit comments

Comments
 (0)