- From: CVS User fsasaki <cvsmail@w3.org>
- Date: Wed, 26 Jun 2013 05:01:21 +0000
- To: public-multilingualweb-lt-commits@w3.org
Update of /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20
In directory gil:/tmp/cvs-serv10228
Modified Files:
its20.html its20.odd
Log Message:
addressed replies from norbert on issue-113 at http://lists.w3.org/Archives/Public/public-multilingualweb-lt-comments/2013Jun/0003.html
--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2013/06/24 17:47:59 1.470
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2013/06/26 05:01:20 1.471
@@ -376,7 +376,7 @@
data models in RDF.</p><p>The following two examples provide more details about the distinction between the local
and global approach, using the <a href="#trans-datacat" shape="rect">Translate</a> data
category as an example.</p><div class="div3">
-<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="basic-concepts-selection-local" id="basic-concepts-selection-local" shape="rect"/>2.2.1 Local Approach</h4><p>The document in <a href="#EX-basic-concepts-1" shape="rect">Example 3</a> shows how a content author can use the ITS <code class="its-attr-markup">translate</code> attribute to indicate that all content inside the <code>author</code> element is not intended for translation (i.e. has to be left untranslated). Translation tools that are aware of the meaning of the attribute can protect the relevant content from being translated (possibly still allowing translators to see the protected content as context information).</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-basic-concepts-1" id="EX-basic-concepts-1" shape="rect"/>Example 3: ITS markup on elements in an XML document (local approach) </iv><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><article</strong> <span class="hl-attribute" style="color: #F5844C">xmlns</span>=<span class="hl-value" style="color: #993300">"http://docbook.org/ns /docbook"</span>
+<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="basic-concepts-selection-local" id="basic-concepts-selection-local" shape="rect"/>2.2.1 Local Approach</h4><p>The document in <a href="#EX-basic-concepts-1" shape="rect">Example 3</a> shows how a content author can use the ITS <code class="its-attr-markup">translate</code> attribute to indicate that all content inside the <code>author</code> element is not intended for translation (i.e. has to be left untranslated). Translation tools that are aware of the meaning of the attribute can protect the relevant content from being translated (possibly still allowing translators to see the protected content as context information).</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-basic-concepts-1" id="EX-basic-concepts-1" shape="rect"/>Example 3: ITS markup on elements in an XML document (local approach) </iv><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><article</strong> <span class="hl-attribute" style="color: #F5844C">xmlns</span>=<span class="hl-value" style="color: #993300">"http://docbook.org/ns/docbook"</span>
<span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span>
<span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"5.0"</span> <span class="hl-attribute" style="color: #F5844C">xml:lang</span>=<span class="hl-value" style="color: #993300">"en"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><info></strong>
@@ -1515,8 +1515,7 @@
attributes. The default is that elements are translatable and attributes are not.</p><p id="html5-translate-handling">For HTML: The interpretation of the <code class="its-attr-markup">translate</code> attribute is given in <a href="http://www.w3.org/TR/html51/dom.html#the-translate-attribute" shape="rect">HTML5</a>. Nodes in an HTML document selected via a <a href="#translate-global" shape="rect">global rule</a> are also interpreted following <a href="http://www.w3.org/TR/html51/dom.html#the-translate-attribute" shape="rect">HTML5</a>.</p><div class="note"><p class="prefix"><b>Note:</b></p><p>As of writing, the default in <a title="HTML5" href="#html5" shape="rect">[HTML5]</a> is that elements are translatable, and that translatable attributes inherit from the respective elements. There is a pre-defined list of translatable attributes, for example <code>alt</code> or <code>title</code>.</p><p>Since the <a title="HTML5" href="#html5" shape="rect">[HTML5]</a> definition also applies to nodes seected via global rules, a <code class="its-elem-markup">translateRule</code> like
<code><its:translateRule selector=""//h:img" translate="yes"/></code> will set the <code>img</code> element and its translatable attributes like <code>alt</code> to "yes".</p></div><p id="translate-global">GLOBAL: The <code class="its-elem-markup">translateRule</code> element contains the
following:</p><ul><li><p>A required <code class="its-attr-markup">selector</code> attribute. It contains an <a href="#selectors" shape="rect">absolute selector</a> that selects the nodes to which this
- rule applies.</p></li><li><p>A required <code class="its-attr-markup">translate</code> attribute with the value
- "yes" or "no".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translate-selector-1" id="EX-translate-selector-1" shape="rect"/>Example 28: The <a href="#trans-datacat" shape="rect">Translate</a> data category expressed
+ rule applies.</p></li><li><p>A required <code class="its-attr-markup">translate</code> attribute with the value"yes" or "no".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translate-selector-1" id="EX-translate-selector-1" shape="rect"/>Example 28: The <a href="#trans-datacat" shape="rect">Translate</a> data category expressed
globally</div><p>The <code class="its-elem-markup">translateRule</code> element specifies that the elements <code>code</code>
is not to be translated.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><its:translateRule</strong> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"no"</span> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//code"</span><strong class="hl-tag" style="color: #000096">/></strong>
@@ -3168,23 +3167,23 @@
examples:</p><ul><li><p>Verify during translation if a string fits into a fixed-size database
field.</p></li><li><p>Control the size of a string that is stored in a fixed-size memory buffer at
run-time.</p></li></ul><p>The storage size is always expressed in bytes and excludes any leading
- Byte-Order-Markers. It is provided along with the character set encoding and the line
+ Byte-Order-Markers. It is provided along with the character encoding and the line
break type that will be used when the content is stored. If the encoding form does not
use the byte as its unit (e.g. UTF-16 uses 16-bit code units) the storage size <a href="#rfc-keywords" shape="rect">MUST</a> still be given in byte (e.g., for UTF-16: 2 bytes
per 16-bit code unit). </p><p>An application verifying the storage size for a given content is expected to perform the following steps:</p><ul><li><p>All the LINE FEED (U+000A) characters of the content to verify are replaced by the character or characters
- specified by the line break type.</p></li><li><p>The resulting string is converted to an array of bytes using a character set encoder for the specified
+ specified by the line break type.</p></li><li><p>The resulting string is converted to an array of bytes using a character encoder for the specified
encoding. If a character cannot be represented with the specified encoding, an error is generated.</p></li><li><p>If the leading bytes represent a Byte-Order-Mark, they are stripped from that array.</p></li><li><p>The length of the resulting array is compared to the storage size provided. The content is
too long if the length is greater than the storage size.</p></li></ul><div class="note"><p class="prefix"><b>Note:</b></p><p>Storage size is not directly related to the display length of a text, and therefore is not intended as a display length constraint
mechanism.</p></div></div><div class="div3">
<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="storagesize-implementation" id="storagesize-implementation" shape="rect"/>8.20.2 Implementation</h4><p>The <a href="#storagesize" shape="rect">Storage Size</a> data category can be expressed with
global rules, or locally on individual elements. There is no inheritance. The default
- value of the character set encoding is "UTF-8", and the default value for the
+ value of the character encoding is "UTF-8", and the default value for the
line break is "lf" (LINE FEED (U+000A)).</p><p id="storagesize-global">GLOBAL: The <code class="its-elem-markup">storageSizeRule</code> element contains the
following:</p><ul><li><p>A required <code class="its-attr-markup">selector</code> attribute. It contains an <a href="#selectors" shape="rect">absolute
selector</a> that selects the nodes to which this rule applies.</p></li><li><p>Exactly one of the following:</p><ul><li><p>A <code class="its-attr-markup">storageSize</code> attribute. It contains the maximum number of
bytes the text of the selected node is allowed in storage.</p></li><li><p>A <code class="its-attr-markup">storageSizePointer</code> attribute that contains a <a href="#selectors" shape="rect">relative selector</a> pointing to a node with the
exact same semantics as <code class="its-attr-markup">storageSize</code>.</p></li></ul></li><li><p>None or exactly one of the following:</p><ul><li><p>A <code class="its-attr-markup">storageEncoding</code> attribute. It contains the name of the
- character set encoding used to calculate the number of bytes of the selected text.
+ character encoding used to calculate the number of bytes of the selected text.
The name <a href="#rfc-keywords" shape="rect">MUST</a> be one of the names or aliases
listed in the <a href="http://www.iana.org/assignments/character-sets" shape="rect">IANA Character Sets registry</a>
<a title="Character Sets" href="#ianacharsets" shape="rect">[IANA Character Sets]</a>. The default value is the string "UTF-8".</p></li><li><p>A <code class="its-attr-markup">storageEncodingPointer</code> attribute that contains a <a href="#selectors" shape="rect">relative selector</a> pointing to a node with the
@@ -3221,7 +3220,7 @@
<strong class="hl-tag" style="color: #000096"></fields></strong></pre></div><p>[Source file: <a href="examples/xml/EX-storageSize-global-2.xml" shape="rect">examples/xml/EX-storageSize-global-2.xml</a>]</p></div><p id="storagesize-local">LOCAL: the following local markup is available for the
<a href="#storagesize" shape="rect">Storage Size</a> data category:</p><ul><li><p>A <code class="its-attr-markup">storageSize</code> attribute. It contains the maximum number of bytes
the text of the selected node is allowed in storage.</p></li><li><p>An optional <code class="its-attr-markup">storageEncoding</code> attribute. It contains the name of the
- character set encoding used to calculate the number of bytes of the selected text. The
+ character encoding used to calculate the number of bytes of the selected text. The
name <a href="#rfc-keywords" shape="rect">MUST</a> be one of the names or aliases listed
in the <a href="http://www.iana.org/assignments/character-sets" shape="rect">IANA Character
Sets registry</a>
@@ -3432,8 +3431,7 @@
</td><td rowspan="1" colspan="1">S or T</td><td rowspan="1" colspan="1">Legally inappropriate material is to be classified as <code>legal</code>.</td></tr><tr><td rowspan="1" colspan="1">
<code>locale-violation</code>
</td><td rowspan="1" colspan="1">Text violates norms for the intended locale.</td><td rowspan="1" colspan="1">
- <ul><li><p>A text localized into German has dates in YYYY-MM-DD format instead of in
- DD.MM.YYYY.</p></li><li><p>A text for the Irish market uses American-style foot and inch measurements
+ <ul><li><p>A text localized into German has dates in <code>mm/dd/yyyy</code> format instead of <code>DD.MM.YYYY</code>.</p></li><li><p>A text for the Irish market uses American-style foot and inch measurements
instead of centimeters.</p></li><li><p>A text intended for a U.S.-based audience uses U.K. spellings such as “centre”
and “colour.”</p></li></ul>
</td><td rowspan="1" colspan="1">S or T</td><td rowspan="1" colspan="1">This value can be used for spelling errors only if they relate specifically to
--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2013/06/24 17:47:59 1.481
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2013/06/26 05:01:20 1.482
@@ -4701,7 +4701,7 @@
run-time.</item>
</list>
<p>The storage size is always expressed in bytes and excludes any leading
- Byte-Order-Markers. It is provided along with the character set encoding and the line
+ Byte-Order-Markers. It is provided along with the character encoding and the line
break type that will be used when the content is stored. If the encoding form does not
use the byte as its unit (e.g. UTF-16 uses 16-bit code units) the storage size <ref
target="#rfc-keywords">MUST</ref> still be given in byte (e.g., for UTF-16: 2 bytes
@@ -4710,7 +4710,7 @@
<list type="unordered">
<item><p>All the LINE FEED (U+000A) characters of the content to verify are replaced by the character or characters
specified by the line break type.</p></item>
- <item><p>The resulting string is converted to an array of bytes using a character set encoder for the specified
+ <item><p>The resulting string is converted to an array of bytes using a character encoder for the specified
encoding. If a character cannot be represented with the specified encoding, an error is generated.</p></item>
<item><p>If the leading bytes represent a Byte-Order-Mark, they are stripped from that array.</p></item>
<item><p>The length of the resulting array is compared to the storage size provided. The content is
@@ -4725,7 +4725,7 @@
<head>Implementation</head>
<p>The <ref target="#storagesize">Storage Size</ref> data category can be expressed with
global rules, or locally on individual elements. There is no inheritance. The default
- value of the character set encoding is <val>UTF-8</val>, and the default value for the
+ value of the character encoding is <val>UTF-8</val>, and the default value for the
line break is <val>lf</val> (LINE FEED (U+000A)).</p>
<p xml:id="storagesize-global">GLOBAL: The <gi>storageSizeRule</gi> element contains the
following:</p>
@@ -4744,7 +4744,7 @@
<item><p>None or exactly one of the following:</p>
<list type="unordered">
<item><p>A <att>storageEncoding</att> attribute. It contains the name of the
- character set encoding used to calculate the number of bytes of the selected text.
+ character encoding used to calculate the number of bytes of the selected text.
The name <ref target="#rfc-keywords">MUST</ref> be one of the names or aliases
listed in the <ref target="http://www.iana.org/assignments/character-sets"
>IANA Character Sets registry</ref>
@@ -4790,7 +4790,7 @@
<item><p>A <att>storageSize</att> attribute. It contains the maximum number of bytes
the text of the selected node is allowed in storage.</p></item>
<item><p>An optional <att>storageEncoding</att> attribute. It contains the name of the
- character set encoding used to calculate the number of bytes of the selected text. The
+ character encoding used to calculate the number of bytes of the selected text. The
name <ref target="#rfc-keywords">MUST</ref> be one of the names or aliases listed
in the <ref target="http://www.iana.org/assignments/character-sets">IANA Character
Sets registry</ref>
@@ -5228,8 +5228,7 @@
<cell>Text violates norms for the intended locale.</cell>
<cell>
<list>
- <item>A text localized into German has dates in YYYY-MM-DD format instead of in
- DD.MM.YYYY.</item>
+ <item>A text localized into German has dates in <code>mm/dd/yyyy</code> format instead of <code>DD.MM.YYYY</code>.</item>
<item>A text for the Irish market uses American-style foot and inch measurements
instead of centimeters.</item>
<item>A text intended for a U.S.-based audience uses U.K. spellings such as “centre”
Received on Wednesday, 26 June 2013 05:01:22 UTC