- From: Elika Etemad via cvs-syncmail <cvsmail@w3.org>
- Date: Sat, 07 Jan 2012 01:20:44 +0000
- To: public-css-commits@w3.org
Update of /sources/public/csswg/css3-text
In directory hutz:/tmp/cvs-serv2894
Modified Files:
Overview.html Overview.src.html
Log Message:
Multi-script examples for 'word-break' and 'hyphens'; fix glitch in 'word-break: break-all' definition.
Index: Overview.html
===================================================================
RCS file: /sources/public/csswg/css3-text/Overview.html,v
retrieving revision 1.200
retrieving revision 1.201
diff -u -d -r1.200 -r1.201
--- Overview.html 6 Jan 2012 22:59:32 -0000 1.200
+++ Overview.html 7 Jan 2012 01:20:41 -0000 1.201
@@ -29,14 +29,14 @@
<h1>CSS Text Level 3</h1>
- <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 6 January 2012</h2>
+ <h2 class="no-num no-toc" id=longstatus-date>Editor's Draft 7 January 2012</h2>
<dl>
<dt>This version:
<dd><a href="http://dev.w3.org/csswg/css3-text/">$Date: 2012/01/06
- 22:56:54 $ (CVS $Revision$)</a> <!--
- <dd><a href="http://www.w3.org/TR/2012/WD-css3-text-20120106/">http://www.w3.org/TR/2012/WD-css3-text-20120106/</a></dd>
+ 22:59:32 $ (CVS $Revision$)</a> <!--
+ <dd><a href="http://www.w3.org/TR/2012/WD-css3-text-20120107/">http://www.w3.org/TR/2012/WD-css3-text-20120107/</a></dd>
-->
@@ -1414,10 +1414,11 @@
<dt><dfn id=break-all title="word-break:break-all">‘<code
class=css>break-all</code>’</dfn>
- <dd>Lines may break between any two characters within words. Hyphenation
- is not applied. This option is used mostly in a context where 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>In addition to normal opportunities, lines may break between any two
+ letters within words. Hyphenation is not applied. This option is used
+ mostly in a context where 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.
<dt><dfn id=keep-all title="word-break:keep-all">‘<code
class=css>keep-all</code>’</dfn>
@@ -1429,6 +1430,40 @@
line-breaking opportunities, as in Korean.
</dl>
+ <div class=example>
+ <p>Here's a mixed-script sample text:
+
+ <pre>这是一些汉字, and some Latin text,<!--
+ --> و کمی نوشتنن عربی, <!--
+ -->and some complex LTR.</pre>
+
+ <p>The break-points are determined as follows (indicated by
+ ‘·’):
+
+ <dl>
+ <dt>‘<code class=css>word-break: normal</code>’
+
+ <dd>
+ <pre>这·是·一·些·汉·字,·and·some·Latin·text,<!--
+ -->·و·کمی·نوشتنن·عربی·<!--
+ -->and·some·complex·LTR.</pre>
+
+ <dt>‘<code class=css>word-break: break-all</code>’
+
+ <dd>
+ <pre>这·是·一·些·汉·字·a·n·d·s·o·m·e·L·a·t·i·n·t·e·x·t,<!--
+ -->·و·ﮐ·ﻤ·ﻰ·ﻧ·ﻮ·ﺷ·ﺘ·ﻦ·ﻋ·ﺮ·ﺑ·ﻰ,·<!--
+ -->a·n·d·s·o·m·e·c·o·m·p·l·e·x·L·T·R.</pre>
+
+ <dt>‘<code class=css>word-break: keep-all</code>’
+
+ <dd>
+ <pre>这是一些汉字,·and·some·Latin·text,<!--
+ -->·و·کمی·نوشتنن·عربی,·<!--
+ -->and·some·complex·LTR.</pre>
+ </dl>
+ </div>
+
<p>When shaping scripts such as Arabic are allowed to break within words
due to ‘<code class=css>break-all</code>’, the characters must
still be shaped as if the word were not broken.
@@ -1516,12 +1551,9 @@
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.
+ rel=biblioentry>[UAX14]<!--{{!UAX14}}--></a> In HTML, &shy;
+ represents the soft hyphen character which suggests a hyphenation
+ opportunity.
<pre>ex&shy;ample</pre>
</div>
@@ -1547,6 +1579,14 @@
due to hyphenation, the characters must still be shaped as if the word
were not broken.
+ <div class=example>
+ <p>For example, if the word
+ “نوشتنن” were
+ hyphenated, it would appear as
+ “ﻧﻮﺷ-ﺘﻦ” not as
+ “ﻧﻮﺵ-ﺗﻦ”.
+ </div>
+
<h2 id=wrapping><span class=secno>6. </span> Text Wrapping</h2>
<p>Text wrapping is controlled by the ‘<a href="#text-wrap0"><code
Index: Overview.src.html
===================================================================
RCS file: /sources/public/csswg/css3-text/Overview.src.html,v
retrieving revision 1.298
retrieving revision 1.299
diff -u -d -r1.298 -r1.299
--- Overview.src.html 6 Jan 2012 22:59:32 -0000 1.298
+++ Overview.src.html 7 Jan 2012 01:20:41 -0000 1.299
@@ -952,7 +952,8 @@
<dt><dfn title="word-break:normal">''normal''</dfn></dt>
<dd>Break lines according to their usual rules.</dd>
<dt><dfn title="word-break:break-all">''break-all''</dfn></dt>
- <dd>Lines may break between any two characters within words.
+ <dd>In addition to normal opportunities, lines may break between any two
+ letters within words.
Hyphenation is not applied. This option is used mostly in a context where
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>
@@ -964,6 +965,31 @@
characters still creates line-breaking opportunities, as in Korean.</dd>
</dl>
+ <div class="example">
+ <p>Here's a mixed-script sample text:
+ <pre>这是一些汉字, and some Latin text,<!--
+ --> و کمی نوشتنن عربی, <!--
+ -->and some complex LTR.</pre>
+ <p>The break-points are determined as follows (indicated by ‘·’):
+ <dl>
+ <dt>''word-break: normal''</dt>
+ <dd>
+ <pre>这·是·一·些·汉·字,·and·some·Latin·text,<!--
+ -->·و·کمی·نوشتنن·عربی·<!--
+ -->and·some·complex·LTR.</pre>
+ <dt>''word-break: break-all''</dt>
+ <dd>
+ <pre>这·是·一·些·汉·字·a·n·d·s·o·m·e·L·a·t·i·n·t·e·x·t,<!--
+ -->·و·ﮐ·ﻤ·ﻰ·ﻧ·ﻮ·ﺷ·ﺘ·ﻦ·ﻋ·ﺮ·ﺑ·ﻰ,·<!--
+ -->a·n·d·s·o·m·e·c·o·m·p·l·e·x·L·T·R.</pre>
+ <dt>''word-break: keep-all''</dt>
+ <dd>
+ <pre>这是一些汉字,·and·some·Latin·text,<!--
+ -->·و·کمی·نوشتنن·عربی,·<!--
+ -->and·some·complex·LTR.</pre>
+ </dl>
+ </div>
+
<p>When shaping scripts such as Arabic are allowed to break within words
due to ''break-all'', the characters must still be shaped as if the
word were not broken.</p>
@@ -1027,11 +1053,8 @@
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.
+ In HTML, &shy; represents the soft hyphen character which
+ suggests a hyphenation opportunity.
<pre>ex&shy;ample</pre>
</div>
<dt><dfn title="hyphens:auto">''auto''</dfn>
@@ -1055,6 +1078,12 @@
due to hyphenation, the characters must still be shaped as if the word
were not broken.</p>
+ <div class="example">
+ <p>For example, if the word “نوشتنن”
+ were hyphenated, it would appear as “ﻧﻮﺷ-ﺘﻦ”
+ not as “ﻧﻮﺵ-ﺗﻦ”.
+ </div>
+
<h2 id="wrapping">
Text Wrapping</h2>
Received on Saturday, 7 January 2012 01:20:46 UTC