- From: Elika Etemad via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 08 Feb 2011 23:14:50 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-text
In directory hutz:/tmp/cvs-serv18316
Modified Files:
Overview.html Overview.src.html
Log Message:
Add hyphenate-resource property, so that howcome can't object to updating the official WD
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-text/Overview.html,v
retrieving revision 1.44
retrieving revision 1.45
diff -u -d -r1.44 -r1.45
--- Overview.html 8 Feb 2011 01:31:03 -0000 1.44
+++ Overview.html 8 Feb 2011 23:14:48 -0000 1.45
@@ -90,7 +90,7 @@
<dt>This version:
<dd><a href="http://dev.w3.org/csswg/css3-text/Overview.html">$Date:
- 2011/02/04 20:01:30 $ (CVS $Revision$)</a> <!--<dd><a
+ 2011/02/08 01:31:03 $ (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> -->
@@ -297,8 +297,19 @@
class=property>hyphenate-limit-last</code>’ properties</a>
<li><a href="#hyphenation-resource"><span class=secno>6.5. </span>
- Hyphenation Resources: the ‘<code
- class=css>@hyphenate-resource</code>’ rule</a>
+ Hyphenation Resources</a>
+ <ul class=toc>
+ <li><a href="#at-hyphenate-resource"><span class=secno>6.5.1.
+ </span>the ‘<code class=css>@hyphenate-resource</code>’
+ rule </a>
+
+ <li><a href="#the-hyphenate-resource"><span class=secno>6.5.2.
+ </span>The ‘<code
+ class=property>hyphenate-resource</code>’ property</a>
+
+ <li><a href="#hyphenation-issue"><span class=secno>6.5.3.
+ </span>Hyphenation Resource Issue</a>
+ </ul>
</ul>
<li><a href="#wrapping"><span class=secno>7. </span> Text Wrapping</a>
@@ -1859,26 +1870,32 @@
</div>
<h3 id=hyphenation-resource><span class=secno>6.5. </span> Hyphenation
- Resources: the ‘<code class=css>@hyphenate-resource</code>’
- rule</h3>
+ Resources</h3>
- <p>The ‘<code class=css>@hyphenate-resource</code>’ <a
+ <h4 id=at-hyphenate-resource><span class=secno>6.5.1. </span>the ‘<a
+ href="#hyphenate-resource"><code
+ class=css>@hyphenate-resource</code></a>’ rule</h4>
+
+ <p>The ‘<a href="#hyphenate-resource"><code
+ class=css>@hyphenate-resource</code></a>’ <a
href="http://www.w3.org/TR/CSS21/syndata.html#at-rules">at-rule</a> allows
the author to specify hyphenation resources that the UA may use to help it
hyphenate text correctly.
- <p>The ‘<code class=css>@hyphenate-resource</code>’ rule
- consists of the ‘<code class=css>@hyphenate-resource</code>’
- at-keyword followed by a hyphenation mapping declaration block, which has
- the same syntax as a declaration block, except that the properties are
- language codes and the property values are comma-separated lists of
- <url> component values indicating the location of author-suggested
- hyphenation resources ordered from most to least preferred. The keyword
- value ‘<code class=css>local</code>’ may be used in place of
- one of the <url> values to suggest the use of a local (UA-provided)
- hyphenation resource. If the ‘<code class=css>local</code>’
- value is missing, it is assumed to be the first (most-preferred) resource
- in the list.
+ <p>The ‘<a href="#hyphenate-resource"><code
+ class=css>@hyphenate-resource</code></a>’ rule consists of the
+ ‘<a href="#hyphenate-resource"><code
+ class=css>@hyphenate-resource</code></a>’ at-keyword followed by a
+ hyphenation mapping declaration block, which has the same syntax as a
+ declaration block, except that the properties are language codes and the
+ property values are comma-separated lists of <url> component values
+ indicating the location of author-suggested hyphenation resources ordered
+ from most to least preferred. The keyword value ‘<code
+ class=css>local</code>’ may be used in place of one of the
+ <url> values to suggest the use of a local (UA-provided) hyphenation
+ resource. If the ‘<code class=css>local</code>’ value is
+ missing, it is assumed to be the first (most-preferred) resource in the
+ list.
<p>The hyphenation resource list that applies to the text in an element is
the one given by the last hyphenation mapping declaration whose language
@@ -1919,6 +1936,134 @@
<p>UAs are not required to support this at-rule.
+ <h4 id=the-hyphenate-resource><span class=secno>6.5.2. </span>The ‘<a
+ href="#hyphenate-resource"><code
+ class=property>hyphenate-resource</code></a>’ property</h4>
+
+ <table class=propdef>
+ <tbody>
+ <tr>
+ <th>Name:
+
+ <td><dfn id=hyphenate-resource>hyphenate-resource</dfn>
+
+ <tr>
+ <th>Value:
+
+ <td>none | <uri> [, <uri> ]*
+
+ <tr>
+ <th>Initial:
+
+ <td>none
+
+ <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 specifies a comma-separated list of external resources
+ that can help the UA determine hyphenation points. If more than one
+ resource is specified, the UA should consult each resource – in
+ turn, from the beginning – until it finds one that is able to
+ determine hyphenation points in a word. The ‘<code
+ class=property>none</code>’ value indicates that no external
+ resources are available. In any case, the UA can also use local resources
+ not listed on this property.
+
+ <div class=example>
+ <p>Often, finding the right hyphenate resource is based on knowing the
+ language of the text. The <code>lang</code> attribute is recommended for
+ encoding the language, and the corresponding selector is used in this
+ example:
+
+ <pre>
+<!-- -->:lang(dk) { hyphenate-resource: url("hyph_da_DK.dic"), url("hyph_da_NO.dic") }
+ </pre>
+ </div>
+
+ <p>UAs are not required to support this property.
+
+ <h4 id=hyphenation-issue><span class=secno>6.5.3. </span>Hyphenation
+ Resource Issue</h4>
+
+ <div class=issue>
+ <p>‘<a href="#hyphenate-resource"><code
+ class=property>hyphenate-resource</code></a>’ and ‘<a
+ href="#hyphenate-resource"><code
+ class=css>@hyphenate-resource</code></a>’ are both proposed to
+ solve the same problem; only one is needed.</p>
+
+ <dl>
+ <dt>advantages of ‘<a href="#hyphenate-resource"><code
+ class=css>@hyphenate-resource</code></a>’
+
+ <dd>
+ <ul>
+ <li>Minimal data storage (set per-language, not per-element).
+
+ <li>Requires language-tagging, which also enables the correct use of
+ local dictionaries (and can also trigger other typographic
+ improvements).
+
+ <li>Can use RFC4647 language-mapping, which is more intelligent than
+ :lang()'s prefix-matching. (Could also argue that :lang() should use
+ RFC4647.)
+ </ul>
+
+ <dt>disadvantages of ‘<a href="#hyphenate-resource"><code
+ class=css>@hyphenate-resource</code></a>’
+
+ <dd>
+ <ul>
+ <li>Requires language-tagging; cannot select on any other criteria.
+ Variations in hyphenation rules within the same language in a given
+ document will require use of subtags.
+ </ul>
+
+ <dt>advantages of ‘<a href="#hyphenate-resource"><code
+ class=property>hyphenate-resource</code></a>’
+
+ <dd>
+ <ul>
+ <li>Can use any selector, not just language-mapping.
+
+ <li>Implemented in Prince.
+ </ul>
+
+ <dt>disadvantages of ‘<a href="#hyphenate-resource"><code
+ class=property>hyphenate-resource</code></a>’
+
+ <dd>
+ <ul>
+ <li>Requires per-element data storage.
+ </ul>
+ </dl>
+
+ <p>Feedback on this issue is requested.</p>
+ </div>
+
<h2 id=wrapping><span class=secno>7. </span> Text Wrapping</h2>
<p>Text wrapping is controlled by the ‘<a href="#text-wrap0"><code
@@ -5501,6 +5646,21 @@
<td>visual
<tr valign=baseline>
+ <td><a class=property href="#hyphenate-resource">hyphenate-resource</a>
+
+ <td>none | <uri> [, <uri> ]*
+
+ <td>none
+
+ <td>all elements
+
+ <td>yes
+
+ <td>N/A
+
+ <td>visual
+
+ <tr valign=baseline>
<td><a class=property href="#hyphens0">hyphens</a>
<td>none | manual | auto | all
@@ -6086,6 +6246,9 @@
<li>hyphenate-limit-lines, <a href="#hyphenate-limit-lines"
title=hyphenate-limit-lines><strong>6.4.</strong></a>
+ <li>hyphenate-resource, <a href="#hyphenate-resource"
+ title=hyphenate-resource><strong>6.5.2.</strong></a>
+
<li>hyphens, <a href="#hyphens0" title=hyphens><strong>6.1.</strong></a>
<li>letter-spacing, <a href="#letter-spacing0"
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-text/Overview.src.html,v
retrieving revision 1.139
retrieving revision 1.140
diff -u -d -r1.139 -r1.140
--- Overview.src.html 8 Feb 2011 01:31:03 -0000 1.139
+++ Overview.src.html 8 Feb 2011 23:14:48 -0000 1.140
@@ -1270,7 +1270,8 @@
</div>
<h3 id="hyphenation-resource">
- Hyphenation Resources: the ''@hyphenate-resource'' rule</h3>
+ Hyphenation Resources</h3>
+ <h4 id="at-hyphenate-resource">the ''@hyphenate-resource'' rule</h3>
<p>The ''@hyphenate-resource'' <a href="http://www.w3.org/TR/CSS21/syndata.html#at-rules">at-rule</a>
allows the author to specify hyphenation resources that the UA
@@ -1323,6 +1324,92 @@
<p>UAs are not required to support this at-rule.</p>
+ <h4 id="the-hyphenate-resource">The 'hyphenate-resource' property</h4>
+
+ <table class=propdef>
+ <tr>
+ <th>Name:
+ <td><dfn>hyphenate-resource</dfn>
+ <tr>
+ <th>Value:
+ <td>none | <uri> [, <uri> ]*
+ <tr>
+ <th>Initial:
+ <td>none
+ <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 specifies a comma-separated list of external resources
+ that can help the UA determine hyphenation points. If more than one
+ resource is specified, the UA should consult each resource –
+ in turn, from the beginning – until it finds one that is able to
+ determine hyphenation points in a word. The 'none' value indicates that
+ no external resources are available. In any case, the UA can also use
+ local resources not listed on this property.
+
+ <div class="example">
+ <p>Often, finding the right hyphenate resource is based on knowing the
+ language of the text. The <code>lang</code> attribute is recommended
+ for encoding the language, and the corresponding selector is used in
+ this example:
+ <pre>
+<!-- -->:lang(dk) { hyphenate-resource: url("hyph_da_DK.dic"), url("hyph_da_NO.dic") }
+ </pre>
+ </div>
+
+ <p>UAs are not required to support this property.</p>
+
+ <h4 id="hyphenation-issue">Hyphenation Resource Issue</h4>
+
+ <div class="issue">
+ <p>'hyphenate-resource' and ''@hyphenate-resource'' are both proposed
+ to solve the same problem; only one is needed.</p>
+
+ <dl>
+ <dt>advantages of ''@hyphenate-resource''</dt>
+ <dd><ul>
+ <li>Minimal data storage (set per-language, not per-element).
+ <li>Requires language-tagging, which also enables the correct use
+ of local dictionaries (and can also trigger other typographic
+ improvements).
+ <li>Can use RFC4647 language-mapping, which is more intelligent
+ than :lang()'s prefix-matching. (Could also argue that :lang()
+ should use RFC4647.)
+ </ul></dd>
+ <dt>disadvantages of ''@hyphenate-resource''</dt>
+ <dd><ul>
+ <li>Requires language-tagging; cannot select on any other criteria.
+ Variations in hyphenation rules within the same language in a given
+ document will require use of subtags.
+ </ul></dd>
+ <dt>advantages of 'hyphenate-resource'</dt>
+ <dd><ul>
+ <li>Can use any selector, not just language-mapping.
+ <li>Implemented in Prince.
+ </ul></dd>
+ <dt>disadvantages of 'hyphenate-resource'</dt>
+ <dd><ul>
+ <li>Requires per-element data storage.
+ </ul></dd>
+ </dl>
+
+ <p>Feedback on this issue is requested.</p>
+ </div>
+
<h2 id="wrapping">
Text Wrapping</h2>
Received on Tuesday, 8 February 2011 23:14:52 UTC