Skip to content

Commit de491b2

Browse files
committed
Clarify purpose of full-size-kana. Shift link to mappings into <dd>.
1 parent ef21145 commit de491b2

2 files changed

Lines changed: 25 additions & 16 deletions

File tree

css3-text/Overview.html

Lines changed: 12 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -572,9 +572,14 @@ <h3 id=text-transform><span class=secno>2.1. </span> <a name=caps-prop></a>
572572
title="text-transform:full-size-kana">&lsquo;<code
573573
class=css>full-size-kana</code>&rsquo;</dfn>
574574

575-
<dd>Converts all small Kana characters to normal Kana. This value is
576-
typically used for ruby annotation text, where all small Kana should be
577-
drawn as large Kana.
575+
<dd>Converts all small Kana characters to normal Kana. The mappings for
576+
small Kana to normal Kana are defined in <a href="#small-kana">Small Kana
577+
Mappings</a>.
578+
<p class=note> This value is typically used for ruby annotation text,
579+
where due to the small type size, small Kana is often drawn as large
580+
Kana. This value allows such underlying text to use correct orthography
581+
so that it is accessible and can be styled correctly when not presented
582+
as ruby.
578583
</dl>
579584

580585
<p>The case mapping rules for the character repertoire specified by the
@@ -631,9 +636,6 @@ <h3 id=text-transform><span class=secno>2.1. </span> <a name=caps-prop></a>
631636
decomposition (minus the &lt;wide&gt; tag) back to the original code
632637
point.
633638

634-
<p>The mappings for small Kana to normal Kana are defined in <a
635-
href="#small-kana">Small Kana Mappings</a>.
636-
637639
<p>Text transformation happens after <a href="#white-space-rules">white
638640
space processing</a>, which means that &lsquo;<code
639641
class=css>full-width</code>&rsquo; transforms only preserved U+0020 spaces
@@ -651,9 +653,10 @@ <h3 id=text-transform><span class=secno>2.1. </span> <a name=caps-prop></a>
651653
tables for less common text transforms, such as by an &lsquo;<a
652654
href="#text-transform0"><code class=css>@text-transform</code></a>&rsquo;
653655
rule similar to &lsquo;<code class=css>@counter-style</code>&rsquo; from
654-
<a href="#CSS3LIST" rel=biblioentry>[CSS3LIST]<!--{{CSS3LIST}}--></a>, and
655-
this mechanism may be used to replace &lsquo;<code
656-
class=css>full-size-kana</code>&rsquo;.
656+
<a href="#CSS3LIST" rel=biblioentry>[CSS3LIST]<!--{{CSS3LIST}}--></a>.
657+
This mechanism may be used to replace &lsquo;<code
658+
class=css>full-size-kana</code>&rsquo;. This would require authors needing
659+
this functionality to copy out the conversion tables, however.
657660

658661
<h2 id=white-space-processing><span class=secno>3. </span> White Space
659662
Processing</h2>

css3-text/Overview.src.html

Lines changed: 13 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -272,8 +272,15 @@ <h3 id="text-transform">
272272
like ideographic characters.
273273
<dt><dfn title="text-transform:full-size-kana">''full-size-kana''</dfn></dt>
274274
<dd>Converts all small Kana characters to normal Kana.
275-
This value is typically used for ruby annotation text,
276-
where all small Kana should be drawn as large Kana.
275+
The mappings for small Kana to normal Kana are defined in
276+
<a href="#small-kana">Small Kana Mappings</a>.</p>
277+
<p class=note>
278+
This value is typically used for ruby annotation text,
279+
where due to the small type size, small Kana
280+
is often drawn as large Kana.
281+
This value allows such underlying text to use correct orthography
282+
so that it is accessible and can be styled correctly
283+
when not presented as ruby.
277284
</dl>
278285

279286
<p>The case mapping rules for the character repertoire specified by the
@@ -327,9 +334,6 @@ <h3 id="text-transform">
327334
&lt;wide&gt; tag, the mapping is from the decomposition (minus the
328335
&lt;wide&gt; tag) back to the original code point.</p>
329336

330-
<p>The mappings for small Kana to normal Kana are defined in
331-
<a href="#small-kana">Small Kana Mappings</a>.</p>
332-
333337
<p>Text transformation happens after <a href="#white-space-rules">white
334338
space processing</a>, which means that ''full-width'' transforms
335339
only preserved U+0020 spaces to U+3000.
@@ -343,8 +347,10 @@ <h3 id="text-transform">
343347

344348
<p class="issue">CSS may introduce the ability to create custom mapping
345349
tables for less common text transforms, such as by an ''@text-transform''
346-
rule similar to ''@counter-style'' from [[CSS3LIST]], and this mechanism
347-
may be used to replace ''full-size-kana''.
350+
rule similar to ''@counter-style'' from [[CSS3LIST]].
351+
This mechanism may be used to replace ''full-size-kana''. This would
352+
require authors needing this functionality to copy out the conversion
353+
tables, however.
348354

349355
<h2 id="white-space-processing">
350356
White Space Processing</h2>

0 commit comments

Comments
 (0)