- From: Elika Etemad via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 28 Jan 2011 00:47:29 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-text
In directory hutz:/tmp/cvs-serv9636
Modified Files:
Overview.html Overview.src.html
Log Message:
Add 'hyphens' property from GCPM
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-text/Overview.html,v
retrieving revision 1.37
retrieving revision 1.38
diff -u -d -r1.37 -r1.38
--- Overview.html 26 Jan 2011 06:11:27 -0000 1.37
+++ Overview.html 28 Jan 2011 00:47:18 -0000 1.38
@@ -83,14 +83,14 @@
<h1>CSS Text Level 3</h1>
- <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 26 January
+ <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 28 January
2011</h2>
<dl>
<dt>This version:
<dd><a href="http://dev.w3.org/csswg/css3-text/Overview.html">$Date:
- 2011/01/26 06:00:06 $ (CVS $Revision$)</a> <!--<dd><a
+ 2011/01/26 06:11:27 $ (CVS $Revision$)</a> <!--<dd><a
href="http://www.w3.org/TR/2010/WD-css3-text-20101005/">http://www.w3.org/TR/2010/WD-css3-text-20101005/</a></dd> -->
@@ -274,21 +274,25 @@
<li><a href="#hyphenation"><span class=secno>6. </span>Hyphenation</a>
<ul class=toc>
- <li><a href="#hyphenate-character"><span class=secno>6.1. </span>
+ <li><a href="#hyphens"><span class=secno>6.1. </span>Hyphenation
+ Control: the ‘<code class=property>hyphens</code>’
+ property</a>
+
+ <li><a href="#hyphenate-character"><span class=secno>6.2. </span>
Hyphens: the ‘<code
class=property>hyphenate-character</code>’ property</a>
- <li><a href="#hyphenate-char-limits"><span class=secno>6.2. </span>
+ <li><a href="#hyphenate-char-limits"><span class=secno>6.3. </span>
Hyphenation Character Limits: the ‘<code
class=property>hyphenate-limit-before</code>’ and ‘<code
class=property>hyphenate-limit-after</code>’ properties</a>
- <li><a href="#hyphenate-line-limits"><span class=secno>6.3. </span>
+ <li><a href="#hyphenate-line-limits"><span class=secno>6.4. </span>
Hyphenation Line Limits: the ‘<code
class=property>hyphenate-limit-lines</code>’ and ‘<code
class=property>hyphenate-limit-last</code>’ properties</a>
- <li><a href="#hyphenation-resource"><span class=secno>6.4. </span>
+ <li><a href="#hyphenation-resource"><span class=secno>6.5. </span>
Hyphenation Resources: the ‘<code
class=css>@hyphenate-resource</code>’ rule</a>
</ul>
@@ -1277,8 +1281,6 @@
‘<a href="#word-break0"><code
class=property>word-break</code></a>’ property</h3>
- <p>This property specifies line break opportunities within words.
-
<table class=propdef>
<tbody>
<tr>
@@ -1322,6 +1324,9 @@
<td>specified value
</table>
+ <p>This property specifies line break opportunities within words. Values
+ have the following meanings:
+
<dl>
<dt><dfn id=normal1 title="word-break:normal"><code>normal</code></dfn>
@@ -1338,10 +1343,10 @@
<dt><dfn id=keep-all
title="line-break:keep-all"><code>keep-all</code></dfn>
- <dd>Sequences of CJK characters can no longer break on implied break
- points. This option should only be used where the presence of word
- separator characters still creates line-breaking opportunities, as in
- Korean.
+ <dd>Sequences of <a href="#block-scripts">block characters can no longer
+ break on implied break points. This option is mostly used where the
+ presence of word separator characters still creates line-breaking
+ opportunities, as in Korean.</a>
<dt><dfn id=hyphenate
title="word-break:hyphenate"><code>hyphenate</code></dfn>
@@ -1351,13 +1356,11 @@
class=css>normal</code>’. Hyphenation requires that the user agent
have an hyphenation resource appropriate to the language of the text
being broken.
- <p class=issue>This value is proposed to replace ‘<code
- class=property>hyphenate</code>’ property currently defined in <a
- href="http://www.w3.org/TR/2007/WD-css3-gcpm-20070205/#hyphenation">Generated
- Content for Paged Media</a> draft. Note there are other values in the
- editor's draft, which could be added as ‘<code
+ <p class=issue>This value is proposed to replace the ‘<a
+ href="#hyphens0"><code class=property>hyphens</code></a>’
+ property. Other values could be added as ‘<code
class=css>word-break: hyphenate-all</code>’ and ‘<code
- class=css>word-break: none</code>’... are these needed?
+ class=css>word-break: none</code>’
</dl>
<p>When shaping scripts such as Arabic are allowed to break within words
@@ -1368,14 +1371,115 @@
<p>Hyphenation allows the controlled splitting of words to improve the
layout of paragraphs. CSS3 Text does not define the exact rules for
- hyphenation, but defines five properties and an at-rule that influence
+ hyphenation, but defines six properties and an at-rule that influence
hyphenation.
- <p>Hyphenation can be turned on or off with the ‘<a
- href="#word-break0"><code class=property>word-break</code></a>’
- property.
+ <p>Whether hyphenation is applied can controlled with the ‘<a
+ href="#hyphens0"><code class=property>hyphens</code></a>’ property.
- <h3 id=hyphenate-character><span class=secno>6.1. </span> Hyphens: the
+ <h3 id=hyphens><span class=secno>6.1. </span>Hyphenation Control: the
+ ‘<a href="#hyphens0"><code class=property>hyphens</code></a>’
+ property</h3>
+
+ <table class=propdef>
+ <tbody>
+ <tr>
+ <td>Name:
+
+ <td><dfn id=hyphens0>hyphens</dfn>
+
+ <tr>
+ <th>Value:
+
+ <td>none | manual | auto | all
+
+ <tr>
+ <th>Initial:
+
+ <td>manual
+
+ <tr>
+ <th>Applies to:
+
+ <td>all elements
+
+ <tr>
+ <th>Inherited:
+
+ <td>yes
+
+ <tr>
+ <th>Percentages:
+
+ <td>N/A
+
+ <tr>
+ <th>Media:
+
+ <td>visual
+
+ <tr>
+ <th>Computed value:
+
+ <td>specified value
+ </table>
+
+ <p>This property controls whether hyphenation is allowed to create more
+ break opportunities within a line of text. Values have the following
+ meanings:
+
+ <dl>
+ <dt>none
+
+ <dd>Words are not broken at line breaks, even if characters inside the
+ word suggest line break points.
+
+ <dt>manual
+
+ <dd>Words are only broken at line breaks where there are characters inside
+ the word that suggest line break opportunities. Characters can be
+ explicit or conditional.
+ <div class=example>
+ <p>In Unicode, U+00AD is a conditional "soft hyphen" and U+2010 is an
+ explicit hyphen. Unicode Standard Annex #14 describes the <a
+ href="http://unicode.org/reports/tr14/#SoftHyphen">role of soft hyphens
+ in</a> Unicode line breaking. <a href="#UAX14"
+ rel=biblioentry>[UAX14]<!--{{UAX14}}--></a>
+ </div>
+
+ <div class=example>
+ <p>In HTML, &shy; represents the soft hyphen character which
+ suggests a line break opportunity.
+
+ <pre>ex&shy;ample</pre>
+ </div>
+
+ <dt>auto
+
+ <dd>Words can be broken at appropriate hyphenation points either as
+ determined by hyphenation characters inside the word or as determined
+ automatically by a language-appropriate hyphenation resource (such as
+ those provided via ‘<code
+ class=css>@hyphenation-resource</code>’). Explicit hyphenation
+ characters inside a word take priority over automatic resources when
+ determining hyphenation points within the word.
+
+ <dt>all
+
+ <dd>All possible hyphenation points, as would be determined for
+ ‘<code class=css>auto</code>’, are marked. The visual
+ appearance of the mark is UA-dependent. This value is intended for
+ debugging. <span class=issue>Do we really need this value?</span>
+ </dl>
+
+ <p>Correct automatic hyphenation requires a hyphenation resource
+ appropriate to the language of the text being broken. The UA is therefore
+ only required to automatically hyphenate text for which the author has
+ declared a language (e.g. via HTML <code>lang</code> or XML
+ <code>xml:lang</code>) and for which it has an appropriate hyphenation
+ resource.
+
+ <h3 id=hyphenate-character><span class=secno>6.2. </span> Hyphens: the
‘<a href="#hyphenate-character0"><code
class=property>hyphenate-character</code></a>’ property</h3>
@@ -1439,7 +1543,7 @@
<pre>article { hyphenate-character: "\2010" }</pre>
</div>
- <h3 id=hyphenate-char-limits><span class=secno>6.2. </span> Hyphenation
+ <h3 id=hyphenate-char-limits><span class=secno>6.3. </span> Hyphenation
Character Limits: the ‘<a href="#hyphenate-limit-before"><code
class=property>hyphenate-limit-before</code></a>’ and ‘<a
href="#hyphenate-limit-after"><code
@@ -1547,7 +1651,7 @@
<p class=note>Unless the UA is able to calculate a better value, it is
suggested that ‘<code class=css>auto</code>’ means 2.
- <h3 id=hyphenate-line-limits><span class=secno>6.3. </span> Hyphenation
+ <h3 id=hyphenate-line-limits><span class=secno>6.4. </span> Hyphenation
Line Limits: the ‘<a href="#hyphenate-limit-lines"><code
class=property>hyphenate-limit-lines</code></a>’ and ‘<a
href="#hyphenate-limit-last"><code
@@ -1705,7 +1809,7 @@
</pre>
</div>
- <h3 id=hyphenation-resource><span class=secno>6.4. </span> Hyphenation
+ <h3 id=hyphenation-resource><span class=secno>6.5. </span> Hyphenation
Resources: the ‘<code class=css>@hyphenate-resource</code>’
rule</h3>
@@ -1762,7 +1866,7 @@
rule would never be used.
</div>
- <p class=issue>Use a format specifier, like @font-face?
+ <p class=issue>Use a format specifier, like @font-face? What is the format?
<p>UAs are not required to support this at-rule.
@@ -1977,11 +2081,12 @@
<dl>
<dt><dfn id=normal3 title="word-wrap:normal"><code>normal</code></dfn>
- <dd>The restrictions introduced by ‘<code class=css>word-break:
+ <dd>Lines may break only at allowed break points. However, the
+ restrictions introduced by ‘<code class=css>word-break:
keep-all</code>’ may be relaxed to match ‘<code
- class=css>word-break: normal</code>’ if there are no
- otherwise-acceptable break points in the line. Otherwise lines may break
- only at allowed break points.
+ class=css>word-break: normal</code>’ and the various hyphenation
+ limit properties may be ignored if there are no otherwise-acceptable
+ break points in the line.
<dt><dfn id=break-word
title="word-wrap:break-word"><code>break-word</code></dfn>
@@ -1997,6 +2102,11 @@
for emergency breaking? (This would give better results than ‘<code
class=css>break-word</code>’.)
+ <p class=issue>Should there be a ‘<code class=css>none</code>’
+ value, that prevents the relaxation of ‘<a href="#word-break0"><code
+ class=property>word-break</code></a>’ and hyphenation limit
+ restrictions?
+
<h2 id=justification><span class=secno>8. </span> Alignment and
Justification</h2>
@@ -3821,7 +3931,8 @@
<p class=note>Note that if there is not sufficient padding on the block
container, hanging punctuation may trigger overflow.
- <p class=issue>Check for Western use-cases. Add <code>hyphens</code> value?
+ <p class=issue>Check for Western use-cases. Add <a
+ href="#hyphens0"><code>hyphens</code></a> value?
<h2 id=decoration><span class=secno>11. </span> <a
name=text-decoration>Text Decoration</a></h2>
@@ -5208,6 +5319,16 @@
</dd>
<!---->
+ <dt id=UAX14>[UAX14]
+
+ <dd>Asmus Freytag. <a
+ href="http://www.unicode.org/unicode/reports/tr14/tr14-17.html"><cite>Line
+ Breaking Properties.</cite></a> 29 March 2005. Unicode Standard Annex
+ #14. URL: <a
+ href="http://www.unicode.org/unicode/reports/tr14/tr14-17.html">http://www.unicode.org/unicode/reports/tr14/tr14-17.html</a>
+ </dd>
+ <!---->
+
<dt id=ZHMARK>[ZHMARK]
<dd><cite>标点符号用法 (Punctuation
@@ -5336,6 +5457,21 @@
<td>visual
<tr valign=baseline>
+ <td><a class=property href="#hyphens0">hyphens</a>
+
+ <td>none | manual | auto | all
+
+ <td>manual
+
+ <td>all elements
+
+ <td>yes
+
+ <td>N/A
+
+ <td>visual
+
+ <tr valign=baseline>
<td><a class=property href="#letter-spacing0">letter-spacing</a>
<td><spacing-limit>{1,3}
@@ -5807,7 +5943,7 @@
title="''alphabetic''"><strong>11.1.6.</strong></a>
<li>‘<code class=css>always</code>’, <a href="#always"
- title="''always''"><strong>6.3.</strong></a>
+ title="''always''"><strong>6.4.</strong></a>
<li>authoring tool, <a href="#authoring-tool" title="authoring
tool"><strong>2.</strong></a>
@@ -5826,7 +5962,7 @@
title=collapsible><strong>4.2.</strong></a>
<li>‘<code class=css>column</code>’, <a href="#column"
- title="''column''"><strong>6.3.</strong></a>
+ title="''column''"><strong>6.4.</strong></a>
<li><a href="#each-line"><code>each-line</code></a>, <a href="#each-line"
title=each-line><strong>10.1.</strong></a>
@@ -5874,19 +6010,21 @@
title="hanging-punctuation:last"><strong>10.2.</strong></a>
<li>hyphenate-character, <a href="#hyphenate-character0"
- title=hyphenate-character><strong>6.1.</strong></a>
+ title=hyphenate-character><strong>6.2.</strong></a>
<li>hyphenate-limit-after, <a href="#hyphenate-limit-after"
- title=hyphenate-limit-after><strong>6.2.</strong></a>
+ title=hyphenate-limit-after><strong>6.3.</strong></a>
<li>hyphenate-limit-before, <a href="#hyphenate-limit-before"
- title=hyphenate-limit-before><strong>6.2.</strong></a>
+ title=hyphenate-limit-before><strong>6.3.</strong></a>
<li>hyphenate-limit-last, <a href="#hyphenate-limit-last"
- title=hyphenate-limit-last><strong>6.3.</strong></a>
+ title=hyphenate-limit-last><strong>6.4.</strong></a>
<li>hyphenate-limit-lines, <a href="#hyphenate-limit-lines"
- title=hyphenate-limit-lines><strong>6.3.</strong></a>
+ title=hyphenate-limit-lines><strong>6.4.</strong></a>
+
+ <li>hyphens, <a href="#hyphens0" title=hyphens><strong>6.1.</strong></a>
<li>letter-spacing, <a href="#letter-spacing0"
title=letter-spacing><strong>9.2.</strong></a>
@@ -5910,10 +6048,10 @@
title="line-break:strict"><strong>5.1.</strong></a>
<li>‘<code class=css>none</code>’, <a href="#none0"
- title="''none''"><strong>6.3.</strong></a>
+ title="''none''"><strong>6.4.</strong></a>
<li>‘<code class=css>page</code>’, <a href="#page"
- title="''page''"><strong>6.3.</strong></a>
+ title="''page''"><strong>6.4.</strong></a>
<li><percentage>, <a href="#ltlengthgt-or-ltpercentagegt"
title="<percentage>"><strong>9.</strong></a>
@@ -5934,7 +6072,7 @@
title="<spacing-limit>:normal"><strong>9.</strong></a>
<li>‘<code class=css>spread</code>’, <a href="#spread"
- title="''spread''"><strong>6.3.</strong></a>
+ title="''spread''"><strong>6.4.</strong></a>
<li>‘<code class=css>start</code>’, <a href="#start0"
title="''start''"><strong>8.2.</strong></a>
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-text/Overview.src.html,v
retrieving revision 1.131
retrieving revision 1.132
diff -u -d -r1.131 -r1.132
--- Overview.src.html 26 Jan 2011 06:11:27 -0000 1.131
+++ Overview.src.html 28 Jan 2011 00:47:26 -0000 1.132
@@ -858,8 +858,6 @@
<h3 id="word-break">
Word Breaking Rules: the 'word-break' property</h3>
- <p>This property specifies line break opportunities within words.</p>
-
<table class="propdef">
<tbody>
<tr>
@@ -897,6 +895,9 @@
</tbody>
</table>
+ <p>This property specifies line break opportunities within words.
+ Values have the following meanings:</p>
+
<dl>
<dt><dfn title="word-break:normal"><code>normal</code></dfn></dt>
<dd>Break words according to their usual rules.</dd>
@@ -906,19 +907,18 @@
the text is predominantly using CJK characters with few non-CJK excerpts
and it is desired that the text be better distributed on each line.</dd>
<dt><dfn title="line-break:keep-all"><code>keep-all</code></dfn></dt>
- <dd>Sequences of CJK characters can no longer break on implied break points.
- This option should only be used where the presence of word separator
+ <dd>Sequences of <a href="#block-scripts">block</i> characters
+ can no longer break on implied break points.
+ This option is mostly used where the presence of word separator
characters still creates line-breaking opportunities, as in Korean.</dd>
<dt><dfn title="word-break:hyphenate"><code>hyphenate</code></dfn></dt>
<dd>Words may be broken at an appropriate hyphenation point in addition
to opportunities available under ''normal''. Hyphenation requires
that the user agent have an hyphenation resource appropriate to the
language of the text being broken.
- <p class="issue">This value is proposed to replace 'hyphenate' property currently defined in
- <a href="http://www.w3.org/TR/2007/WD-css3-gcpm-20070205/#hyphenation">Generated
- Content for Paged Media</a> draft. Note there are other values in
- the editor's draft, which could be added as ''word-break: hyphenate-all''
- and ''word-break: none''... are these needed?</p></dd>
+ <p class="issue">This value is proposed to replace the 'hyphens'
+ property. Other values could be added as ''word-break: hyphenate-all''
+ and ''word-break: none''</p></dd>
</dl>
<p>When shaping scripts such as Arabic are allowed to break within words
@@ -929,10 +929,85 @@
<p>Hyphenation allows the controlled splitting of words to improve the
layout of paragraphs. CSS3 Text does not define the exact rules for
- hyphenation, but defines five properties and an at-rule that influence
+ hyphenation, but defines six properties and an at-rule that influence
hyphenation.
- <p>Hyphenation can be turned on or off with the 'word-break' property.
+ <p>Whether hyphenation is applied can controlled with the 'hyphens' property.
+
+ <h3 id="hyphens">Hyphenation Control: the 'hyphens' property</h3>
+
+ <table class=propdef>
+ <tr>
+ <td>Name:
+ <td><dfn>hyphens</dfn>
+ <tr>
+ <th>Value:
+ <td>none | manual | auto | all
+ <tr>
+ <th>Initial:
+ <td>manual
+ <tr>
+ <th>Applies to:
+ <td>all elements
+ <tr>
+ <th>Inherited:
+ <td>yes
+ <tr>
+ <th>Percentages:
+ <td>N/A
+ <tr>
+ <th>Media:
+ <td>visual
+ <tr>
+ <th>Computed value:
+ <td>specified value
+ </table>
+
+ <p>This property controls whether hyphenation is allowed to create more
+ break opportunities within a line of text. Values have the following
+ meanings:
+
+ <dl>
+ <dt>none
+ <dd>Words are not broken at line breaks, even if characters inside
+ the word suggest line break points.
+ <dt>manual
+ <dd>Words are only broken at line breaks where there are characters
+ inside the word that suggest line break opportunities. Characters
+ can be explicit or conditional.
+ <div class="example">
+ <p>In Unicode, U+00AD is a conditional "soft hyphen" and U+2010 is an
+ explicit hyphen. Unicode Standard Annex #14 describes the
+ <a href="http://unicode.org/reports/tr14/#SoftHyphen">role of soft hyphens in</a>
+ Unicode line breaking. [[UAX14]]
+ </div>
+
+ <div class="example">
+ <p>In HTML, &shy; represents the soft hyphen character which
+ suggests a line break opportunity.
+ <pre>ex&shy;ample</pre>
+ </div>
+ <dt>auto
+ <dd>Words can be broken at appropriate hyphenation points either as
+ determined by hyphenation characters inside the word or as
+ determined automatically by a language-appropriate hyphenation
+ resource (such as those provided via ''@hyphenation-resource'').
+ Explicit hyphenation characters inside a word take priority over
+ automatic resources when determining hyphenation points within
+ the word.
+ <dt>all
+ <dd>All possible hyphenation points, as would be determined for ''auto'',
+ are marked. The visual appearance of the mark is UA-dependent. This
+ value is intended for debugging. <span class="issue">Do we really need
+ this value?</span>
+ </dl>
+
+ <p>Correct automatic hyphenation requires a hyphenation resource
+ appropriate to the language of the text being broken. The UA is
+ therefore only required to automatically hyphenate text for which
+ the author has declared a language (e.g. via HTML <code>lang</code>
+ or XML <code>xml:lang</code>) and for which it has an appropriate
+ hyphenation resource.
<h3 id="hyphenate-character">
Hyphens: the 'hyphenate-character' property</h3>
@@ -1210,7 +1285,7 @@
would never be used.
</div>
- <p class="issue">Use a format specifier, like @font-face?</p>
+ <p class="issue">Use a format specifier, like @font-face? What is the format?</p>
<p>UAs are not required to support this at-rule.</p>
@@ -1384,10 +1459,11 @@
<dl>
<dt><dfn title="word-wrap:normal"><code>normal</code></dfn></dt>
- <dd>The restrictions introduced by ''word-break: keep-all'' may be
- relaxed to match ''word-break: normal'' if there are no
- otherwise-acceptable break points in the line. Otherwise lines
- may break only at allowed break points.</dd>
+ <dd>Lines may break only at allowed break points. However, the restrictions
+ introduced by ''word-break: keep-all'' may be relaxed to match
+ ''word-break: normal'' and the various hyphenation limit properties
+ may be ignored if there are no otherwise-acceptable break points in
+ the line.</dd>
<dt><dfn title="word-wrap:break-word"><code>break-word</code></dfn></dt>
<dd>An unbreakable "word" may be broken at an arbitrary point if
there are no otherwise-acceptable break points in the line.
@@ -1399,6 +1475,9 @@
on hyphenation only for emergency breaking? (This would give better
results than ''break-word''.)
+ <p class="issue">Should there be a ''none'' value, that prevents
+ the relaxation of 'word-break' and hyphenation limit restrictions?</p>
+
<h2 id="justification">
Alignment and Justification</h2>
Received on Friday, 28 January 2011 00:47:36 UTC