- From: CVS User fsasaki <cvsmail@w3.org>
- Date: Sun, 25 Nov 2012 11:10:39 +0000
- To: public-multilingualweb-lt-commits@w3.org
Update of /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20
In directory gil:/tmp/cvs-serv24616
Modified Files:
its20.html its20.odd local.css
Log Message:
various edits, see http://lists.w3.org/Archives/Public/public-multilingualweb-lt/2012Nov/0202.html
--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2012/11/24 20:00:20 1.260
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2012/11/25 11:10:39 1.261
@@ -52,9 +52,9 @@
<div class="toc3">5.2.2 <a href="#selection-local" shape="rect">Local Selection in an XML Document</a></div>
</div>
<div class="toc2">5.3 <a href="#selectors" shape="rect">Query Language of Selectors</a><div class="toc3">5.3.1 <a href="#queryLanguage" shape="rect">Choosing Query Language</a></div>
-<div class="toc3">5.3.2 <a href="#d0e2159" shape="rect">XPath 1.0</a></div>
-<div class="toc3">5.3.3 <a href="#d0e2425" shape="rect">CSS Selectors</a></div>
-<div class="toc3">5.3.4 <a href="#d0e2464" shape="rect">Additional query languages</a></div>
+<div class="toc3">5.3.2 <a href="#d0e2165" shape="rect">XPath 1.0</a></div>
+<div class="toc3">5.3.3 <a href="#d0e2416" shape="rect">CSS Selectors</a></div>
+<div class="toc3">5.3.4 <a href="#d0e2455" shape="rect">Additional query languages</a></div>
<div class="toc3">5.3.5 <a href="#its-param" shape="rect">Variables in selectors</a></div>
</div>
<div class="toc2">5.4 <a href="#link-external-rules" shape="rect">Link to External Rules</a></div>
@@ -141,8 +141,9 @@
<div class="toc1">F <a href="#its-schematron-constraints" shape="rect">Checking ITS Markup Constraints With Schematron</a> (Non-Normative)</div>
<div class="toc1">G <a href="#its-nvdl-schema" shape="rect">Checking ITS Markup with NVDL</a> (Non-Normative)</div>
<div class="toc1">H <a href="#nif-backconversion" shape="rect">Conversion NIF2ITS</a> (Non-Normative)</div>
-<div class="toc1">I <a href="#revisionlog" shape="rect">Revision Log</a> (Non-Normative)</div>
-<div class="toc1">J <a href="#acknowledgements" shape="rect">Acknowledgements</a> (Non-Normative)</div>
+<div class="toc1">I <a href="#list-of-elements-and-attributes" shape="rect">List of ITS 2.0 Elements and Attributes</a> (Non-Normative)</div>
+<div class="toc1">J <a href="#revisionlog" shape="rect">Revision Log</a> (Non-Normative)</div>
+<div class="toc1">K <a href="#acknowledgements" shape="rect">Acknowledgements</a> (Non-Normative)</div>
</div><hr/><div class="body"><div class="div1">
<h2><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="introduction" id="introduction" shape="rect"/>1 Introduction</h2><p>
<em>This section is informative.</em>
@@ -193,48 +194,48 @@
<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="motivation-its-issues" id="motivation-its-issues" shape="rect"/>1.2.1 Typical Problems</h4><p>The following examples sketch one of the issues that currently hinder efficient
XML-related localization: the lack of a standard, declarative mechanism that
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>
+ automatically perform this identification.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-motivation-its-1" id="EX-motivation-its-1" 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>
-</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
+ 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="EX-motivation-its-2" id="EX-motivation-its-2" 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
@@ -322,102 +323,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
+ not be translated.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-ways-to-use-its-2" id="EX-ways-to-use-its-2" shape="rect"/>Example 4: Use of ITS by information architect</div><p>The <code class="its-elem-markup">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>
-</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>
+ information outside of the document.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-ways-to-use-its-3" id="EX-ways-to-use-its-3" shape="rect"/>Example 5: Use of ITS by processor</div><p>A <code class="its-elem-markup">rules</code> element is inserted in the header of the document. It has a XLink
+ <code class="its-attr-markup">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="EX-ways-to-use-its-4" id="EX-ways-to-use-its-4" shape="rect"/>Example 6: ITS rule file shared by different documents</div><p>The <code class="its-elem-markup">rules</code> element contains several ITS rules that are common to different
+ documents. One of them is a <code class="its-elem-markup">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>
</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>
+ for ITS 2.0]</span><div class="exampleOuter"><div class="exampleHeader"><a name="EX-ways-to-use-its-5" id="EX-ways-to-use-its-5" shape="rect"/>Example 7: An XSD schema with ITS declaration</div><p>The declarations for the <code class="its-attr-markup">translate</code> attribute is added to a
+ group of common attributes <code>commonAtts</code>. This allows to use the <code class="its-attr-markup">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
@@ -429,21 +430,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
@@ -478,7 +479,7 @@
based on the same schema. These needs could by realized by a specification of defaults
for the <a href="#trans-datacat" shape="rect">Translate</a> data category along with exceptions
to those defaults (e.g. all <code>p</code> elements should be translated, but not <code>p</code>
- elements inside of an <code>index</code> element). </p><p>To meet these requirements this specification introduces mechanisms that add ITS
+ elements inside of an <code>index</code> element).</p><p>To meet these requirements this specification introduces mechanisms that add ITS
information to XML documents, see <a class="section-ref" href="#its-processing" shape="rect">Section 5: Processing of ITS information</a>. These
mechanisms also provide a means for specifying ITS information for attributes (a task
for which no standard means previously existed).</p><p>The ITS selection mechanisms allows you to provide information about content <a href="#selection-local" shape="rect">locally</a> (specified at the XML or HTML element to which
@@ -510,32 +511,32 @@
identifying nodes although CSS and other query languages can be used if supported by
application. Thus,</p><ul><li><p>the local approach puts ITS markup in the relevant element of the host vocabulary
(e.g. the <code>author</code> element in DocBook)</p></li><li><p>the <a href="#selection-global" shape="rect">rule-based, global approach</a> puts the ITS
- markup in elements defined by ITS itself (namely the <code>rules</code> element)</p></li></ul><p>ITS markup can be used with XML documents (e.g. a DocBook article), or schemas (e.g. an
+ markup in elements defined by ITS itself (namely the <code class="its-elem-markup">rules</code> element)</p></li></ul><p>ITS markup can be used with XML documents (e.g. a DocBook article), or schemas (e.g. an
XML Schema document for a proprietary document format).</p><p>The following two examples sketch the distinction between the local and global
- approaches, using the <code>translate</code> as one example of ITS
+ approaches, using the <code class="its-attr-markup">translate</code> as one example of ITS
markup.</p><div class="div3">
<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="basic-concepts-selection-local" id="basic-concepts-selection-local" shape="rect"/>2.1.1 Local Approach</h4><p>The document in <a href="#EX-basic-concepts-1" shape="rect">Example 10</a> shows how a content
- author may use the ITS <code>translate</code> attribute to indicate that
+ author may use the ITS <code class="its-attr-markup">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>
-</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 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>
[3901 lines skipped]
--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2012/11/24 20:00:20 1.257
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2012/11/25 11:10:39 1.258
@@ -251,15 +251,15 @@
XML-related localization: the lack of a standard, declarative mechanism that
identifies which parts of an XML document need to be translated. Tools often cannot
automatically perform this identification.</p>
- <exemplum>
+ <exemplum xml:id="EX-motivation-its-1">
<head>Document with partially translatable content</head>
- <p>In this document it is difficult to distinguish between those <gi>string</gi>
+ <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>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/xml/EX-motivation-its-1.xml"/>
</exemplum>
- <exemplum>
+ <exemplum xml:id="EX-motivation-its-2">
<head>Document with partially translatable content</head>
<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
@@ -406,8 +406,8 @@
</list>
<exemplum xml:id="EX-ways-to-use-its-1">
<head>Use of ITS by content author</head>
- <p>The <code>its:translate="no"</code> attributes indicate that the <gi>path</gi> and
- the <gi>cmd</gi> elements should not be translated.</p>
+ <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>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/xml/EX-ways-to-use-its-1.xml"/>
</exemplum>
@@ -418,10 +418,10 @@
not be translated.</p>
</item>
</list>
- <exemplum>
+ <exemplum xml:id="EX-ways-to-use-its-2">
<head>Use of ITS by information architect</head>
<p>The <gi>translateRule</gi> element is used in the header of the document to
- indicate that none of the <gi>path</gi> or <gi>cmd</gi> elements should be
+ indicate that none of the <code>path</code> or <code>cmd</code> elements should be
translated.</p>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/xml/EX-ways-to-use-its-2.xml"/>
@@ -432,7 +432,7 @@
information outside of the document.</p>
</item>
</list>
- <exemplum>
+ <exemplum xml:id="EX-ways-to-use-its-3">
<head>Use of ITS by processor</head>
<p>A <gi>rules</gi> element is inserted in the header of the document. It has a XLink
<att>href</att> attribute used to link to an <ref target="#link-external-rules"
@@ -440,11 +440,11 @@
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/xml/EX-ways-to-use-its-3.xml"/>
</exemplum>
- <exemplum>
+ <exemplum xml:id="EX-ways-to-use-its-4">
<head>ITS rule file shared by different documents</head>
<p>The <gi>rules</gi> element contains several ITS rules that are common to different
documents. One of them is a <gi>translateRule</gi> element that indicates that no
- <gi>path</gi> or <gi>cmd</gi> element should be translated.</p>
+ <code>path</code> or <code>cmd</code> element should be translated.</p>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/xml/EX-ways-to-use-its-4.xml"/>
</exemplum>
@@ -456,7 +456,7 @@
</list>
<note type="ed">Following schema example has to updated once we have final XSD schema
for ITS 2.0</note>
- <exemplum>
+ <exemplum xml:id="EX-ways-to-use-its-5">
<head>An XSD schema with ITS declaration</head>
<p>The declarations for the <att type="class">translate</att> attribute is added to a
group of common attributes <code>commonAtts</code>. This allows to use the <att
@@ -466,9 +466,9 @@
target="examples/xml/EX-ways-to-use-its-5.xsd"/>
</exemplum>
<p>The first two approaches above can be likened to the use of CSS in <ptr
- target="#xhtml10" type="bibref"/>. Using a <att>style</att> attribute, an XHTML
+ target="#xhtml10" type="bibref"/>. 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 <gi>style</gi> element at the top of the page to say that all paragraphs
+ have used the <code>style</code> element at the top of the page to say that all paragraphs
of a particular class or in a particular context would be colored red.</p>
</div>
</div>
@@ -547,8 +547,8 @@
on the other hand, need an efficient way to manage translations of large document sets
based on the same schema. These needs could by realized by a specification of defaults
for the <ref target="#trans-datacat">Translate</ref> data category along with exceptions
- to those defaults (e.g. all <gi>p</gi> elements should be translated, but not <gi>p</gi>
- elements inside of an <gi>index</gi> element). </p>
+ to those defaults (e.g. all <code>p</code> elements should be translated, but not <code>p</code>
+ elements inside of an <code>index</code> element).</p>
<p>To meet these requirements this specification introduces mechanisms that add ITS
information to XML documents, see <ptr target="#its-processing" type="specref"/>. These
mechanisms also provide a means for specifying ITS information for attributes (a task
@@ -602,13 +602,13 @@
selection: (1) local, and (2) using global rules.</p>
<p>The mechanisms defined for ITS selection resemble those defined in <ptr
target="#css2-1" type="bibref"/>. The local approach can be compared to the
- <att>style</att> attribute in HTML/XHTML, and the approach with global rules is
- similar to the <gi>style</gi> element in HTML/XHTML. ITS usually uses XPath for
+ <code>style</code> attribute in HTML/XHTML, and the approach with global rules is
+ similar to the <code>style</code> element in HTML/XHTML. ITS usually uses XPath for
identifying nodes although CSS and other query languages can be used if supported by
application. Thus,</p>
<list>
<item>the local approach puts ITS markup in the relevant element of the host vocabulary
- (e.g. the <gi>author</gi> element in DocBook)</item>
+ (e.g. the <code>author</code> element in DocBook)</item>
<item>the <ref target="#selection-global">rule-based, global approach</ref> puts the ITS
markup in elements defined by ITS itself (namely the <gi>rules</gi> element)</item>
</list>
@@ -624,7 +624,7 @@
<p>The document in <ptr target="#EX-basic-concepts-1" type="exref"/> shows how a content
author may use the ITS <att type="class">translate</att> attribute to indicate that
- all content inside the <gi>author</gi> element should be protected from translation.
+ 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>
<exemplum xml:id="EX-basic-concepts-1">
@@ -645,7 +645,7 @@
<p>The document in <ptr target="#EX-basic-concepts-2" type="exref"/> shows a different
approach to identifying non-translatable content, similar to that used with a
- <gi>style</gi> element in <ptr type="bibref" target="#xhtml10"/>, but using an
+ <code>style</code> element in <ptr type="bibref" target="#xhtml10"/>, but using an
ITS-defined element called <gi>rules</gi>. It works as follows: A document can contain
a <gi>rules</gi> element (placed where it does not impact the structure of the
document, e.g., in a “head” section). It contains one or more ITS rule elements (for
@@ -662,8 +662,8 @@
<p>myElement/descendant-or-self::*/@*</p>
<p>Unfortunately, values like this cause trouble when they are used in XSLT-based
processing of ITS where the values of the ITS <att>selector</att> attributes are
- used as values of <att>match</att> attributes of XSLT templates. The reason for this
- is the following: <att>match</att> attributes may only contain a restriction/subset
+ used as values of <code>match</code> attributes of XSLT templates. The reason for this
+ is the following: <code>match</code> attributes may only contain a restriction/subset
of XPath expressions, so-called <ref target="http://www.w3.org/TR/xslt#patterns"
>patterns</ref>.</p>
<p>Basically the following restrictions hold for patterns: </p>
@@ -698,7 +698,7 @@
<list>
<item>Content authors do not have to concern themselves with creating additional
markup or verifying that the markup was applied correctly. ITS data categories are
- associated with sets of nodes (for example all <gi>p</gi> elements in an XML
+ associated with sets of nodes (for example all <code>p</code> elements in an XML
instance)</item>
<item>Changes can be made in a single location, rather than by searching and modifying
local markup throughout a document (or documents, if the <gi>rules</gi> element is
@@ -738,7 +738,7 @@
<item>ITS data category attributes to appear in global rules (even outside of an XML
document or schema)</item>
<item>ITS data categories attributes to pertain to sets of XML nodes (for example all
- <gi>p</gi> elements in an XML document)</item>
+ <code>p</code> elements in an XML document)</item>
<item>ITS markup to pertain to attributes</item>
<item>ITS markup to <ref target="#associating-its-with-existing-markup"> associate
with existing markup</ref> (for example the <code>term</code> element in
@@ -757,8 +757,8 @@
<p>The document in <ptr target="#EX-basic-concepts-3" type="exref"/> shows how inheritance
and overriding work for the <ref target="#trans-datacat">Translate</ref> data category.
By default elements are translatable. Here, the <gi>translateRule</gi> element declared
- in the header overrides the default for the <gi>head</gi> element inside <gi>text</gi>
- and for all its children. Because the <gi>title</gi> element is actually translatable,
+ in the header overrides the default for the <code>head</code> element inside <code>text</code>
+ and for all its children. Because the <code>title</code> element is actually translatable,
the global rule needs to be overridden by a local <code>its:translate="yes"</code>. Note
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
@@ -779,7 +779,6 @@
data category can add information to selected nodes (using a <gi>locNote</gi> element),
or point to existing information elsewhere in the document (using a
<att>locNotePointer</att> attribute).</p>
-
<p>The functionality of adding information to the selected nodes is available for each
data category except <ref target="#language-information">Language Information</ref>.
Pointing to existing information is not possible for data categories that express
@@ -789,13 +788,12 @@
>Elements Within Text</ref>.</p>
<note type="ed">The following statement is not correct anymore, e.g. <ref
target="#lqissue-global">Localization Quality Issue, applied globally</ref> allows for
- something like <att>locQualityIssuesRef</att> and <att>locQualityIssuesTypePointer</att>
+ something like <att>locQualityIssuesRef</att> and <att>locQualityIssuesRefPointer</att>
at the same <gi>locQualityIssueRule</gi> element. Should this be changed or should the
statement be dropped?</note>
<p>The functionalities of adding information and pointing to existing information are
<emph>mutually exclusive</emph>. That is to say, attributes for pointing and adding
must not appear at the same rule element.</p>
-
</div>
</div>
@@ -860,7 +858,7 @@
type="specref"/>
</item>
</list>
- <exemplum>
+ <exemplum >
<head>A data category and its implementation</head>
<p>The <ref target="#trans-datacat">Translate</ref> data category conveys information as
to whether a piece of content should be translated or not.</p>
@@ -872,7 +870,6 @@
implementation would be a <gi>translateRule</gi> element that allows for specifying
<ref target="#selection-global">global rules</ref> about the <ref
target="#trans-datacat">Translate</ref> data category.</p>
-
</exemplum>
</div>
<div xml:id="def-selection">
@@ -893,14 +890,14 @@
<note>
<p xml:id="note-object-selection">The selection of the ITS data categories applies to
textual values contained within element or attribute nodes. In some cases these nodes
- form pointers to other resources; a well-known example is the <att>src</att> attribute
- on the <gi>img</gi> element in HTML. The ITS <ref target="#trans-datacat"
+ form pointers to other resources; a well-known example is the <code>src</code> attribute
+ on the <code>img</code> element in HTML. The ITS <ref target="#trans-datacat"
>Translate</ref> data category applies to the text of the pointer itself, not the
object to which it points. Thus in the following example, the translation information
specified via the <gi>translateRule</gi> element applies to the filename
<val>instructions.jpg</val>, and is not an instruction to open the graphic and
change the words therein.</p>
- <exemplum>
+ <exemplum xml:id="EX-notation-terminology-1">
<head>Selecting the text of a pointer to an external object</head>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/xml/EX-notation-terminology-1.xml"/>
@@ -924,6 +921,7 @@
</div>
<div xml:id="iri-usage">
<head>Usage of Internationalized Resource Identifiers in ITS</head>
+ <note type="ed">Below list is not up to date.</note>
<p>The attributes <att>href</att>, <att type="element">locNoteRef</att> and <att
type="element">termInfoRef</att> which contain resource identifiers <ref
target="#rfc-keywords">MUST</ref> allow the usage of Internationalized Resource
@@ -987,7 +985,7 @@
used, it <ref target="#rfc-keywords">MUST</ref> be part of the content model of at
least one element declared in the schema. It <ref target="#rfc-keywords"
>SHOULD</ref> be in a content model for meta information, if this is available in
- that schema (e.g. the <gi>head</gi> element in <ptr target="#xhtml10" type="bibref"
+ that schema (e.g. the <code>head</code> element in <ptr target="#xhtml10" type="bibref"
/>).</p></item>
<!-- <item diff="del"><emph>1-2: </emph> The
<gi>schemaRule</gi> element <ref
@@ -1016,6 +1014,7 @@
<p><emph>Examples: </emph> Examples of the usage of ITS markup declarations in various
existing schemas are given in a separate document <ptr target="#xml-i18n-bp"
type="bibref"/>.</p>
+ <note type="ed">Below statement about schemas is wrong if the ITS schemas will be normative.</note>
<note>
<p>Since the ITS markup declarations are schema language independent, each schema
language can use its own, possibly multiple, mechanisms to implement the conformance
@@ -1177,7 +1176,7 @@
<item><p xml:id="its-conformance-3-2"><emph>3-2:</emph> If an application claims to
process ITS markup for the global selection mechanism, it <ref
target="#rfc-keywords">MUST</ref> process a <att>href</att> attribute found on a
- <gi>link</gi> elements which has a <code>rel</code> attribute with the value
+ <code>link</code> elements which has a <code>rel</code> attribute with the value
<code>its-rules</code>.</p></item>
<item><p xml:id="its-conformance-3-3"><emph>3-3:</emph> If an application claims to
process ITS markup implementing the conformance clauses 3-1, 3-2 and 3-3, it <ref
@@ -1296,17 +1295,17 @@
<head>Defaults for various data categories</head>
<p>By default the content of all elements in a document is translatable. The attribute
- <code>its:translate="no"</code> in the <gi>head</gi> element means that the
+ <code>its:translate="no"</code> in the <code>head</code> element means that the
content of this element, including child elements, should not be translated. The
- attribute <code>its:translate="yes"</code> in the <gi>title</gi> element means that
+ attribute <code>its:translate="yes"</code> in the <code>title</code> element means that
the content of this element, should be translated (overriding the
- <code>its:translate="no"</code> in <gi>head</gi>). Attribute values of the
+ <code>its:translate="no"</code> in <code>head</code>). Attribute values of the
selected elements or their children are not affected by local <att type="class"
>translate</att> attributes. By default they are not translatable.</p>
<p>The default directionality of a document is left-to-right. The
- <code>its:dir="rtl"</code> in the <gi>quote</gi> element means that the
+ <code>its:dir="rtl"</code> in the <code>quote</code> element means that the
directionality of the content of this element, including child elements and
- attributes, is right-to-left. Note that <att>xml:lang</att> indicates only the
+ attributes, is right-to-left. Note that <code>xml:lang</code> indicates only the
language, not the directionality.</p>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/xml/EX-selection-local-1.xml"/>
@@ -1371,14 +1370,14 @@
<code>xmlns</code>) is not part of this set.</p>
</item>
</list>
- <exemplum>
+ <exemplum xml:id="EX-selection-global-1">
<head>XPath expressions with namespaces</head>
<p>The <code>term</code> element from the TEI is in a namespace
<code>http://www.tei-c.org/ns/1.0</code>. </p>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/xml/EX-selection-global-1.xml"/>
</exemplum>
- <exemplum>
+ <exemplum xml:id="EX-selection-global-2">
<head>XPath expressions without namespaces</head>
<p>The <gi>term</gi> element from DocBook V4.5 is in no namespace.</p>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
@@ -1395,7 +1394,7 @@
The XPath expression is evaluated relative to the nodes selected by the selector
attribute.</p>
<p xml:id="pointer-attributes-list">The following attributes point to existing information:
- <att>allowedCharactersPointer</att>, <att>disambigClassPointer</att>, <att>disambigClassRefPointer</att>, <att>disambigIdentPointer</att>, <att>disambigIdentRefPointer</att>, <att>domainPointer</att>, <att>externalResourceRefPointer</att>, <att>langPointer</att>, <att>locNotePointer</att>, <att>locNoteRefPointer</att>, <att>locQualityIssueCommentPointer</att>, <att>locQualityIssueProfileRefPointer</att>, <att>locQualityIssueSeverityPointer</att>, <att>locQualityIssueTypePointer</att>, <att>locQualityIssuesRefPointer</att>, <att>locQualityIssuesTypePointer</att>, <att>locQualityPrecisProfileRefPointer</att>, <att>locQualityPrecisScorePointer</att>, <att>locQualityPrecisThresholdPointer</att>, <att>locQualityPrecisVotePointer</att>, <att>orgPointer</att>, <att>orgRefPointer</att>, <att>personPointer</att>, <att>personRefPointer</att>, <att>provRefPointer</att>, <att>provenanceRecordsRefPointer</att>, <att>revOrgPointer</att>, <att>revOrgRefPointer</att>, <att>revPersonPointer</att>, <att>rePersonRefPointer</att>, <att>revToolPointer</att>, <att>revToolRefPointer</att>, <att>rpPointer</att>, <att>rtPointer</att>, <att>rubyPointer</att>, <att>storageEncodingPointer</att>, <att>storageSizePointer</att>, <att>targetPointer</att>, <att>termInfoPointer</att>, <att>termInfoRefPointer</att>, <att>toolPointer</att>, <att>toolRefPointer</att>.</p>
+ <att>allowedCharactersPointer</att>, <att>disambigClassPointer</att>, <att>disambigClassRefPointer</att>, <att>disambigIdentPointer</att>, <att>disambigIdentRefPointer</att>, <att>domainPointer</att>, <att>externalResourceRefPointer</att>, <att>langPointer</att>, <att>locNotePointer</att>, <att>locNoteRefPointer</att>, <att>locQualityIssuesRefPointer</att>, <att>locQualityPrecisProfileRefPointer</att>, <att>locQualityPrecisScorePointer</att>, <att>locQualityPrecisThresholdPointer</att>, <att>locQualityPrecisVotePointer</att>, <att>orgPointer</att>, <att>orgRefPointer</att>, <att>personPointer</att>, <att>personRefPointer</att>, <att>provRefPointer</att>, <att>provenanceRecordsRefPointer</att>, <att>revOrgPointer</att>, <att>revOrgRefPointer</att>, <att>revPersonPointer</att>, <att>revPersonRefPointer</att>, <att>revToolPointer</att>, <att>revToolRefPointer</att>, <att>rpPointer</att>, <att>rtPointer</att>, <att>rubyPointer</att>, <att>storageEncodingPointer</att>, <att>storageSizePointer<att>, <att>targetPointer</att>, <att>termInfoPointer</att>, <att>termInfoRefPointer</att>, <att>toolPointer</att>, <att>toolRefPointer</att>.</p>
<p>Context for evaluation of the XPath expression is same as for absolute selector
with the following changes:</p>
<list>
@@ -1504,7 +1503,7 @@
target="examples/xml/EX-link-external-rules-1.xml"/>
</exemplum>
- <exemplum>
+ <exemplum xml:id="EX-link-external-rules-2">
<head>Document with a link to EX-link-external-rules-1.xml</head>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/xml/EX-link-external-rules-2.xml"/>
@@ -1513,7 +1512,7 @@
<p>The result of processing the two documents above is the same as processing the
following document.</p>
- <exemplum>
+ <exemplum xml:id="EX-link-external-rules-3">
<head>Document with identical rules as in the case of included rules</head>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/xml/EX-link-external-rules-3.xml"/>
@@ -1560,26 +1559,26 @@
E.g. defaults are overridden by inherited values, these are overriden by nodes
selected via global rules, and these are overriden via local markup.</p>
</note>
- <exemplum>
+ <exemplum xml:id="EX-selection-precedence-1">
<head>Conflicts between selections of ITS information which are resolved using the
precedence order</head>
- <p>The two elements <gi>title</gi> and <gi>author</gi> of this document should be
- treated as separate content when inside a <gi>prolog</gi> element, but as part of the
+ <p>The two elements <code>title</code> and <code>author</code> of this document should be
+ treated as separate content when inside a <code>prolog</code> element, but as part of the
content of their parent element otherwise. In order to make this distinction two
<gi>withinTextRule</gi> elements are used:</p>
- <p>The first rule specifies that <gi>title</gi> and <gi>author</gi> in general should be
+ <p>The first rule specifies that <code>title</code> and <code>author</code> in general should be
treated as an element within text. This overrides the default.</p>
- <p>The second rule indicates that when <gi>title</gi> or <gi>author</gi> are found in a
- <gi>prolog</gi> element their content should be treated separately. This is normally
+ <p>The second rule indicates that when <code>title</code> or <code>author</code> are found in a
+ <code>prolog</code> element their content should be treated separately. This is normally
the default, but the rule is needed to override the first rule.</p>
<!-- <p>Due to the rules described above, the local
translatability information from the <att type="class">translate</att>
- attribute on the <gi>p</gi> element has precedence over
+ attribute on the <code>p</code> element has precedence over
the translatability information on the first
<gi>translateRule</gi> element. A conflict occurs for
- <gi>p</gi> elements inside of <gi>entry</gi> elements,
+ <code>p</code> elements inside of <gi>entry</gi> elements,
because of the two <gi>translateRule</gi> elements. This
conflict is resolved via the order of the
<gi>translateRule</gi> elements. The last one has higher
@@ -1779,14 +1778,14 @@
<p>On any given node, the information provided by this mechanism is a space-separated list of the accumulated references found it the <att>toolsRef</att> attributes
declared in the enclosing elements and sorted by data category identifiers. For each data category, the IRI part is the one of the inner-most declarartion.</p>
- <exemplum>
+ <exemplum xml:id="EX-its-tool-annotation-1">
<head>Accumulation and Overriding of the <att>toolsRef</att> Values</head>
<p>In this example, the text shows the computed tools reference information for the given node. Note that the references are ordered alphabetically and
that the IRI values are always the ones of the inner-most declaration.</p>
<egXML xmlns="http://www.tei-c.org/ns/Examples" target="examples/xml/EX-its-tool-annotation-1.xml"></egXML>
</exemplum>
- <exemplum xml:id="EX-its-tool-annotation-1">
+ <exemplum xml:id="EX-its-tool-annotation-2">
<head>Example of ITS Tool Annotation</head>
<p>The <att>toolsRef</att> attribute is used in this XML document to indicate that information about the processor that generated the <att>mtConfidence</att> values
for the first two <code>p</code> elements are found in element with <code>id="T1"</code> in the external document tools.xml, while that information for the
@@ -1794,7 +1793,7 @@
resource with information about the QA tool used to generate the <ref target="#lqissue">Localization Quality Issue</ref> annotation in the document.</p>
<egXML xmlns="http://www.tei-c.org/ns/Examples" target="examples/xml/EX-its-tool-annotation-2.xml"></egXML>
</exemplum>
- <exemplum xml:id="EX-its-tool-annotation-2">
+ <exemplum xml:id="EX-its-tool-annotation-html5-1">
<head>Example of ITS Tool Annotation</head>
<p>The <att>its-tools-ref</att> attributes are used in this HTML document to indicate that the <ref target="#mtconfidence">MT Confidence</ref> annotation on the first two <code>span</code> elements come from one MT (French to English) engine, while the annotation on the third comes from another (Italian to English) engine. Both <att>its-tools-ref</att> attributes refer to a Web resource for information about the engine generating the <ref target="#mtconfidence">MT Confidence</ref> annotation.</p>
<egXML xmlns="http://www.tei-c.org/ns/Examples" target="examples/html5/EX-its-tool-annotation-html5-1.html"></egXML>
@@ -1885,11 +1884,6 @@
present it to a translator.</item>
</list>
</note>
- <note type="ed">The links to examples (last column) are currently pointing to the old
[1105 lines skipped]
--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/local.css 2012/11/11 16:43:45 1.3
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/local.css 2012/11/25 11:10:39 1.4
@@ -370,4 +370,12 @@
h2+div.short-name {
margin-top: 1em;
+}
+
+*.its-elem-markup {
+ color: red;
+}
+
+*.its-attr-markup {
+ color: red;
}
\ No newline at end of file
Received on Sunday, 25 November 2012 11:10:49 UTC