- From: CVS User fsasaki <cvsmail@w3.org>
- Date: Tue, 07 May 2013 22:06:45 +0000
- To: public-multilingualweb-lt-commits@w3.org
Update of /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20
In directory gil:/tmp/cvs-serv373
Modified Files:
its20.html its20.odd
Log Message:
edits related to issue-89 and our resolution about HTML translate
--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2013/05/07 20:39:38 1.415
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2013/05/07 22:06:44 1.416
@@ -60,9 +60,9 @@
<div class="toc3">5.2.2 <a href="#selection-local" shape="rect">Local Selection in an XML Document</a></div>
</div>
<div class="toc2">5.3 <a href="#selectors" shape="rect">Query Language of Selectors</a><div class="toc3">5.3.1 <a href="#queryLanguage" shape="rect">Choosing Query Language</a></div>
-<div class="toc3">5.3.2 <a href="#d0e2274" shape="rect">XPath 1.0</a></div>
+<div class="toc3">5.3.2 <a href="#d0e2278" shape="rect">XPath 1.0</a></div>
<div class="toc3">5.3.3 <a href="#css-selectors" shape="rect">CSS Selectors</a></div>
-<div class="toc3">5.3.4 <a href="#d0e2519" shape="rect">Additional query languages</a></div>
+<div class="toc3">5.3.4 <a href="#d0e2523" shape="rect">Additional query languages</a></div>
<div class="toc3">5.3.5 <a href="#its-param" shape="rect">Variables in selectors</a></div>
</div>
<div class="toc2">5.4 <a href="#link-external-rules" shape="rect">Link to External Rules</a></div>
@@ -462,31 +462,29 @@
take <a href="#selection-precedence" shape="rect">precedence</a> over language information conveyed via a global <code class="its-elem-markup">langRule</code>.</p></li><li><p>The <a href="#idvalue" shape="rect">Id Value</a> data category has the HTML or XHTML <code>id</code> attribute.
This attribute acts as local markup for the <a href="#idvalue" shape="rect">Id Value</a> data category in HTML and take <a href="#selection-precedence" shape="rect">precedence</a> over
id information conveyed via a global <code class="its-elem-markup">idValueRule</code>.</p></li><li><p>The <a href="#elements-within-text" shape="rect">Elements within Text</a> data category has a set of HTML
- elements defined as inline attributes (@@@tbd: add link@@@). In the absence of an <a href="#elements-within-text" shape="rect">Elements within Text</a> local attribute or global rules selecting the
- element in question, these elements are always interpreted as <code>withinText="yes"</code> by default.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-and-existing-HTML5-markup" id="EX-its-and-existing-HTML5-markup" shape="rect"/>Example 10: The <a href="#language-information" shape="rect">Language Information</a>, <a href="#idvalue" shape="rect">Id Value</a>,
- and <a href="#elements-within-text" shape="rect">Elements within Text</a>
+ elements defined as <a href="http://www.w3.org/TR/html51/dom.html#phrasing-content-1" shape="rect">phrasing content</a>. In the absence of an
+ <a href="#elements-within-text" shape="rect">Elements within Text</a> local attribute or global rules selecting the
+ element in question, these elements are always interpreted as <code>withinText="yes"</code> by default.</p></li><li><p>The <a href="#trans-datacat" shape="rect">Translate</a> data category has a direct counterpart in
+ <a title="HTML5" href="#html5" shape="rect">[HTML5]</a>, namely the HTML5
+ <code>translate</code> attribute. ITS 2.0 does not define its own behaviour for HTML5 <code>translate</code>, but just refers to <a href="http://www.w3.org/TR/html51/dom.html#the-translate-attribute" shape="rect">the HTML5 definition</a>.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-and-existing-HTML5-markup" id="EX-its-and-existing-HTML5-markup" shape="rect"/>Example 10: The <a href="#language-information" shape="rect">Language Information</a>, <a href="#idvalue" shape="rect">Id Value</a>,
+ <a href="#elements-within-text" shape="rect">Elements within Text</a> and <a href="#trans-datacat" shape="rect">Translate</a>
ITS 2.0 data categories used with
HTML native markup.</div><p>The <code>html</code> element is interpreted to convey the
<a href="#language-information" shape="rect">Language Information</a> value "en".
The <code>p</code> element is interpreted to
convey the <a href="#idvalue" shape="rect">Id Value</a> of "p1". The <code>em</code> element
- is interpreted to be <code>withinText="yes"</code>.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: blue"><!DOCTYPE html></strong>
+ is interpreted to be <code>withinText="yes"</code>. The <code>img</code> element is set to be translatable via an <a title="HTML5" href="#html5" shape="rect">[HTML5]</a>
+ <code>translate</code> attribute. Here the <code>alt</code> attribute will also be translatable.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: blue"><!DOCTYPE html></strong>
<strong class="hl-tag" style="color: #000096"><html</strong> <span class="hl-attribute" style="color: #F5844C">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"><head></strong>
<strong class="hl-tag" style="color: #000096"><meta</strong> <span class="hl-attribute" style="color: #F5844C">charset</span>=<span class="hl-value" style="color: #993300">utf-8</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><title></strong>HTML native markup expressing three ITS 2.0 data categories<strong class="hl-tag" style="color: #000096"></title></strong>
<strong class="hl-tag" style="color: #000096"></head></strong>
<strong class="hl-tag" style="color: #000096"><body></strong>
- <strong class="hl-tag" style="color: #000096"><p</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"p1"</span><strong class="hl-tag" style="color: #000096">></strong>This is a <strong class="hl-tag" style="color: #000096"><em></strong>motherboard<strong class="hl-tag" style="color: #000096"></em></strong>.<strong class="hl-tag" style="color: #000096"></p></strong>
+ <strong class="hl-tag" style="color: #000096"><p</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"p1"</span><strong class="hl-tag" style="color: #000096">></strong>This is a <strong class="hl-tag" style="color: #000096"><em></strong>motherboard<strong class="hl-tag" style="color: #000096"></em></strong> and
+ and image: <strong class="hl-tag" style="color: #000096"><img</strong> <span class="hl-attribute" style="color: #F5844C">src</span>=<span class="hl-value" style="color: #993300">"http://example.com/myimg.png"</span> <span class="hl-attribute" style="color: #F5844C">alt</span>=<span class="hl-value" style="color: #993300">"My image"</span><strong class="hl-tag" style="color: #000096">/></strong>.<strong class="hl-tag" style="color: #000096"></p></strong>
<strong class="hl-tag" style="color: #000096"></body></strong>
-<strong class="hl-tag" style="color: #000096"></html></strong></pre></div><p>[Source file: <a href="examples/html5/EX-its-and-existing-HTML5-markup.html" shape="rect">examples/html5/EX-its-and-existing-HTML5-markup.html</a>]</p></div><span class="editor-note">[Ed. note: Need to add a link to the wiki with HTML5 Translate, once the wiki is set up. See <a href="https://www.w3.org/International/multilingualweb/lt/track/actions/497" shape="rect">action-497</a> and <a href="https://www.w3.org/International/multilingualweb/lt/track/actions/498" shape="rect">action-498</a>.]</span><ul><li><p>The <a href="#trans-datacat" shape="rect">Translate</a> data category has a direct counterpart in
- <a title="HTML5" href="#html5" shape="rect">[HTML5]</a>, namely the HTML5
- <code>translate</code> attribute. The definition of that attribute in terms of defaults and the relation between
- attribute and elements translatability is similar, but
- not identical to ITS 2.0. In addition, as of writing of this
- document, the definition of the <code>translate</code> attribute in HTML5 is not
- stable. To avoid unexpected behaviour, users of ITS 2.0 are strongly encouraged to set <a href="#trans-datacat" shape="rect">Translate</a>
- behavior in HTML5 explicitly via global rules, and to process local <code>translate</code> attributes in HTML5 with dedicated ITS 2.0 processors.</p></li></ul><p>There are also some HTML markup elements that have similar, but not always identical, roles and behaviour than certain ITS 2.0 data categories.
+<strong class="hl-tag" style="color: #000096"></html></strong></pre></div><p>[Source file: <a href="examples/html5/EX-its-and-existing-HTML5-markup.html" shape="rect">examples/html5/EX-its-and-existing-HTML5-markup.html</a>]</p></div><p>There are also some HTML markup elements that have similar, but not always identical, roles and behaviour than certain ITS 2.0 data categories.
For example, the HTML <code>dfn</code> element
could be used to identify a term in the sense of the <a href="#terminology" shape="rect">Terminology</a> data
category. However, this is not always the case and it depends on the
@@ -692,7 +690,7 @@
and localization of XML schemas and documents.] The concept of a data
category is independent of its implementation in an XML and HTML environment (e.g. using
an element or attribute).</p><p>For each data category, ITS distinguishes between the following:</p><ul><li><p>the prose description, see <a class="section-ref" href="#datacategory-description" shape="rect">Section 8: Description of Data Categories</a></p></li><li><p>schema language independent formalization, see the "implementation" subsections in
- <a class="section-ref" href="#datacategory-description" shape="rect">Section 8: Description of Data Categories</a></p></li><li><p>schema language specific implementations, see <a class="section-ref" href="#its-schemas" shape="rect">Appendix D: Schemas for ITS</a></p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d0e1372" id="d0e1372" shape="rect"/>Example 14: A data category and its implementation</div><p>The <a href="#trans-datacat" shape="rect">Translate</a> data category conveys information as
+ <a class="section-ref" href="#datacategory-description" shape="rect">Section 8: Description of Data Categories</a></p></li><li><p>schema language specific implementations, see <a class="section-ref" href="#its-schemas" shape="rect">Appendix D: Schemas for ITS</a></p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d0e1376" id="d0e1376" shape="rect"/>Example 14: A data category and its implementation</div><p>The <a href="#trans-datacat" shape="rect">Translate</a> data category conveys information as
to whether a piece of content should be translated or not.</p><p>The simplest formalization of this prose description on a schema language independent
level is a <code class="its-attr-markup">translate</code> attribute with two possible values:
"yes" and "no". An implementation on a schema language specific
@@ -956,9 +954,9 @@
actual query language. The query language is set by <code class="its-attr-markup">queryLanguage</code> attribute
on <code class="its-elem-markup">rules</code> element. If <code class="its-attr-markup">queryLanguge</code> is not specified XPath 1.0 is
used as a default query language.</p></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="d0e2274" id="d0e2274" shape="rect"/>5.3.2 XPath 1.0</h4><p>XPath 1.0 is identified by <code>xpath</code> value in <code class="its-attr-markup">queryLanguage</code>
+<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="d0e2278" id="d0e2278" shape="rect"/>5.3.2 XPath 1.0</h4><p>XPath 1.0 is identified by <code>xpath</code> value in <code class="its-attr-markup">queryLanguage</code>
attribute.</p><div class="div4">
-<h5><a name="d0e2285" id="d0e2285" shape="rect"/>5.3.2.1 Absolute selector</h5><p>The absolute selector <a href="#rfc-keywords" shape="rect">MUST</a> be an XPath expression
+<h5><a name="d0e2289" id="d0e2289" shape="rect"/>5.3.2.1 Absolute selector</h5><p>The absolute selector <a href="#rfc-keywords" shape="rect">MUST</a> be an XPath expression
which starts with "<code>/</code>". That is, it must be an <a href="http://www.w3.org/TR/xpath/#NT-AbsoluteLocationPath" shape="rect">
AbsoluteLocationPath</a> or union of <a href="http://www.w3.org/TR/xpath/#NT-AbsoluteLocationPath" shape="rect">
AbsoluteLocationPath</a>s as described in <a href="#xpath" shape="rect">XPath 1.0</a>.
@@ -1003,14 +1001,14 @@
implementations can be used.</p></div><div class="note"><p class="prefix"><b>Note:</b></p><p id="css-selectors-and-attributes">CSS selectors have no ability to point to
attributes.</p></div><p>CSS Selectors are identified by <code>css</code> value in <code class="its-attr-markup">queryLanguage</code>
attribute.</p><div class="div4">
-<h5><a name="d0e2496" id="d0e2496" shape="rect"/>5.3.3.1 Absolute selector</h5><p>Absolute selector <a href="#rfc-keywords" shape="rect">MUST</a> be interpreted as selector
+<h5><a name="d0e2500" id="d0e2500" shape="rect"/>5.3.3.1 Absolute selector</h5><p>Absolute selector <a href="#rfc-keywords" shape="rect">MUST</a> be interpreted as selector
as defined in <a title="Selectors Level
 3" href="#css3-selectors" shape="rect">[Selectors Level 3]</a>. Both simple selectors
