- From: CVS User fsasaki <cvsmail@w3.org>
- Date: Fri, 23 Nov 2012 16:07:02 +0000
- To: public-multilingualweb-lt-commits@w3.org
Update of /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20
In directory gil:/tmp/cvs-serv7252
Modified Files:
its20.html its20.odd
Log Message:
Various edits, see http://lists.w3.org/Archives/Public/public-multilingualweb-lt/2012Nov/0193.html
--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2012/11/21 17:54:57 1.256
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2012/11/23 16:07:01 1.257
@@ -128,7 +128,8 @@
<div class="toc1">7 <a href="#html5-markup" shape="rect">Using ITS Markup in HTML5</a><div class="toc2">7.1 <a href="#html5-local-attributes" shape="rect">Mapping of Local Data Categories to HTML5</a></div>
<div class="toc2">7.2 <a href="#html5-external-global-rules" shape="rect">External Rules</a></div>
<div class="toc2">7.3 <a href="#html5-inline-global-rules" shape="rect">Inline Global Rules in HTML5</a></div>
-<div class="toc2">7.4 <a href="#html5-selection-precedence" shape="rect">Precedence between Selections</a></div>
+<div class="toc2">7.4 <a href="#html5-standoff-markup" shape="rect">Standoff Markup in HTML5</a></div>
+<div class="toc2">7.5 <a href="#html5-selection-precedence" shape="rect">Precedence between Selections</a></div>
</div>
<div class="toc1">8 <a href="#xhtml5-markup" shape="rect">Using ITS Markup in XHTML</a></div>
</div>
@@ -194,46 +195,46 @@
identifies which parts of an XML document need to be translated. Tools often cannot
automatically perform this identification.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d0e332" id="d0e332" shape="rect"/>Example 1: Document with partially translatable content</div><p>In this document it is difficult to distinguish between those <code>string</code>
elements that are translatable and those that are not. Only the addition of an
- explicit flag could resolve the issue.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><resources></strong>
- <strong class="hl-tag" style="color: #000096"><section</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"Homepage"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><arguments></strong>
- <strong class="hl-tag" style="color: #000096"><string></strong>page<strong class="hl-tag" style="color: #000096"></string></strong>
- <strong class="hl-tag" style="color: #000096"><string></strong>childlist<strong class="hl-tag" style="color: #000096"></string></strong>
- <strong class="hl-tag" style="color: #000096"></arguments></strong>
- <strong class="hl-tag" style="color: #000096"><variables></strong>
- <strong class="hl-tag" style="color: #000096"><string></strong>POLICY<strong class="hl-tag" style="color: #000096"></string></strong>
- <strong class="hl-tag" style="color: #000096"><string></strong>Corporate Policy<strong class="hl-tag" style="color: #000096"></string></strong>
- <strong class="hl-tag" style="color: #000096"></variables></strong>
- <strong class="hl-tag" style="color: #000096"><keyvalue_pairs></strong>
- <strong class="hl-tag" style="color: #000096"><string></strong>Page<strong class="hl-tag" style="color: #000096"></string></strong>
- <strong class="hl-tag" style="color: #000096"><string></strong>ABC Corporation - Policy Repository<strong class="hl-tag" style="color: #000096"></string></strong>
- <strong class="hl-tag" style="color: #000096"><string></strong>Footer_Last<strong class="hl-tag" style="color: #000096"></string></strong>
- <strong class="hl-tag" style="color: #000096"><string></strong>Pages<strong class="hl-tag" style="color: #000096"></string></strong>
- <strong class="hl-tag" style="color: #000096"><string></strong>bgColor<strong class="hl-tag" style="color: #000096"></string></strong>
- <strong class="hl-tag" style="color: #000096"><string></strong>NavajoWhite<strong class="hl-tag" style="color: #000096"></string></strong>
- <strong class="hl-tag" style="color: #000096"><string></strong>title<strong class="hl-tag" style="color: #000096"></string></strong>
- <strong class="hl-tag" style="color: #000096"><string></strong>List of Available Policies<strong class="hl-tag" style="color: #000096"></string></strong>
- <strong class="hl-tag" style="color: #000096"></keyvalue_pairs></strong>
- <strong class="hl-tag" style="color: #000096"></section></strong>
-<strong class="hl-tag" style="color: #000096"></resources></strong>
+ explicit flag could resolve the issue.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><resources></strong>
+ <strong class="hl-tag" style="color: #000096"><section</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"Homepage"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><arguments></strong>
+ <strong class="hl-tag" style="color: #000096"><string></strong>page<strong class="hl-tag" style="color: #000096"></string></strong>
+ <strong class="hl-tag" style="color: #000096"><string></strong>childlist<strong class="hl-tag" style="color: #000096"></string></strong>
+ <strong class="hl-tag" style="color: #000096"></arguments></strong>
+ <strong class="hl-tag" style="color: #000096"><variables></strong>
+ <strong class="hl-tag" style="color: #000096"><string></strong>POLICY<strong class="hl-tag" style="color: #000096"></string></strong>
+ <strong class="hl-tag" style="color: #000096"><string></strong>Corporate Policy<strong class="hl-tag" style="color: #000096"></string></strong>
+ <strong class="hl-tag" style="color: #000096"></variables></strong>
+ <strong class="hl-tag" style="color: #000096"><keyvalue_pairs></strong>
+ <strong class="hl-tag" style="color: #000096"><string></strong>Page<strong class="hl-tag" style="color: #000096"></string></strong>
+ <strong class="hl-tag" style="color: #000096"><string></strong>ABC Corporation - Policy Repository<strong class="hl-tag" style="color: #000096"></string></strong>
+ <strong class="hl-tag" style="color: #000096"><string></strong>Footer_Last<strong class="hl-tag" style="color: #000096"></string></strong>
+ <strong class="hl-tag" style="color: #000096"><string></strong>Pages<strong class="hl-tag" style="color: #000096"></string></strong>
+ <strong class="hl-tag" style="color: #000096"><string></strong>bgColor<strong class="hl-tag" style="color: #000096"></string></strong>
+ <strong class="hl-tag" style="color: #000096"><string></strong>NavajoWhite<strong class="hl-tag" style="color: #000096"></string></strong>
+ <strong class="hl-tag" style="color: #000096"><string></strong>title<strong class="hl-tag" style="color: #000096"></string></strong>
+ <strong class="hl-tag" style="color: #000096"><string></strong>List of Available Policies<strong class="hl-tag" style="color: #000096"></string></strong>
+ <strong class="hl-tag" style="color: #000096"></keyvalue_pairs></strong>
+ <strong class="hl-tag" style="color: #000096"></section></strong>
+<strong class="hl-tag" style="color: #000096"></resources></strong>
</pre></div><p>[Source file: <a href="examples/xml/EX-motivation-its-1.xml" shape="rect">examples/xml/EX-motivation-its-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d0e347" id="d0e347" shape="rect"/>Example 2: Document with partially translatable content</div><p>Even when metadata are available to identify non-translatable text, the conditions
may be quite complex and not directly indicated with a simple flag. Here, for
instance, only the text in the nodes matching the expression
- <code>//component[@type!='image']/data[@type='text']</code> is translatable.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><dialogue</strong> <span class="hl-attribute" style="color: #F5844C">xml:lang</span>=<span class="hl-value" style="color: #993300">"en-gb"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><rsrc</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"123"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><component</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"456"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"image"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"text"</span><strong class="hl-tag" style="color: #000096">></strong>images/cancel.gif<strong class="hl-tag" style="color: #000096"></data></strong>
- <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"coordinates"</span><strong class="hl-tag" style="color: #000096">></strong>12,20,50,14<strong class="hl-tag" style="color: #000096"></data></strong>
- <strong class="hl-tag" style="color: #000096"></component></strong>
- <strong class="hl-tag" style="color: #000096"><component</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"789"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"caption"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"text"</span><strong class="hl-tag" style="color: #000096">></strong>Cancel<strong class="hl-tag" style="color: #000096"></data></strong>
- <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"coordinates"</span><strong class="hl-tag" style="color: #000096">></strong>12,34,50,14<strong class="hl-tag" style="color: #000096"></data></strong>
- <strong class="hl-tag" style="color: #000096"></component></strong>
- <strong class="hl-tag" style="color: #000096"><component</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"792"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"string"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"text"</span><strong class="hl-tag" style="color: #000096">></strong>Number of files: <strong class="hl-tag" style="color: #000096"></data></strong>
- <strong class="hl-tag" style="color: #000096"></component></strong>
- <strong class="hl-tag" style="color: #000096"></rsrc></strong>
-<strong class="hl-tag" style="color: #000096"></dialogue></strong>
+ <code>//component[@type!='image']/data[@type='text']</code> is translatable.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><dialogue</strong> <span class="hl-attribute" style="color: #F5844C">xml:lang</span>=<span class="hl-value" style="color: #993300">"en-gb"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><rsrc</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"123"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><component</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"456"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"image"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"text"</span><strong class="hl-tag" style="color: #000096">></strong>images/cancel.gif<strong class="hl-tag" style="color: #000096"></data></strong>
+ <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"coordinates"</span><strong class="hl-tag" style="color: #000096">></strong>12,20,50,14<strong class="hl-tag" style="color: #000096"></data></strong>
+ <strong class="hl-tag" style="color: #000096"></component></strong>
+ <strong class="hl-tag" style="color: #000096"><component</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"789"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"caption"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"text"</span><strong class="hl-tag" style="color: #000096">></strong>Cancel<strong class="hl-tag" style="color: #000096"></data></strong>
+ <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"coordinates"</span><strong class="hl-tag" style="color: #000096">></strong>12,34,50,14<strong class="hl-tag" style="color: #000096"></data></strong>
+ <strong class="hl-tag" style="color: #000096"></component></strong>
+ <strong class="hl-tag" style="color: #000096"><component</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"792"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"string"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"text"</span><strong class="hl-tag" style="color: #000096">></strong>Number of files: <strong class="hl-tag" style="color: #000096"></data></strong>
+ <strong class="hl-tag" style="color: #000096"></component></strong>
+ <strong class="hl-tag" style="color: #000096"></rsrc></strong>
+<strong class="hl-tag" style="color: #000096"></dialogue></strong>
</pre></div><p>[Source file: <a href="examples/xml/EX-motivation-its-2.xml" shape="rect">examples/xml/EX-motivation-its-2.xml</a>]</p></div></div></div><div class="div2">
<h3><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="users-usage" id="users-usage" shape="rect"/>1.3 Users and Usages of ITS</h3><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="potential-users" id="potential-users" shape="rect"/>1.3.1 Potential Users of ITS</h4><p>The ITS specification aims to provide different types of users with information about
@@ -321,102 +322,102 @@
illustration, we will demonstrate how ITS can indicate that certain parts of content
should or should not be translated.</p><ul><li><p>A content author uses an attribute on a particular element to say that the text
in the element should not be translated.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-ways-to-use-its-1" id="EX-ways-to-use-its-1" shape="rect"/>Example 3: Use of ITS by content author</div><p>The <code>its:translate="no"</code> attributes indicate that the <code>path</code> and
- the <code>cmd</code> elements should not be translated.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><help</strong> <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><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><head></strong>
- <strong class="hl-tag" style="color: #000096"><title></strong>Building the Zebulon Toolkit<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>To re-compile all the modules of the Zebulon toolkit you need to go in the <strong class="hl-tag" style="color: #000096"><path</strong>
- <span class="hl-attribute" style="color: #F5844C">its:translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">></strong>\Zebulon\Current Source\binary<strong class="hl-tag" style="color: #000096"></path></strong> directory. Then from there, run
- batch file <strong class="hl-tag" style="color: #000096"><cmd</strong> <span class="hl-attribute" style="color: #F5844C">its:translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">></strong>Build.bat<strong class="hl-tag" style="color: #000096"></cmd></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"></help></strong>
+ the <code>cmd</code> elements should not be translated.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><help</strong> <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><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><head></strong>
+ <strong class="hl-tag" style="color: #000096"><title></strong>Building the Zebulon Toolkit<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>To re-compile all the modules of the Zebulon toolkit you need to go in the <strong class="hl-tag" style="color: #000096"><path</strong>
+ <span class="hl-attribute" style="color: #F5844C">its:translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">></strong>\Zebulon\Current Source\binary<strong class="hl-tag" style="color: #000096"></path></strong> directory. Then from there, run
+ batch file <strong class="hl-tag" style="color: #000096"><cmd</strong> <span class="hl-attribute" style="color: #F5844C">its:translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">></strong>Build.bat<strong class="hl-tag" style="color: #000096"></cmd></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"></help></strong>
</pre></div><p>[Source file: <a href="examples/xml/EX-ways-to-use-its-1.xml" shape="rect">examples/xml/EX-ways-to-use-its-1.xml</a>]</p></div><ul><li><p>A content author or information architect uses markup at the top of the document
to identify a particular type of element or context in which the content should
not be translated.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d0e481" id="d0e481" shape="rect"/>Example 4: Use of ITS by information architect</div><p>The <code>translateRule</code> element is used in the header of the document to
indicate that none of the <code>path</code> or <code>cmd</code> elements should be
- translated.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><help</strong> <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><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><head></strong>
- <strong class="hl-tag" style="color: #000096"><title></strong>Building the Zebulon Toolkit<strong class="hl-tag" style="color: #000096"></title></strong>
- <strong class="hl-tag" style="color: #000096"><its:rules</strong> <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">version</span>=<span class="hl-value" style="color: #993300">"2.0"</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">selector</span>=<span class="hl-value" style="color: #993300">"//path | //cmd"</span> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">/></strong>
- <strong class="hl-tag" style="color: #000096"></its:rules></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>To re-compile all the modules of the Zebulon toolkit you need to go in the
- <strong class="hl-tag" style="color: #000096"><path></strong>\Zebulon\Current Source\binary<strong class="hl-tag" style="color: #000096"></path></strong> directory. Then from there, run batch file
- <strong class="hl-tag" style="color: #000096"><cmd></strong>Build.bat<strong class="hl-tag" style="color: #000096"></cmd></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"></help></strong>
+ translated.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><help</strong> <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><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><head></strong>
+ <strong class="hl-tag" style="color: #000096"><title></strong>Building the Zebulon Toolkit<strong class="hl-tag" style="color: #000096"></title></strong>
+ <strong class="hl-tag" style="color: #000096"><its:rules</strong> <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">version</span>=<span class="hl-value" style="color: #993300">"2.0"</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">selector</span>=<span class="hl-value" style="color: #993300">"//path | //cmd"</span> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"></its:rules></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>To re-compile all the modules of the Zebulon toolkit you need to go in the
+ <strong class="hl-tag" style="color: #000096"><path></strong>\Zebulon\Current Source\binary<strong class="hl-tag" style="color: #000096"></path></strong> directory. Then from there, run batch file
+ <strong class="hl-tag" style="color: #000096"><cmd></strong>Build.bat<strong class="hl-tag" style="color: #000096"></cmd></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"></help></strong>
</pre></div><p>[Source file: <a href="examples/xml/EX-ways-to-use-its-2.xml" shape="rect">examples/xml/EX-ways-to-use-its-2.xml</a>]</p></div><ul><li><p>A processor may insert markup at the top of the document which links to ITS
information outside of the document.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d0e506" id="d0e506" shape="rect"/>Example 5: Use of ITS by processor</div><p>A <code>rules</code> element is inserted in the header of the document. It has a XLink
- <code>href</code> attribute used to link to an <a href="#link-external-rules" shape="rect">ITS external rule</a> document.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><help</strong> <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><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><head></strong>
- <strong class="hl-tag" style="color: #000096"><title></strong>Building the Zebulon Toolkit<strong class="hl-tag" style="color: #000096"></title></strong>
- <strong class="hl-tag" style="color: #000096"><its:rules</strong> <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">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span>
- <span class="hl-attribute" style="color: #F5844C">xmlns:xlink</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/1999/xlink"</span> <span class="hl-attribute" style="color: #F5844C">xlink:href</span>=<span class="hl-value" style="color: #993300">"EX-ways-to-use-its-4.xml"</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"><body></strong>
- <strong class="hl-tag" style="color: #000096"><p></strong>To re-compile all the modules of the Zebulon toolkit you need to go in the
- <strong class="hl-tag" style="color: #000096"><path></strong>\Zebulon\Current Source\binary<strong class="hl-tag" style="color: #000096"></path></strong> directory. Then from there, run batch file
- <strong class="hl-tag" style="color: #000096"><cmd></strong>Build.bat<strong class="hl-tag" style="color: #000096"></cmd></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"></help></strong>
+ <code>href</code> attribute used to link to an <a href="#link-external-rules" shape="rect">ITS external rule</a> document.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><help</strong> <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><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><head></strong>
+ <strong class="hl-tag" style="color: #000096"><title></strong>Building the Zebulon Toolkit<strong class="hl-tag" style="color: #000096"></title></strong>
+ <strong class="hl-tag" style="color: #000096"><its:rules</strong> <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">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span>
+ <span class="hl-attribute" style="color: #F5844C">xmlns:xlink</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/1999/xlink"</span> <span class="hl-attribute" style="color: #F5844C">xlink:href</span>=<span class="hl-value" style="color: #993300">"EX-ways-to-use-its-4.xml"</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"><body></strong>
+ <strong class="hl-tag" style="color: #000096"><p></strong>To re-compile all the modules of the Zebulon toolkit you need to go in the
+ <strong class="hl-tag" style="color: #000096"><path></strong>\Zebulon\Current Source\binary<strong class="hl-tag" style="color: #000096"></path></strong> directory. Then from there, run batch file
+ <strong class="hl-tag" style="color: #000096"><cmd></strong>Build.bat<strong class="hl-tag" style="color: #000096"></cmd></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"></help></strong>
</pre></div><p>[Source file: <a href="examples/xml/EX-ways-to-use-its-3.xml" shape="rect">examples/xml/EX-ways-to-use-its-3.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d0e527" id="d0e527" shape="rect"/>Example 6: ITS rule file shared by different documents</div><p>The <code>rules</code> element contains several ITS rules that are common to different
documents. One of them is a <code>translateRule</code> element that indicates that no
- <code>path</code> or <code>cmd</code> element should 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">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">version</span>=<span class="hl-value" style="color: #993300">"2.0"</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">selector</span>=<span class="hl-value" style="color: #993300">"//path | //cmd"</span> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">/></strong>
-<strong class="hl-tag" style="color: #000096"></its:rules></strong>
+ <code>path</code> or <code>cmd</code> element should 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">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">version</span>=<span class="hl-value" style="color: #993300">"2.0"</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">selector</span>=<span class="hl-value" style="color: #993300">"//path | //cmd"</span> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">/></strong>
+<strong class="hl-tag" style="color: #000096"></its:rules></strong>
</pre></div><p>[Source file: <a href="examples/xml/EX-ways-to-use-its-4.xml" shape="rect">examples/xml/EX-ways-to-use-its-4.xml</a>]</p></div><ul><li><p>A schema developer integrates ITS markup declarations in his schema to allow
users to indicate that specific parts of the content should not be translated.</p></li></ul><span class="editor-note">[Ed. note: Following schema example has to updated once we have final XSD schema
for ITS 2.0]</span><div class="exampleOuter"><div class="exampleHeader"><a name="d0e558" id="d0e558" shape="rect"/>Example 7: An XSD schema with ITS declaration</div><p>The declarations for the <code>translate</code> attribute is added to a
- group of common attributes <code>commonAtts</code>. This allows to use the <code>translate</code> attribute within the documents like in <a href="#EX-ways-to-use-its-1" shape="rect">Example 3</a>.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><xs:schema</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:xs</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2001/XMLSchema"</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">elementFormDefault</span>=<span class="hl-value" style="color: #993300">"qualified"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><xs:import</strong> <span class="hl-attribute" style="color: #F5844C">namespace</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">schemaLocation</span>=<span class="hl-value" style="color: #993300">"its.xsd"</span><strong class="hl-tag" style="color: #000096">/></strong>
- <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"its:att.local.with-ns.attribute.translate"</span><strong class="hl-tag" style="color: #000096">/></strong>
- <strong class="hl-tag" style="color: #000096"><xs:attribute</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"id"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"xs:ID"</span> <span class="hl-attribute" style="color: #F5844C">use</span>=<span class="hl-value" style="color: #993300">"optional"</span><strong class="hl-tag" style="color: #000096">/></strong>
- <strong class="hl-tag" style="color: #000096"></xs:attributeGroup></strong>
- <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"help"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><xs:complexType></strong>
- <strong class="hl-tag" style="color: #000096"><xs:sequence></strong>
- <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"head"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><xs:complexType></strong>
- <strong class="hl-tag" style="color: #000096"><xs:sequence></strong>
- <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"title"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"xs:string"</span><strong class="hl-tag" style="color: #000096">/></strong>
- <strong class="hl-tag" style="color: #000096"></xs:sequence></strong>
- <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">/></strong>
- <strong class="hl-tag" style="color: #000096"></xs:complexType></strong>
- <strong class="hl-tag" style="color: #000096"></xs:element></strong>
- <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"body"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><xs:complexType></strong>
- <strong class="hl-tag" style="color: #000096"><xs:choice</strong> <span class="hl-attribute" style="color: #F5844C">minOccurs</span>=<span class="hl-value" style="color: #993300">"1"</span> <span class="hl-attribute" style="color: #F5844C">maxOccurs</span>=<span class="hl-value" style="color: #993300">"unbounded"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"p"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><xs:complexType</strong> <span class="hl-attribute" style="color: #F5844C">mixed</span>=<span class="hl-value" style="color: #993300">"true"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><xs:choice</strong> <span class="hl-attribute" style="color: #F5844C">minOccurs</span>=<span class="hl-value" style="color: #993300">"0"</span> <span class="hl-attribute" style="color: #F5844C">maxOccurs</span>=<span class="hl-value" style="color: #993300">"unbounded"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"path"</span><strong class="hl-tag" style="color: #000096">/></strong>
- <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"cmd"</span><strong class="hl-tag" style="color: #000096">/></strong>
- <strong class="hl-tag" style="color: #000096"></xs:choice></strong>
- <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">/></strong>
- <strong class="hl-tag" style="color: #000096"></xs:complexType></strong>
- <strong class="hl-tag" style="color: #000096"></xs:element></strong>
- <strong class="hl-tag" style="color: #000096"></xs:choice></strong>
- <strong class="hl-tag" style="color: #000096"></xs:complexType></strong>
- <strong class="hl-tag" style="color: #000096"></xs:element></strong>
- <strong class="hl-tag" style="color: #000096"></xs:sequence></strong>
- <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"its:att.version.attribute.version"</span><strong class="hl-tag" style="color: #000096">/></strong>
- <strong class="hl-tag" style="color: #000096"></xs:complexType></strong>
- <strong class="hl-tag" style="color: #000096"></xs:element></strong>
- <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"path"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><xs:complexType</strong> <span class="hl-attribute" style="color: #F5844C">mixed</span>=<span class="hl-value" style="color: #993300">"true"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">/></strong>
- <strong class="hl-tag" style="color: #000096"></xs:complexType></strong>
- <strong class="hl-tag" style="color: #000096"></xs:element></strong>
- <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"cmd"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><xs:complexType</strong> <span class="hl-attribute" style="color: #F5844C">mixed</span>=<span class="hl-value" style="color: #993300">"true"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">/></strong>
- <strong class="hl-tag" style="color: #000096"></xs:complexType></strong>
- <strong class="hl-tag" style="color: #000096"></xs:element></strong>
+ group of common attributes <code>commonAtts</code>. This allows to use the <code>translate</code> attribute within the documents like in <a href="#EX-ways-to-use-its-1" shape="rect">Example 3</a>.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><xs:schema</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:xs</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2001/XMLSchema"</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">elementFormDefault</span>=<span class="hl-value" style="color: #993300">"qualified"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:import</strong> <span class="hl-attribute" style="color: #F5844C">namespace</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">schemaLocation</span>=<span class="hl-value" style="color: #993300">"its.xsd"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"its:att.local.with-ns.attribute.translate"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:attribute</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"id"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"xs:ID"</span> <span class="hl-attribute" style="color: #F5844C">use</span>=<span class="hl-value" style="color: #993300">"optional"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"></xs:attributeGroup></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"help"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:complexType></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:sequence></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"head"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:complexType></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:sequence></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"title"</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"xs:string"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"></xs:sequence></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"></xs:complexType></strong>
+ <strong class="hl-tag" style="color: #000096"></xs:element></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"body"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:complexType></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:choice</strong> <span class="hl-attribute" style="color: #F5844C">minOccurs</span>=<span class="hl-value" style="color: #993300">"1"</span> <span class="hl-attribute" style="color: #F5844C">maxOccurs</span>=<span class="hl-value" style="color: #993300">"unbounded"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"p"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:complexType</strong> <span class="hl-attribute" style="color: #F5844C">mixed</span>=<span class="hl-value" style="color: #993300">"true"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:choice</strong> <span class="hl-attribute" style="color: #F5844C">minOccurs</span>=<span class="hl-value" style="color: #993300">"0"</span> <span class="hl-attribute" style="color: #F5844C">maxOccurs</span>=<span class="hl-value" style="color: #993300">"unbounded"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"path"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"cmd"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"></xs:choice></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"></xs:complexType></strong>
+ <strong class="hl-tag" style="color: #000096"></xs:element></strong>
+ <strong class="hl-tag" style="color: #000096"></xs:choice></strong>
+ <strong class="hl-tag" style="color: #000096"></xs:complexType></strong>
+ <strong class="hl-tag" style="color: #000096"></xs:element></strong>
+ <strong class="hl-tag" style="color: #000096"></xs:sequence></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"its:att.version.attribute.version"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"></xs:complexType></strong>
+ <strong class="hl-tag" style="color: #000096"></xs:element></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"path"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:complexType</strong> <span class="hl-attribute" style="color: #F5844C">mixed</span>=<span class="hl-value" style="color: #993300">"true"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"></xs:complexType></strong>
+ <strong class="hl-tag" style="color: #000096"></xs:element></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:element</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"cmd"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:complexType</strong> <span class="hl-attribute" style="color: #F5844C">mixed</span>=<span class="hl-value" style="color: #993300">"true"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><xs:attributeGroup</strong> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"commonAtts"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"></xs:complexType></strong>
+ <strong class="hl-tag" style="color: #000096"></xs:element></strong>
<strong class="hl-tag" style="color: #000096"></xs:schema></strong></pre></div><p>[Source file: <a href="examples/xml/EX-ways-to-use-its-5.xsd" shape="rect">examples/xml/EX-ways-to-use-its-5.xsd</a>]</p></div><p>The first two approaches above can be likened to the use of CSS in <a title="XHTML™ 1.0 The Extensible
 HyperText Markup Language (Second Edition)" href="#xhtml10" shape="rect">[XHTML 1.0]</a>. Using a <code>style</code> attribute, an XHTML
content author may assign a color to a particular paragraph. That author could also
have used the <code>style</code> element at the top of the page to say that all paragraphs
@@ -428,21 +429,21 @@
approach</a>” in HTML5, this specification defines a link type for referring to files
with global rules in <a class="section-ref" href="#html5-external-global-rules" shape="rect">Section 7.2: External Rules</a>.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translate-html5-global-1" id="EX-translate-html5-global-1" shape="rect"/>Example 8: Using ITS global rules in HTML5</div><p>The <code>link</code> element points to the rules file
<code>EX-translateRule-html5-1.xml</code> The <code>rel</code> attribute identifies
- the ITS specific link relation <code>its-rules</code>.</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>
- <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>Translate flag global rules example<strong class="hl-tag" style="color: #000096"></title></strong>
- <strong class="hl-tag" style="color: #000096"><link</strong> <span class="hl-attribute" style="color: #F5844C">href</span>=<span class="hl-value" style="color: #993300">EX-translateRule-html5-1.xml</span> <span class="hl-attribute" style="color: #F5844C">rel</span>=<span class="hl-value" style="color: #993300">its-rules</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"><body></strong>
- <strong class="hl-tag" style="color: #000096"><p></strong>This sentence should be translated, but code names like the <strong class="hl-tag" style="color: #000096"><code></strong>span<strong class="hl-tag" style="color: #000096"></code></strong> element should not be translated.<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-translate-html5-global-1.html" shape="rect">examples/html5/EX-translate-html5-global-1.html</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translate-html5-global-1-rules-file" id="EX-translate-html5-global-1-rules-file" shape="rect"/>Example 9: ITS rules file linked from HTML5</div><p>The rules file linked in <a href="#EX-translate-html5-global-1" shape="rect">Example 8</a>.</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>
- <span class="hl-attribute" style="color: #F5844C">xmlns:h</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/1999/xhtml"</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">"//h:code"</span><strong class="hl-tag" style="color: #000096">/></strong>
-<strong class="hl-tag" style="color: #000096"></its:rules></strong>
+ the ITS specific link relation <code>its-rules</code>.</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>
+ <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>Translate flag global rules example<strong class="hl-tag" style="color: #000096"></title></strong>
+ <strong class="hl-tag" style="color: #000096"><link</strong> <span class="hl-attribute" style="color: #F5844C">href</span>=<span class="hl-value" style="color: #993300">EX-translateRule-html5-1.xml</span> <span class="hl-attribute" style="color: #F5844C">rel</span>=<span class="hl-value" style="color: #993300">its-rules</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"><body></strong>
+ <strong class="hl-tag" style="color: #000096"><p></strong>This sentence should be translated, but code names like the <strong class="hl-tag" style="color: #000096"><code></strong>span<strong class="hl-tag" style="color: #000096"></code></strong> element should not be translated.<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-translate-html5-global-1.html" shape="rect">examples/html5/EX-translate-html5-global-1.html</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translate-html5-global-1-rules-file" id="EX-translate-html5-global-1-rules-file" shape="rect"/>Example 9: ITS rules file linked from HTML5</div><p>The rules file linked in <a href="#EX-translate-html5-global-1" shape="rect">Example 8</a>.</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>
+ <span class="hl-attribute" style="color: #F5844C">xmlns:h</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/1999/xhtml"</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">"//h:code"</span><strong class="hl-tag" style="color: #000096">/></strong>
+<strong class="hl-tag" style="color: #000096"></its:rules></strong>
</pre></div><p>[Source file: <a href="examples/html5/EX-translateRule-html5-1.xml" shape="rect">examples/html5/EX-translateRule-html5-1.xml</a>]</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="usage-in-legacy-html" id="usage-in-legacy-html" shape="rect"/>1.4.1 Support for legacy HTML content</h4><p>ITS 2.0 does not define how to use ITS in HTML versions prior version 5. Users are
encouraged to migrate their content to HTML5 or XHTML. While it is possible to use
@@ -517,23 +518,23 @@
author may use the ITS <code>translate</code> attribute to indicate that
all content inside the <code>author</code> element should be protected from translation.
Translation tools that are aware of the meaning of this attribute can then screen the
- relevant content from the translation process.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-basic-concepts-1" id="EX-basic-concepts-1" shape="rect"/>Example 10: ITS markup on elements in an XML document (local approach) </div><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>
- <strong class="hl-tag" style="color: #000096"><title></strong>An example article<strong class="hl-tag" style="color: #000096"></title></strong>
- <strong class="hl-tag" style="color: #000096"><author</strong> <span class="hl-attribute" style="color: #F5844C">its:translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><personname></strong>
- <strong class="hl-tag" style="color: #000096"><firstname></strong>John<strong class="hl-tag" style="color: #000096"></firstname></strong>
- <strong class="hl-tag" style="color: #000096"><surname></strong>Doe<strong class="hl-tag" style="color: #000096"></surname></strong>
- <strong class="hl-tag" style="color: #000096"></personname></strong>
- <strong class="hl-tag" style="color: #000096"><affiliation></strong>
- <strong class="hl-tag" style="color: #000096"><address></strong><strong class="hl-tag" style="color: #000096"><email></strong>foo@example.com<strong class="hl-tag" style="color: #000096"></email></strong><strong class="hl-tag" style="color: #000096"></address></strong>
- <strong class="hl-tag" style="color: #000096"></affiliation></strong>
- <strong class="hl-tag" style="color: #000096"></author></strong>
- <strong class="hl-tag" style="color: #000096"></info></strong>
- <strong class="hl-tag" style="color: #000096"><para></strong>This is a short article.<strong class="hl-tag" style="color: #000096"></para></strong>
-<strong class="hl-tag" style="color: #000096"></article></strong>
+ relevant content from the translation process.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-basic-concepts-1" id="EX-basic-concepts-1" shape="rect"/>Example 10: ITS markup on elements in an XML document (local approach) </div><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>
+ <strong class="hl-tag" style="color: #000096"><title></strong>An example article<strong class="hl-tag" style="color: #000096"></title></strong>
+ <strong class="hl-tag" style="color: #000096"><author</strong> <span class="hl-attribute" style="color: #F5844C">its:translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><personname></strong>
+ <strong class="hl-tag" style="color: #000096"><firstname></strong>John<strong class="hl-tag" style="color: #000096"></firstname></strong>
+ <strong class="hl-tag" style="color: #000096"><surname></strong>Doe<strong class="hl-tag" style="color: #000096"></surname></strong>
+ <strong class="hl-tag" style="color: #000096"></personname></strong>
+ <strong class="hl-tag" style="color: #000096"><affiliation></strong>
+ <strong class="hl-tag" style="color: #000096"><address></strong><strong class="hl-tag" style="color: #000096"><email></strong>foo@example.com<strong class="hl-tag" style="color: #000096"></email></strong><strong class="hl-tag" style="color: #000096"></address></strong>
+ <strong class="hl-tag" style="color: #000096"></affiliation></strong>
+ <strong class="hl-tag" style="color: #000096"></author></strong>
+ <strong class="hl-tag" style="color: #000096"></info></strong>
+ <strong class="hl-tag" style="color: #000096"><para></strong>This is a short article.<strong class="hl-tag" style="color: #000096"></para></strong>
+<strong class="hl-tag" style="color: #000096"></article></strong>
</pre></div><p>[Source file: <a href="examples/xml/EX-basic-concepts-1.xml" shape="rect">examples/xml/EX-basic-concepts-1.xml</a>]</p></div><p>For this example to work, the schema developer will need to add the <code>translate</code> attribute to the schema as a common attribute or on all the
relevant element definitions. Note how there is an expectation in this case that
inheritance plays a part in identifying which content does have to be translated and
@@ -557,19 +558,19 @@
is the following: <code>match</code> attributes may only contain a restriction/subset
of XPath expressions, so-called <a href="http://www.w3.org/TR/xslt#patterns" shape="rect">patterns</a>.</p><p>Basically the following restrictions hold for patterns: </p><ul><li><p>only axes "child" or "attribute" allowed</p></li><li><p>"//" or "/" possible</p></li><li><p>id() or key() function possible</p></li><li><p>predicates possible</p></li></ul><p>Using only XSLT patterns in ITS <code>selector</code> attributes helps to avoid this
issue. In many cases, this is possible by using patterns with predicates. The value
- above may for example be rewritten as follows:</p><p>*[self::myElement]/@* | myElement//*/@*</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-basic-concepts-2" id="EX-basic-concepts-2" shape="rect"/>Example 11: ITS global markup in an XML document (rule-based approach) </div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><myTopic</strong> <span class="hl-attribute" style="color: #F5844C">xmlns</span>=<span class="hl-value" style="color: #993300">"http://mynsuri.example.com"</span> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"topic01"</span> <span class="hl-attribute" style="color: #F5844C">xml:lang</span>=<span class="hl-value" style="color: #993300">"en-us"</span><strong class="hl-tag" style="color: #000096">></strong>
- <strong class="hl-tag" style="color: #000096"><prolog></strong>
- <strong class="hl-tag" style="color: #000096"><title></strong>Using ITS<strong class="hl-tag" style="color: #000096"></title></strong>
- <strong class="hl-tag" style="color: #000096"><its:rules</strong> <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">version</span>=<span class="hl-value" style="color: #993300">"2.0"</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">selector</span>=<span class="hl-value" style="color: #993300">"//n:term"</span> <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">xmlns:n</span>=<span class="hl-value" style="color: #993300">"http://mynsuri.example.com"</span><strong class="hl-tag" style="color: #000096">/></strong>
- <strong class="hl-tag" style="color: #000096"></its:rules></strong>
- <strong class="hl-tag" style="color: #000096"></prolog></strong>
- <strong class="hl-tag" style="color: #000096"><body></strong>
- <strong class="hl-tag" style="color: #000096"><p></strong>ITS defines <strong class="hl-tag" style="color: #000096"><term></strong>data category<strong class="hl-tag" style="color: #000096"></term></strong> as an abstract concept for a particular type of
- information for internationalization and localization of XML schemas and documents.<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"></myTopic></strong>
-
+ above may for example be rewritten as follows:</p><p>*[self::myElement]/@* | myElement//*/@*</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-basic-concepts-2" id="EX-basic-concepts-2" shape="rect"/>Example 11: ITS global markup in an XML document (rule-based approach) </div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><myTopic</strong> <span class="hl-attribute" style="color: #F5844C">xmlns</span>=<span class="hl-value" style="color: #993300">"http://mynsuri.example.com"</span> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"topic01"</span> <span class="hl-attribute" style="color: #F5844C">xml:lang</span>=<span class="hl-value" style="color: #993300">"en-us"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><prolog></strong>
+ <strong class="hl-tag" style="color: #000096"><title></strong>Using ITS<strong class="hl-tag" style="color: #000096"></title></strong>
+ <strong class="hl-tag" style="color: #000096"><its:rules</strong> <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">version</span>=<span class="hl-value" style="color: #993300">"2.0"</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">selector</span>=<span class="hl-value" style="color: #993300">"//n:term"</span> <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">xmlns:n</span>=<span class="hl-value" style="color: #993300">"http://mynsuri.example.com"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"></its:rules></strong>
+ <strong class="hl-tag" style="color: #000096"></prolog></strong>
+ <strong class="hl-tag" style="color: #000096"><body></strong>
+ <strong class="hl-tag" style="color: #000096"><p></strong>ITS defines <strong class="hl-tag" style="color: #000096"><term></strong>data category<strong class="hl-tag" style="color: #000096"></term></strong> as an abstract concept for a particular type of
+ information for internationalization and localization of XML schemas and documents.<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"></myTopic></strong>
+
</pre></div><p>[Source file: <a href="examples/xml/EX-basic-concepts-2.xml" shape="rect">examples/xml/EX-basic-concepts-2.xml</a>]</p></div><p>For this approach to work, the schema developer needs to add the <code>rules</code>
element and associated markup to the schema. In some cases global rules may be
sufficient to allow the schema developer to avoid adding other ITS markup (such as an
@@ -598,25 +599,25 @@
that the global rule is processed first, regardless of its position inside the document.
In the main body of the document, the default applies, and here it is
<code>its:translate="no"</code> that is used to set “faux pas” as
- non-translatable.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-basic-concepts-3" id="EX-basic-concepts-3" shape="rect"/>Example 12: Overriding and Inheritance</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><text</strong> <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>
[2718 lines skipped]
--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2012/11/21 17:54:57 1.253
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2012/11/23 16:07:01 1.254
@@ -1775,7 +1775,7 @@
<p>The value of <att>toolsRef</att> is a space-separated list of references where each reference is composed of two parts: a data category identifier and an IRI. These two parts are separated by a character <code>|</code> VERTICAL LINE (U+007C).</p>
<list>
- <item><p>The data category identifier <ref target="#rfc2119">MUST</ref> be the data category identifiers defined in this specification.</p></item>
+ <item><p>The data category identifier <ref target="#rfc2119">MUST</ref> be one of the following identifiers: <code>allowed-characters</code>, <code>directionality</code>, <code>disambiguation</code>, <code>domain</code>, <code>elements-within-text</code>, <code>external-resource</code>, <code>id-value</code>, <code>language-information</code>, <code>locale-filter</code>, <code>localization-note</code>, <code>lq-issues</code>, <code>lq-precis</code>, <code>mt-confidence</code>, <code>provenance</code>, <code>ruby</code>, <code>storage-size</code>, <code>target-pointer</code>, <code>terminology</code>, <code>translate</code>.</p></item>
<item><p>The IRI indicates information about the processor used to generate the data category annotation. No single means is specified for how this IRI should be used to indicate processor information. Possible mechanisms are: to encode information directly in the IRI, e.g. as parameters; to reference an external resource that provides such information, e.g. an XML file or an RDF declaration; or to reference another part of the document that provides such information.</p></item>
</list>
@@ -3362,7 +3362,7 @@
<head>Definition</head>
<p>The <ref target="#provenance">Provenance</ref> data category is used to communicate
the identity of agents that have been involved in the translation of the content or
- the revision of the translated contend. This allows translation and translation
+ the revision of the translated content. This allows translation and translation
revision consumers, such as post-editors, translation quality reviewers or
localization workflow managers, to assess how the performance of these agents may
impact the quality of the translation. Translation and translation revision agents can
@@ -3374,11 +3374,62 @@
translation processes (e.g. multiple revision cycles) or requires agents that support
a wider range of activities, the data category offers a mechanism to refer to
external provenance data.</p>
- <note><p>The specification does not define the format of external provenance data, but it is recommended that an open provenance or or change logging format be used, e.g. the W3C provenance data model <ptr target="#prov-dm" type="bibref"/>.</p></note>
+ <note><p>The specification does not define the format of external provenance data, but it is recommended that an open provenance or change logging format be used, e.g. the W3C provenance data model <ptr target="#prov-dm" type="bibref"/>.</p></note>
<p>Translation or translation revision tools, such as machine translation agents or CAT
tools, may offer an easy way to create this information. Translation tools can then
present this information to post-editors or translation workflow managers. Web
applications may to present such information to consumers of translated documents.</p>
+ <p>The data category defines seven pieces of information:</p>
+ <table border="1" xml:id="provenanceDefs">
+ <row role="head">
+ <cell>Information</cell>
+ <cell>Description</cell>
+ <cell>Value</cell>
+ <cell>Notes</cell>
+ </row>
+ <row>
+ <cell>Human provenance information</cell>
+ <cell>Identification of a human translation agent</cell>
+ <cell>A string or an IRI (only for the <code>Ref</code> attributes)</cell>
+ <cell></cell>
+ </row>
+ <row>
+ <cell>Organisational provenance information</cell>
+ <cell>Identification of an organization acting as a translation agent</cell>
+ <cell>A string or an IRI (only for the <code>Ref</code> attributes)</cell>
+ <cell></cell>
+ </row>
+ <row>
+ <cell>Tool related provenance information</cell>
+ <cell>Identification of a software tool that was used in translating the selected content</cell>
+ <cell>A string or an IRI (only for the <code>Ref</code> attributes)</cell>
+ <cell></cell>
+ </row>
+ <row>
+ <cell>Human revision provenance information</cell>
+ <cell>Identification of a human translation revision agent</cell>
+ <cell>A string or an IRI (only for the <code>Ref</code> attributes)</cell>
+ <cell></cell>
+ </row>
+ <row>
+ <cell>Organisational revision provenance information</cell>
+ <cell>Identification of an organization acting as a translation revision agent</cell>
+ <cell>A string or an IRI (only for the <code>Ref</code> attributes)</cell>
+ <cell></cell>
+ </row>
+ <row>
+ <cell>Tool related revision provenance information</cell>
+ <cell>Identification of a software tool that was used in revising the translation of the selected content</cell>
+ <cell>A string or an IRI (only for the <code>Ref</code> attributes)</cell>
+ <cell></cell>
+ </row>
+ <row>
+ <cell>Reference to external provenance descriptions</cell>
+ <cell>A reference to external provenance descriptions</cell>
+ <cell>An IRI</cell>
+ <cell></cell>
+ </row>
+ </table>
</div>
<div xml:id="provenance-implementation">
<head>Implementation</head>
@@ -3398,62 +3449,15 @@
contains a <ref target="#selectors">relative selector</ref> pointing to a
node containing a list of <ref target="#elem-provenanceRecords">provenance records</ref>. These are related to the content selected via the <att>selector</att> attribute.</p>
</item>
- <item><p>Human provenance information specified by exactly one of the
- following:</p>
- <list type="unordered">
- <item><p>A <att>personPointer</att> attribute that contains a <ref
- target="#selectors">relative selector</ref> pointing to a node that contains a string identifying a human translation agent.</p></item>
- <item><p>A <att>personRefPointer</att> attribute that contains a <ref
- target="#selectors">relative selector</ref> pointing to a node that contains an IRI referring to a resource that identifies a human translation agent.</p></item>
- </list></item>
- <item><p>Organizational provenance information specified by exactly of
- the following:</p>
- <list type="unordered">
- <item><p>A <att>orgPointer</att> attribute that contains a <ref
- target="#selectors">relative selector</ref> pointing to a node that contains a string identifying an organization acting as a translation agent.</p></item>
- <item><p>A <att>orgRefPointer</att> attribute that contains a <ref
- target="#selectors">relative selector</ref> pointing to a node that contains an IRI referring to a resource that identifies an organization acting as a translation agent.</p></item>
- </list></item>
- <item><p>Tool provenance related information specified by exactly one
- of the following:</p>
- <list type="unordered">
- <item><p>A <att>toolPointer</att> attribute that contains a <ref
- target="#selectors">relative selector</ref> pointing to a node that contains a string identifying a software tool that was used in translating the selected content.</p></item>
- <item><p>A <att>toolRefPointer</att> attribute that contains a <ref
- target="#selectors">relative selector</ref> pointing to a node that contains an IRI referring to a resource that identifies a software tool that was used in the translation.</p></item>
- </list></item>
- <item><p>Human revision provenance related information specified by
- exactly one of the following:</p>
- <list type="unordered">
- <item><p>A <att>revPersonPointer</att> attribute that contains a <ref
- target="#selectors">relative selector</ref> pointing to a node that contains a string identifying a human translation revision agent.</p></item>
- <item><p>A <att>revPersonRefPointer</att> attribute pointing to a node that contains an IRI referring to a resource that identifies a human translation revision agent.</p></item>
- </list></item>
- <item><p>Organizational revision translation related provenance information
- specified by exactly of the following:</p>
- <list type="unordered">
- <item><p>A <att>revOrgPointer</att> attribute that contains a <ref
- target="#selectors">relative selector</ref> pointing to a node contains a string identifying an organization acting as a translation revision agent.</p></item>
- <item><p>A <att>revOrgRefPointer</att> attribute that contains a <ref
- target="#selectors">relative selector</ref> pointing to a node that contains an IRI referring to a resource that identifies an organization acting as a translation revison agent.</p></item>
-
- </list></item>
- <item><p>Tool revision provenance related information specified by
- exactly one of the following:</p>
- <list type="unordered">
- <item><p>A <att>revToolPointer</att> attribute that contains a <ref
- target="#selectors">relative selector</ref> pointing to a node that contains a string identifying a software tool that was used in revising the translation of the selected content.</p></item>
- <item><p>A <att>revToolRefPointer</att> attribute that contains a <ref
- target="#selectors">relative selector</ref> pointing to a node that contains an IRI referring to a resource that identifies a software tool that was used in revising the translation of the selected content.</p></item>
- </list></item>
- <item><p>A reference to external, RDF-based provenance description specified by a <att>provRefPointer</att> attribute that contains a <ref
- target="#selectors">relative selector</ref> pointing to a node that contains one or more space (U+0020) separated Provenance URIs, each referring to a resource that identifies a different provenance entity record.</p></item>
+ <item><p>A <att>personPointer</att> or <att>personRefPointer</att> attribute that implement the <ref target="#provenanceDefs">human provenance information</ref>.</p></item>
+ <item><p>An <att>orgPointer</att> or <att>orgRefPointer</att> attribute that implement the <ref target="#provenanceDefs">organisational provenance information</ref>.</p></item>
+ <item><p>A <att>toolPointer</att> or <att>toolRefPointer</att> attribute that implement the <ref target="#provenanceDefs">tool related provenance information</ref>.</p></item>
+ <item><p>A <att>revPersonPointer</att> or <att>revPersonRefPointer</att> attribute that implement the <ref target="#provenanceDefs">human revision provenance information</ref>.</p></item>
+ <item><p>A <att>revOrgPointer</att> or <att>revOrgRefPointer</att> attribute that implement the <ref target="#provenanceDefs">organisational revision provenance information</ref>.</p></item>
+ <item><p>A <att>revToolPointer</att> or <att>revToolRefPointer</att> attribute that implement the <ref target="#provenanceDefs">tool related revision provenance information</ref>.</p></item>
+ <item><p>A <att>provRefPointer</att> attribute that implements the <ref target="#provenanceDefs">reference to external provenance descriptions</ref>.</p></item>
</list></item>
</list>
- <note type="ed">Below note is taken from the quality issue data category. Same question
- applies: Why should below only say "do not apply to HMTL as local markup"? There is
- local markup for direct annotation in XML too.</note>
- <note>
<p>The attributes <att>provenanceRecordsRefPointer</att>,
<att>personPointer</att>, <att>personRefPointer</att>,
<att>orgPointer</att>, <att>orgRefPointer</att>,
@@ -3463,7 +3467,6 @@
<att>revToolPointer</att>, <att>revToolRefPointer</att> and
<att>provRefPointer</att> do not apply to HTML as local markup is provided for
direct annotation in HTML.</p>
- </note>
<exemplum xml:id="EX-provenance-global-3">
<head>The <ref target="#provenance">Provenance</ref> data category used globally with standoff provenance
records.</head>
@@ -3490,60 +3493,33 @@
target="#provenance">Provenance</ref> data
category:</p>
<list type="unordered">
- <item><p>Either (inline markup): at least one of the following, with the same
- semantics as the corresponding attributes at the <gi>provRule</gi> element:</p>
+ <item><p>Either (inline markup): at least one of the following attributes:</p>
<list type="unordered">
- <item><p>Human provenance information specified by exactly a
- <att>person</att> or a <att>personRef</att> attribute.</p></item>
- <item><p>Organizational translation provenance information specified by exactly a
- <att>org</att> or a <att>orgRef</att> attribute.</p></item>
-
- <item><p>Tool provenance related information specified by exactly a
- <att>tool</att> or a <att>toolRef</att> attribute.</p></item>
- <item><p>Human translation revision provenance related information specified by
- exactly a <att>revPerson</att> or a <att>revPersonRef</att>
- attribute.</p></item>
- <item><p>Organizational revision related provenance information
- specified by exactly a <att>revOrg</att> or a <att>revOrgRef</att>
- attribute.</p></item>
- <item><p>Tool revision provenance related information specified by
- exactly a <att>revTool</att> or a <att>revToolRef</att>
- attribute.</p></item>
- <item><p>A reference to external, RDF-based provenance description specified by a
- <att>provRef</att> attribute.</p></item>
+ <item><p>A <att>person</att> or <att>personRef</att> attribute that implement the <ref target="#provenanceDefs">human provenance information</ref>.</p></item>
+ <item><p>An <att>org</att> or <att>orgRef</att> attribute that implement the <ref target="#provenanceDefs">organisational provenance information</ref>.</p></item>
+ <item><p>A <att>tool</att> or <att>toolRef</att> attribute that implement the <ref target="#provenanceDefs">tool related provenance information</ref>.</p></item>
+ <item><p>A <att>revPerson</att> or <att>revPersonRef</att> attribute that implement the <ref target="#provenanceDefs">human revision provenance information</ref>.</p></item>
+ <item><p>A <att>revOrg</att> or <att>revOrgRef</att> attribute that implement the <ref target="#provenanceDefs">organisational revision provenance information</ref>.</p></item>
+ <item><p>A <att>revTool</att> or <att>revToolRef</att> attribute that implement the <ref target="#provenanceDefs">tool related revision provenance information</ref>.</p></item>
+ <item><p>A <att>provRef</att> attribute that implements the <ref target="#provenanceDefs">reference to external provenance descriptions</ref>.</p></item>
</list></item>
-
<item><p>Or (standoff markup):</p>
<list type="unordered">
<item><p>A <att>provenanceRecordsRef</att> attribute. Its value is a
IRI pointing to the <gi>provenanceRecords</gi> element containing
- the list of provenance information related to this content.</p></item>
+ the list of <ref target="#elem-provenanceRecords">provenance records</ref> related to this content.</p></item>
<item><p xml:id="elem-provenanceRecords">An element <gi>provenanceRecords</gi> which contains:</p>
<list type="unordered">
<item><p>One or more elements <gi>provenanceRecord</gi>, each
- of which contains at least one of the following, with the same semantics
- as the corresponding attributes at the <gi>provRule</gi> element:</p>
+ of which contains at least one of the following attributes:</p>
<list type="unordered">
- <item><p>Human provenance information specified by exactly a
- <att>person</att> or a <att>personRef</att>
- attribute.</p></item>
- <item><p>Organizational provenance information specified by
- exactly a <att>org</att> or a <att>orgRef</att>
- attribute.</p></item>
- <item><p>Tool provenance related information specified by
- exactly a <att>tool</att> or a <att>toolRef</att>
- attribute.</p></item>
- <item><p>Human revision provenance related information
- specified by exactly a <att>revPerson</att> or a
- <att>revPersonRef</att> attribute.</p></item>
- <item><p>Organizational revision related provenance
- information specified by exactly a <att>revOrg</att> or a
- <att>revOrgRef</att> attribute.</p></item>
- <item><p>Tool revision provenance related information
- specified by exactly a <att>revTool</att> or a
- <att>revToolRef</att> attribute.</p></item>
- <item><p>A reference to external, RDF-based provenance description
- specified by a <att>provRef</att> attribute.</p></item>
+ <item><p>A <att>person</att> or <att>personRef</att> attribute that implement the <ref target="#provenanceDefs">human provenance information</ref>.</p></item>
+ <item><p>An <att>org</att> or <att>orgRef</att> attribute that implement the <ref target="#provenanceDefs">organisational provenance information</ref>.</p></item>
+ <item><p>A <att>tool</att> or <att>toolRef</att> attribute that implement the <ref target="#provenanceDefs">tool related provenance information</ref>.</p></item>
+ <item><p>A <att>revPerson</att> or <att>revPersonRef</att> attribute that implement the <ref target="#provenanceDefs">human revision provenance information</ref>.</p></item>
+ <item><p>A <att>revOrg</att> or <att>revOrgRef</att> attribute that implement the <ref target="#provenanceDefs">organisational revision provenance information</ref>.</p></item>
+ <item><p>A <att>revTool</att> or <att>revToolRef</att> attribute that implement the <ref target="#provenanceDefs">tool related revision provenance information</ref>.</p></item>
+ <item><p>A <att>provRef</att> attribute that implements the <ref target="#provenanceDefs">reference to external provenance descriptions</ref>.</p></item>
</list>
</item>
</list>
@@ -3551,9 +3527,7 @@
</list>
</item>
</list>
- <p>Important:</p>
- <list>
- <item><p>When the attributes <att>person</att>, <att>personRef</att>,
+ <p>When the attributes <att>person</att>, <att>personRef</att>,
<att>org</att>, <att>orgRef</att>, <att>tool</att>,
<att>toolRef</att>, <att>revPerson</att>,
<att>revPersonRef</att>, <att>revOrg</att>, <att>revOrgRef</att>,
@@ -3561,9 +3535,9 @@
their equivalent representations) are used in a standoff manner, the
information they carry pertains to the content of the element that refers to the
standoff annotation, not to the content of the element <gi>provenanceRecord</gi> where they are
- declared.</p></item>
- </list>
-
+ declared.</p>
+ <p xml:id="provenance-records-in-html5-constraint">In HTML5 the standoff markup <ref target="#rfc-keywords">MUST</ref> be stored inside a <gi>script</gi> element with its <att>id</att> attribute that <ref target="#rfc-keywords">MUST</ref> be set to the same value as the <att>xml:id</att>
+ attribute of the <gi>provenanceRecords</gi> element it contains.</p>
<exemplum xml:id="EX-provenance-local-1">
<head>Annotating provenance information in XML with local inline markup</head>
<p>The provenance related attributes at the <code>par</code> and
@@ -3882,7 +3856,7 @@
subsequent process examines this markup to ensure that changes were
made.</p></item>
</list>
- <p>The data category defines four pieces of information:</p>
+ <p>The data category defines five pieces of information:</p>
<table border="1" xml:id="lqissueDefs">
<row role="head">
<cell>Information</cell>
@@ -3958,8 +3932,7 @@
<item><p>Exactly one of the following:</p>
<list type="unordered">
<item><p>A <att>locQualityIssuesRef</att> attribute. Its value is an IRI
- pointing to the <gi>locQualityIssues</gi> element containing the list of
- issues related to this content.</p></item>
+ pointing to the <gi>locQualityIssues</gi> element containing the <ref target="#elem-locQualityIssues">list of issues</ref> related to this content.</p></item>
<item><p>A <att>locQualityIssuesRefPointer</att> attribute that contains a
<ref target="#selectors">relative selector</ref> pointing to a node with
the exact same semantics as <att>locQualityIssuesRef</att>.</p></item>
@@ -4036,9 +4009,9 @@
<item><p>Or (standoff markup):</p>
<list type="unordered">
<item><p>A <att>locQualityIssuesRef</att> attribute. Its value is an IRI pointing
- to the <gi>locQualityIssues</gi> element containing the list of issues related
+ to the <gi>locQualityIssues</gi> element containing the <ref target="#elem-locQualityIssues">list of issues</ref> related
to this content.</p></item>
- <item><p>An element <gi>locQualityIssues</gi> with a <att>xml:id</att> attribute set to
+ <item><p xml:id="elem-locQualityIssues">An element <gi>locQualityIssues</gi> with a <att>xml:id</att> attribute set to
the identifier specified in the <att>locQualityIssuesRef</att> attribute.
The <gi>locQualityIssues</gi> element contains:</p>
<list type="unordered">
@@ -4067,15 +4040,15 @@
</list>
</item>
</list>
- <note><p>When the attributes <att>locQualityIssueType</att>,
+ <p>When the attributes <att>locQualityIssueType</att>,
<att>locQualityIssueComment</att>, <att>locQualityIssueSeverity</att>,
<att>locQualityIssueProfileRef</att> and <att>locQualityIssueEnabled</att> are used
in a standoff manner, the information they carry pertains to the content of the
element that refers to the standoff annotation, not to the content of the element
- <gi>locQualityIssue</gi> where they are declared.</p></note>
- <note><p>In HTML5 the standoff markup <ref target="#rfc-keywords">MUST</ref> be stored inside a <gi>script</gi> element with
+ <gi>locQualityIssue</gi> where they are declared.</p>
+ <p xml:id="loc-quality-issues-in-html5-constraint">In HTML5 the standoff markup <ref target="#rfc-keywords">MUST</ref> be stored inside a <gi>script</gi> element with
its <att>id</att> attribute that <ref target="#rfc-keywords">MUST</ref> be set to the same value as the <att>xml:id</att>
- attribute of the <gi>locQualityIssues</gi> element it contains.</p></note>
+ attribute of the <gi>locQualityIssues</gi> element it contains.</p>
</item>
</list>
<exemplum xml:id="EX-locQualityIssue-local-1">
@@ -4323,7 +4296,7 @@
target="examples/html5/EX-mtConfidence-global-html5-1.html"/>
</exemplum>
<p>Where the external ITS rules file is as shown:</p>
- <exemplum>
+ <exemplum xml:id="EX-mtconfidence-global-html5-1-external-rules">
<head>XML file with external rules references from an HTML5 file.</head>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/html5/EX-mtconfidence-global-html5-1-external-rules.xml"/>
@@ -4675,7 +4648,9 @@
<note><p>It is preferred to use external global rules linked using <gi>link</gi>
element.</p></note>
</div>
-
+ <div xml:id="html5-standoff-markup"><head>Standoff Markup in HTML5</head>
+ <p>The constraints for <ref target="#provenance-records-in-html5-constraint">Provenance standoff markup in HTML5</ref> and <ref target="#loc-quality-issues-in-html5-constraint">Localization quality issues markup in HTML5</ref> <ref target="#rfc2119">MUST</ref> be followed.</p>
+ </div>
<div xml:id="html5-selection-precedence">
<head>Precedence between Selections</head>
<p>The following precedence order is defined for selections of ITS information in various
Received on Friday, 23 November 2012 16:07:11 UTC