and groups of selectors can be used.</p></div><div class="div4">
-<h5><a name="d0e2506" id="d0e2506" shape="rect"/>5.3.3.2 Relative selector</h5><p>Relative selector <a href="#rfc-keywords" shape="rect">MUST</a> be interpreted as selector
+<h5><a name="d0e2510" id="d0e2510" shape="rect"/>5.3.3.2 Relative selector</h5><p>Relative selector <a href="#rfc-keywords" shape="rect">MUST</a> be interpreted as selector
as defined in <a title="Selectors Level
 3" href="#css3-selectors" shape="rect">[Selectors Level 3]</a>. Selector is not
evaluated against the complete document tree but only against subtrees rooted at
nodes selected by selector in the <code class="its-attr-markup">selector</code> attribute.</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="d0e2519" id="d0e2519" shape="rect"/>5.3.4 Additional query languages</h4><p>ITS processors <a href="#rfc-keywords" shape="rect">MAY</a> support additional query
+<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="d0e2523" id="d0e2523" shape="rect"/>5.3.4 Additional query languages</h4><p>ITS processors <a href="#rfc-keywords" shape="rect">MAY</a> support additional query
languages. For each additional query language the processor <a href="#rfc-keywords" shape="rect">MUST</a> define:</p><ul><li><p>identifier of query language used in <code class="its-attr-markup">queryLanguage</code>;</p></li><li><p>rules for evaluating absolute selector to collection of nodes;</p></li><li><p>rules for evaluating relative selector to collection of nodes.</p></li></ul><p>Because future versions of this specification are likely to define additional query
languages, the following query language identifiers are reserved: <code>xpath</code>,
<code>css</code>, <code>xpath2</code>, <code>xpath3</code>, <code>xquery</code>,
--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2013/05/07 20:39:39 1.406
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2013/05/07 22:06:45 1.407
@@ -534,34 +534,27 @@
This attribute acts as local markup for the <ref target="#idvalue">Id Value</ref> data category in HTML and take <ref target="#selection-precedence">precedence</ref> over
id information conveyed via a global <gi>idValueRule</gi>.</item>
<item>The <ref target="#elements-within-text">Elements within Text</ref> data category has a set of HTML
- elements defined as inline attributes (@@@tbd: add link@@@). In the absence of an
+ elements defined as <ref target="http://www.w3.org/TR/html51/dom.html#phrasing-content-1">phrasing content</ref>. In the absence of an
<ref target="#elements-within-text">Elements within Text</ref> local attribute or global rules selecting the
element in question, these elements are always interpreted as
<code>withinText="yes"</code> by default.</item>
+ <item>The <ref target="#trans-datacat">Translate</ref> data category has a direct counterpart in
+ <ptr target="#html5" type="bibref"/>, namely the HTML5
+ <code>translate</code> attribute. ITS 2.0 does not define its own behaviour for HTML5 <code>translate</code>, but just refers to <ref target="http://www.w3.org/TR/html51/dom.html#the-translate-attribute">the HTML5 definition</ref>.</item>
</list>
<exemplum xml:id="EX-its-and-existing-HTML5-markup">
<head>The <ref target="#language-information">Language Information</ref>, <ref target="#idvalue">Id Value</ref>,
- and <ref target="#elements-within-text">Elements within Text</ref>
+ <ref target="#elements-within-text">Elements within Text</ref> and <ref target="#trans-datacat">Translate</ref>
ITS 2.0 data categories used with
HTML native markup.</head>
<p>The <code>html</code> element is interpreted to convey the
<ref target="#language-information">Language Information</ref> value <val>en</val>.
The <code>p</code> element is interpreted to
convey the <ref target="#idvalue">Id Value</ref> of <val>p1</val>. The <code>em</code> element
- is interpreted to be <code>withinText="yes"</code>.</p>
+ is interpreted to be <code>withinText="yes"</code>. The <code>img</code> element is set to be translatable via an <ptr target="#html5" type="bibref"/> <code>translate</code> attribute. Here the <code>alt</code> attribute will also be translatable.</p>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/html5/EX-its-and-existing-HTML5-markup.html"/>
</exemplum>
- <note type="ed">Need to add a link to the wiki with HTML5 Translate, once the wiki is set up. See <ref target="https://www.w3.org/International/multilingualweb/lt/track/actions/497">action-497</ref> and <ref target="https://www.w3.org/International/multilingualweb/lt/track/actions/498">action-498</ref>.</note>
- <list type="unordered"><item>The <ref target="#trans-datacat">Translate</ref> data category has a direct counterpart in
- <ptr target="#html5" type="bibref"/>, namely the HTML5
- <code>translate</code> attribute. The definition of that attribute in terms of defaults and the relation between
- attribute and elements translatability is similar, but
- not identical to ITS 2.0. In addition, as of writing of this
- document, the definition of the <code>translate</code> attribute in HTML5 is not
- stable. To avoid unexpected behaviour, users of ITS 2.0 are strongly encouraged to set <ref target="#trans-datacat">Translate</ref>
- behavior in HTML5 explicitly via global rules, and to process local
- <code>translate</code> attributes in HTML5 with dedicated ITS 2.0 processors.</item></list>
<p>There are also some HTML markup elements that have similar, but not always identical, roles and behaviour than certain ITS 2.0 data categories.
For example, the HTML <code>dfn</code> element
could be used to identify a term in the sense of the <ref target="#terminology">Terminology</ref> data
Received on Tuesday, 7 May 2013 22:06:47 UTC