- From: CVS User jkosek <cvsmail@w3.org>
- Date: Thu, 29 Nov 2012 11:50:58 +0000
- To: public-multilingualweb-lt-commits@w3.org
Update of /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20
In directory gil:/tmp/cvs-serv17503
Modified Files:
its20.html its20.odd
Log Message:
Changed HTML5 to HTML in most places (ACTION-327)
--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2012/11/29 11:40:26 1.277
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2012/11/29 11:50:57 1.278
@@ -9,9 +9,9 @@
<h2><a name="abstract" id="abstract" shape="rect"/>Abstract</h2><p>This document defines data categories and their implementation as a set of elements and
attributes called the <em>Internationalization Tag Set (ITS)</em> 2.0. ITS 2.0 is the
successor of <a href="http://www.w3.org/TR/2007/REC-its-20070403/" shape="rect">ITS 1.0</a>; it is
- designed to foster the creation of multilingual Web content, focusing on HTML5, XML based
+ designed to foster the creation of multilingual Web content, focusing on HTML, XML based
formats in general, and to leverage localization workflows based on the XML Localization
- Interchange File Format (XLIFF). In addition to using ITS 2.0 for HTML5 and XML content, an
+ Interchange File Format (XLIFF). In addition to using ITS 2.0 for HTML and XML content, an
algorithm to convert that content to NIF is provided.</p></div><div>
<h2><a name="status" shape="rect">Status of this Document</a></h2><p><strong>This document is an editors' copy that has no official
standing.</strong></p></div><div class="toc">
@@ -23,7 +23,7 @@
<div class="toc2">1.3 <a href="#users-usage" shape="rect">Users and Usages of ITS</a><div class="toc3">1.3.1 <a href="#potential-users" shape="rect">Potential Users of ITS</a></div>
<div class="toc3">1.3.2 <a href="#ways-to-use-its" shape="rect">Ways to Use ITS</a></div>
</div>
-<div class="toc2">1.4 <a href="#usage-in-html5" shape="rect">Usage in HTML5</a><div class="toc3">1.4.1 <a href="#usage-in-legacy-html" shape="rect">Support for legacy HTML content</a></div>
+<div class="toc2">1.4 <a href="#usage-in-html5" shape="rect">Usage in HTML</a><div class="toc3">1.4.1 <a href="#usage-in-legacy-html" shape="rect">Support for legacy HTML content</a></div>
</div>
<div class="toc2">1.5 <a href="#out-of-scope" shape="rect">Out of Scope</a></div>
<div class="toc2">1.6 <a href="#design-decisions" shape="rect">Important Design Principles</a></div>
@@ -63,9 +63,9 @@
<div class="toc2">5.7 <a href="#conversion-to-nif" shape="rect">Conversion to NIF</a></div>
<div class="toc2">5.8 <a href="#its-tool-annotation" shape="rect">ITS Tools Annotation</a></div>
</div>
-<div class="toc1">6 <a href="#html5-markup" shape="rect">Using ITS Markup in HTML5</a><div class="toc2">6.1 <a href="#html5-local-attributes" shape="rect">Mapping of Local Data Categories to HTML5</a></div>
+<div class="toc1">6 <a href="#html5-markup" shape="rect">Using ITS Markup in HTML</a><div class="toc2">6.1 <a href="#html5-local-attributes" shape="rect">Mapping of Local Data Categories to HTML</a></div>
<div class="toc2">6.2 <a href="#html5-global-rules" shape="rect">Global rules</a></div>
-<div class="toc2">6.3 <a href="#html5-standoff-markup" shape="rect">Standoff Markup in HTML5</a></div>
+<div class="toc2">6.3 <a href="#html5-standoff-markup" shape="rect">Standoff Markup in HTML</a></div>
<div class="toc2">6.4 <a href="#html5-selection-precedence" shape="rect">Precedence between Selections</a></div>
</div>
<div class="toc1">7 <a href="#xhtml5-markup" shape="rect">Using ITS Markup in XHTML</a></div>
@@ -151,7 +151,7 @@
concepts (such as “Translate”) that are important for internationalization and
localization, and defines implementations of these concepts (termed “ITS data categories”)
as a set of elements and attributes called the <em>Internationalization Tag Set
- (ITS)</em>. The document provides implementations for HTML5, serializations in <a href="http://nlp2rdf.org/nif-1-0" shape="rect">NIF</a>, and provides definitions of ITS elements
+ (ITS)</em>. The document provides implementations for HTML, serializations in <a href="http://nlp2rdf.org/nif-1-0" shape="rect">NIF</a>, and provides definitions of ITS elements
and attributes in the form of XML Schema <a title="XML Schema Part 1:
 Structures Second Edition" href="#xmlschema1" shape="rect">[XML Schema]</a> and
RELAX NG <a title="Regular-grammar-based validation -- RELAX NG" href="#relaxng" shape="rect">[RELAX NG]</a>.</p><p>This document aims to realize many of the ideas formulated in the <a href="http://www.w3.org/TR/2012/WD-its2req-20120524/" shape="rect">ITS 2.0 Requirements
document</a>, in <a title="Internationalization and
 Localization Markup Requirements" href="#itsreq" shape="rect">[ITS REQ]</a> and <a title="Requirements for Localizable
 DTD Design" href="#reqlocdtd" shape="rect">[Localizable DTDs]</a>.</p><p>Not all requirements listed there are addressed in this document. Those which are not
@@ -164,10 +164,10 @@
data category to a given content format</p></li><li><p>It adopts the conformance principle of ITS1.0 that an implementation only
needs to implement one data category to claim conformance to ITS 2.0</p></li></ul></li><li><p>ITS 2.0 supports all ITS 1.0 data category definitions and adds new definitions,
with the exceptions of <a href="#directionality" shape="rect">Directionality</a> and <a href="#ruby-annotation" shape="rect">Ruby</a>.</p></li><li><p>ITS 2.0 adds a number of new data categories not found in ITS 1.0.</p></li><li><p>While ITS 1.0 addressed only XML, ITS 2.0 specifies implementations of data
- categories in <em>both</em> XML <em>and</em> HTML5.</p></li></ul></div><div class="div3">
+ categories in <em>both</em> XML <em>and</em> HTML.</p></li></ul></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="new-principles" id="new-principles" shape="rect"/>1.1.2 New Principles</h4><p>ITS 2.0 also adds the following principles and features not found in ITS 1.0:</p><ul><li><p>ITS 2.0 data categories are intended to be format neutral, with support for XML,
- HTML5, and NIF: a data category implementation only needs to support a single
- content format mapping in order to support a claim of ITS 2.0 conformance.</p></li><li><p>ITS 2.0 provides algorithms to generate NIF out of HTML5 or XML with ITS 2.0
+ HTML, and NIF: a data category implementation only needs to support a single
+ content format mapping in order to support a claim of ITS 2.0 conformance.</p></li><li><p>ITS 2.0 provides algorithms to generate NIF out of HTML or XML with ITS 2.0
metadata.</p></li><li><p>A global implementation of ITS 2.0 requires at least the XPath version 1.0.
Other versions of XPath or other query languages (e.g., CSS selectors) can be
expressed via a dedicated <a href="#queryLanguage" shape="rect">queryLanguage</a>
@@ -195,46 +195,46 @@
identifies which parts of an XML document need to be translated. Tools often cannot
automatically perform this identification.</p><div class="exampleOuter"><div class="exampleHeader"><a name="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>
+ 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,131 +322,131 @@
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="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="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>
+ <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>
+ <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="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>
+ 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
of a particular class or in a particular context would be colored red.</p></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="usage-in-html5" id="usage-in-html5" shape="rect"/>1.4 Usage in HTML5</h3><p>ITS 2.0 adds support for usage in HTML5. In HTML5, ITS local selection is realized via
+<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="usage-in-html5" id="usage-in-html5" shape="rect"/>1.4 Usage in HTML</h3><p>ITS 2.0 adds support for usage in HTML. In HTML, ITS local selection is realized via
dedicated, <a href="#html5-local-attributes" shape="rect">data category specific
- attributes</a>.</p><span class="editor-note">[Ed. note: Add example of HTML5 with local attributes for illustration
+ attributes</a>.</p><span class="editor-note">[Ed. note: Add example of HTML with local attributes for illustration
purposes]</span><p>For the so-called “<a href="#basic-concepts-selection-global" shape="rect">global
- approach</a>” in HTML5, this specification defines a link type for referring to files
- with global rules in <a class="section-ref" href="#html5-global-rules" shape="rect">Section 6.2: Global 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
+ approach</a>” in HTML, this specification defines a link type for referring to files
+ with global rules in <a class="section-ref" href="#html5-global-rules" shape="rect">Section 6.2: Global 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 HTML</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 HTML</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
+ encouraged to migrate their content to HTML or XHTML. While it is possible to use
<code>its-*</code> attributes introduced for HTML5 in older versions of HTML (such
as 3.2 or 4.01) and pages using these attributes will work without any problems,
<code>its-*</code> attributes will be marked as invalid in validators.</p></div></div><div class="div2">
@@ -461,7 +461,7 @@
Trados “DTD Settings” file, and the SDLX “Analysis” file.</p></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="design-decisions" id="design-decisions" shape="rect"/>1.6 Important Design Principles</h3><p>Abstraction via <em>data categories</em>: ITS defines <span class="new-term">data categories</span>
as an abstract notion for information needed for the internationalization and
- localization of XML documents and HTML5 documents. This abstraction is helpful in
+ localization of XML documents and HTML documents. This abstraction is helpful in
realizing independence from any one particular implementation (e.g., as an element or
attribute). (See <a class="section-ref" href="#def-datacat" shape="rect">Section 3.2: Data category</a> for a definition of the
term data categories, <a class="section-ref" href="#datacategory-description" shape="rect">Section 8: Description of Data Categories</a> for the
@@ -518,23 +518,23 @@
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>
[2723 lines skipped]
--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2012/11/29 11:40:26 1.274
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2012/11/29 11:50:58 1.275
@@ -69,9 +69,9 @@
<p>This document defines data categories and their implementation as a set of elements and
attributes called the <emph>Internationalization Tag Set (ITS)</emph> 2.0. ITS 2.0 is the
successor of <loc href="http://www.w3.org/TR/2007/REC-its-20070403/">ITS 1.0</loc>; it is
- designed to foster the creation of multilingual Web content, focusing on HTML5, XML based
+ designed to foster the creation of multilingual Web content, focusing on HTML, XML based
formats in general, and to leverage localization workflows based on the XML Localization
- Interchange File Format (XLIFF). In addition to using ITS 2.0 for HTML5 and XML content, an
+ Interchange File Format (XLIFF). In addition to using ITS 2.0 for HTML and XML content, an
algorithm to convert that content to NIF is provided.</p>
</abstract>
<status>
@@ -85,9 +85,9 @@
<p>This document defines data categories and their implementation as a set of elements and
attributes called the <emph>Internationalization Tag Set (ITS)</emph> 2.0. ITS 2.0 is the
successor of <loc href="http://www.w3.org/TR/2007/REC-its-20070403/">ITS 1.0</loc>; it is
- designed to foster the creation of multilingual Web content, focusing on HTML5, XML based
+ designed to foster the creation of multilingual Web content, focusing on HTML, XML based
formats in general, and to leverage localization workflows based on the XML Localization
- Interchange File Format (XLIFF). In addition to using ITS 2.0 for HTML5 and XML content, an
+ Interchange File Format (XLIFF). In addition to using ITS 2.0 for HTML and XML content, an
algorithm to convert that content to NIF is provided.</p>
<p>This document is an updated Public Working Draft published by the <loc
@@ -147,7 +147,7 @@
concepts (such as <q>Translate</q>) that are important for internationalization and
localization, and defines implementations of these concepts (termed “ITS data categories”)
as a set of elements and attributes called the <emph>Internationalization Tag Set
- (ITS)</emph>. The document provides implementations for HTML5, serializations in <ref
+ (ITS)</emph>. The document provides implementations for HTML, serializations in <ref
target="http://nlp2rdf.org/nif-1-0">NIF</ref>, and provides definitions of ITS elements
and attributes in the form of XML Schema <ptr target="#xmlschema1" type="bibref"/> and
RELAX NG <ptr target="#relaxng" type="bibref"/>.</p>
@@ -182,7 +182,7 @@
target="#ruby-annotation">Ruby</ref>.</item>
<item>ITS 2.0 adds a number of new data categories not found in ITS 1.0.</item>
<item>While ITS 1.0 addressed only XML, ITS 2.0 specifies implementations of data
- categories in <emph>both</emph> XML <emph>and</emph> HTML5.</item>
+ categories in <emph>both</emph> XML <emph>and</emph> HTML.</item>
</list>
</div>
<div xml:id="new-principles">
@@ -190,9 +190,9 @@
<p>ITS 2.0 also adds the following principles and features not found in ITS 1.0:</p>
<list type="unorderd">
<item>ITS 2.0 data categories are intended to be format neutral, with support for XML,
- HTML5, and NIF: a data category implementation only needs to support a single
+ HTML, and NIF: a data category implementation only needs to support a single
content format mapping in order to support a claim of ITS 2.0 conformance.</item>
- <item>ITS 2.0 provides algorithms to generate NIF out of HTML5 or XML with ITS 2.0
+ <item>ITS 2.0 provides algorithms to generate NIF out of HTML or XML with ITS 2.0
metadata.</item>
<item>A global implementation of ITS 2.0 requires at least the XPath version 1.0.
Other versions of XPath or other query languages (e.g., CSS selectors) can be
@@ -474,17 +474,17 @@
</div>
<div xml:id="usage-in-html5">
- <head>Usage in HTML5</head>
- <p>ITS 2.0 adds support for usage in HTML5. In HTML5, ITS local selection is realized via
+ <head>Usage in HTML</head>
+ <p>ITS 2.0 adds support for usage in HTML. In HTML, ITS local selection is realized via
dedicated, <ref target="#html5-local-attributes">data category specific
attributes</ref>.</p>
- <note type="ed">Add example of HTML5 with local attributes for illustration
+ <note type="ed">Add example of HTML with local attributes for illustration
purposes</note>
<p>For the so-called “<ref target="#basic-concepts-selection-global">global
- approach</ref>” in HTML5, this specification defines a link type for referring to files
+ approach</ref>” in HTML, this specification defines a link type for referring to files
with global rules in <ptr target="#html5-global-rules" type="specref"/>.</p>
<exemplum xml:id="EX-translate-html5-global-1">
- <head>Using ITS global rules in HTML5</head>
+ <head>Using ITS global rules in HTML</head>
<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>
@@ -492,7 +492,7 @@
target="examples/html5/EX-translate-html5-global-1.html" type="html5"/>
</exemplum>
<exemplum xml:id="EX-translate-html5-global-1-rules-file">
- <head>ITS rules file linked from HTML5</head>
+ <head>ITS rules file linked from HTML</head>
<p>The rules file linked in <ptr target="#EX-translate-html5-global-1" type="exref"
/>.</p>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
@@ -501,7 +501,7 @@
<div xml:id="usage-in-legacy-html">
<head>Support for legacy HTML content</head>
<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
+ encouraged to migrate their content to HTML or XHTML. While it is possible to use
<code>its-*</code> attributes introduced for HTML5 in older versions of HTML (such
as 3.2 or 4.01) and pages using these attributes will work without any problems,
<code>its-*</code> attributes will be marked as invalid in validators.</p>
@@ -527,7 +527,7 @@
<head>Important Design Principles</head>
<p>Abstraction via <emph>data categories</emph>: ITS defines <term>data categories</term>
as an abstract notion for information needed for the internationalization and
- localization of XML documents and HTML5 documents. This abstraction is helpful in
+ localization of XML documents and HTML documents. This abstraction is helpful in
realizing independence from any one particular implementation (e.g., as an element or
attribute). (See <ptr target="#def-datacat" type="specref"/> for a definition of the
term data categories, <ptr target="#datacategory-description" type="specref"/> for the
@@ -1133,7 +1133,7 @@
<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
- target="#rfc-keywords">MUST</ref> process that markup within HTML5
+ target="#rfc-keywords">MUST</ref> process that markup within HTML
documents.</p></item>
</list>
<p xml:id="its-html-processing-conformance-claims">Statements related to this conformance
@@ -1263,9 +1263,9 @@
target="examples/xml/EX-selection-local-1.xml"/>
</exemplum>
<note><p>The <att>dir</att> and <att>translate</att> attributes are not listed in the
- ITS attributes to be used in HTML5. The reason is that these two attributes are
- available in HTML5 natively, so there is no need to provide them as
- <code>its-</code> attributes. The definition of the two attributes in HTML5 is
+ ITS attributes to be used in HTML. The reason is that these two attributes are
+ available in HTML natively, so there is no need to provide them as
+ <code>its-</code> attributes. The definition of the two attributes in HTML is
compatibly, that is it provides the same values and interpretation, as the
definition for the two data categories <ref target="#trans-datacat">Translate</ref>
and <ref target="#directionality">Directionality</ref>.</p></note>
@@ -1725,7 +1725,7 @@
<item><p>The IRI indicates information about the processor used to generate the data category annotation. No single means is specified for how this IRI should be used to indicate processor information. Possible mechanisms are: to encode information directly in the IRI, e.g. as parameters; to reference an external resource that provides such information, e.g. an XML file or an RDF declaration; or to reference another part of the document that provides such information.</p></item>
</list>
- <p>In HTML5 documents, the mechanism is implemented with the <att>its-tools-ref</att> attribute.</p>
+ <p>In HTML documents, the mechanism is implemented with the <att>its-tools-ref</att> attribute.</p>
<p>The attribute applies to the content of the element where it is declared (including its children elements) and to the attributes of that element.</p>
@@ -1755,10 +1755,10 @@
</div>
</div>
<div xml:id="html5-markup">
- <head>Using ITS Markup in HTML5</head>
+ <head>Using ITS Markup in HTML</head>
<div xml:id="html5-local-attributes">
- <head>Mapping of Local Data Categories to HTML5</head>
+ <head>Mapping of Local Data Categories to HTML</head>
<p>All data categories defined in <ptr target="#datacategory-description" type="specref"/>
and having local implementation might be used in HTML with the exception of <ref
target="#trans-datacat" type="specref">Translate</ref>, <ref target="#directionality"
@@ -1800,8 +1800,8 @@
<p xml:id="html5-external-global-rules">Link to external global rules is specified in <att>href</att> attribute of
<code>link</code> element, with the link relation <code>its-rules</code>.</p>
<note>
- <p>Using XPath in global rules linked from HTML5 documents does not create an additional
- burden to implementers. Parsing HTML5 content produces a DOM tree that can be directly
+ <p>Using XPath in global rules linked from HTML documents does not create an additional
+ burden to implementers. Parsing HTML content produces a DOM tree that can be directly
queried using XPath, functionality supported by all major browsers.</p>
</note>
<p xml:id="html5-inline-global-rules">Inline global rules <ref target="#rfc2119">MUST</ref> be specified inside <code>script</code> which has <code>type</code>
@@ -1812,8 +1812,8 @@
element.</p></note>
</div>
- <div xml:id="html5-standoff-markup"><head>Standoff Markup in HTML5</head>
- <p>The constraints for <ref target="#provenance-records-in-html5-constraint">Provenance standoff markup in HTML5</ref> and <ref target="#loc-quality-issues-in-html5-constraint">Localization quality issues markup in HTML5</ref> <ref target="#rfc2119">MUST</ref> be followed.</p>
+ <div xml:id="html5-standoff-markup"><head>Standoff Markup in HTML</head>
+ <p>The constraints for <ref target="#provenance-records-in-html5-constraint">Provenance standoff markup in HTML</ref> and <ref target="#loc-quality-issues-in-html5-constraint">Localization quality issues markup in HTML</ref> <ref target="#rfc2119">MUST</ref> be followed.</p>
</div>
<div xml:id="html5-selection-precedence">
<head>Precedence between Selections</head>
@@ -1843,8 +1843,8 @@
adhere to <ref target="http://www.w3.org/TR/html-design-principles/#dom-consistency">DOM
Consistency HTML Design Principle</ref>.</p>
<exemplum xml:id="EX-xhtml5-markup-1">
- <head>Using ITS 2.0 markup in XHTML5</head>
- <p>This examples illustrates the use of ITS 2.0 local markup and global rules in XHTML5.</p>
+ <head>Using ITS 2.0 markup in XHTML</head>
+ <p>This examples illustrates the use of ITS 2.0 local markup and global rules in XHTML.</p>
<egXML xmlns="http://www.tei-c.org/ns/Examples" target="examples/html5/EX-xhtml5-markup-1.html" type="html5"></egXML>
</exemplum>
</div>
@@ -2307,7 +2307,7 @@
</exemplum>
<exemplum xml:id="EX-translate-html5">
<head>The <ref target="#trans-datacat">Translate</ref> data category expressed locally
- in HTML5</head>
+ in HTML</head>
<p>The local <code>translate="no"</code> attribute specifies that the content of
<code>span</code> must not be translated.</p>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
@@ -2441,7 +2441,7 @@
<exemplum xml:id="EX-locNote-html5">
<head>The <ref target="#locNote-datacat">Localization Note</ref> data category
- expressed locally in HTML5</head>
+ expressed locally in HTML</head>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/html5/EX-locNote-html5-local-1.html" type="html5"/>
</exemplum>
@@ -2520,7 +2520,7 @@
referring to the resource providing information about the term.</item>
<item>An optional <att>termConfidence</att> attribute with the value of a rational number in the interval 0 to 1 (inclusive). The value follows the <ref target="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#decimal">XML Schema decimal data type</ref> with the constraining facets <ref target="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#rf-minInclusive">minInclusive</ref> set to 0 and <ref target="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#rf-maxInclusive">maxInclusive</ref> set to 1. <att>termConfidence</att> represents the confidence of the agents producing the annotation that the values of the term and, where provided, <att>termInfoRef</att>, are accurate. 1 represents the highest level of confidence.</item>
</list>
- <p>Any node selected by the terminology data category with the <att>termConfidence</att> attribute specified <ref target="#rfc2119">MUST</ref> be contained in an element with the <att>toolsRef</att> (or in HTML5 <att>its-tools-ref</att>) attribute specified for the <ref target="#terminology">Terminology</ref> data category. See <ptr target="#its-tool-annotation" type="specref"/> for more information.</p>
+ <p>Any node selected by the terminology data category with the <att>termConfidence</att> attribute specified <ref target="#rfc2119">MUST</ref> be contained in an element with the <att>toolsRef</att> (or in HTML <att>its-tools-ref</att>) attribute specified for the <ref target="#terminology">Terminology</ref> data category. See <ptr target="#its-tool-annotation" type="specref"/> for more information.</p>
<exemplum xml:id="EX-terms-selector-4">
<head>The <ref target="#terminology">Terminology</ref> data category expressed
locally, including term information reference and confidence score.</head>
@@ -2529,7 +2529,7 @@
</exemplum>
<exemplum xml:id="EX-term-local-html-1">
<head>The <ref target="#terminology">Terminology</ref> data category expressed locally
- in HTML5</head>
+ in HTML</head>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/html5/EX-term-html5-local-1.html" type="html5"/>
</exemplum>
@@ -2539,11 +2539,11 @@
<head>Directionality</head>
<p>This section is <emph>informative</emph>.</p>
<note><p xml:id="directionality-non-normative-explanation">As time of writing,
- directionality is not clearly defined in HTML5, and no implementation commitment is
+ directionality is not clearly defined in HTML, and no implementation commitment is
seen for the <ref target="#directionality">Directionality</ref> data category in ITS
2.0. Hence this data category is defined as informative, creating a non-backward
compatibly change to ITS 1.0. This note and this section may be updated with the
- proper guidance if the HTML5 definition is stabilized before ITS 2.0 moves to proposed
+ proper guidance if the HTML definition is stabilized before ITS 2.0 moves to proposed
recommendation status. Nevertheless, to be able to move to last call, the <ref
target="#directionality">Directionality</ref> data category will not be defined as a
normative feature of ITS 2.0.</p></note>
@@ -2629,7 +2629,7 @@
</exemplum>
<exemplum xml:id="EX-dir-html5-local-1">
<head>The <ref target="#directionality">Directionality</ref> data category expressed
- locally in HTML5</head>
+ locally in HTML</head>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/html5/EX-dir-html5-local-1.html" type="html5"/>
</exemplum>
@@ -2639,10 +2639,10 @@
<head>Ruby</head>
<p>This section is <emph>informative</emph>.</p>
<note><p xml:id="ruby-non-normative-explanation">As time of writing, ruby is not clearly
- defined in HTML5, and no implementation commitment is seen for the <ref
+ defined in HTML, and no implementation commitment is seen for the <ref
target="#ruby-annotation">Ruby</ref> data category in ITS 2.0. Hence this data
category is defined as informative, creating a non-backward compatibly change to ITS
- 1.0. This note and this section may be updated with the proper guidance if the HTML5
+ 1.0. This note and this section may be updated with the proper guidance if the HTML
definition is stabilized before ITS 2.0 moves to proposed recommendation status.
Nevertheless, to be able to move to last call, the <ref target="#ruby-annotation"
>Ruby</ref> data category will not be defined as a normative feature of ITS
@@ -2656,7 +2656,7 @@
</div>
<div xml:id="ruby-implementation">
<head>Implementation</head>
- <note type="ed">Examples for HTML5 need to be added; </note>
+ <note type="ed">Examples for HTML need to be added; </note>
<p>The <ref target="#ruby-annotation">Ruby</ref> data category can be expressed with
global rules, or locally. There is no inheritance.</p>
@@ -2724,7 +2724,7 @@
language of the text selected by the selector attribute. This markup <ref
target="#rfc-keywords">MUST</ref> use values that conform to <ptr type="bibref"
target="#bcp47"/>. The recommended way to specify language identification is to use
- <code>xml:lang</code> in XML, and <code>lang</code> in HTML5. The <gi>langRule</gi>
+ <code>xml:lang</code> in XML, and <code>lang</code> in HTML. The <gi>langRule</gi>
element is intended only as a fall-back mechanism for documents where language is
identified with another construct.</p>
<exemplum xml:id="EX-lang-definition-1">
@@ -2843,7 +2843,7 @@
</exemplum>
<exemplum xml:id="EX-within-text-local-html5-1">
<head>The <ref target="#trans-datacat">Elements Within Text</ref> data category
- expressed locally in HTML5</head>
+ expressed locally in HTML</head>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/html5/EX-within-text-local-html5-1.html" type="html5"/>
</exemplum>
@@ -2996,10 +2996,10 @@
/>
</exemplum>
<note>
- <p>In HTML5 the preferred way to express domain information is a <code>meta</code>
+ <p>In HTML the preferred way to express domain information is a <code>meta</code>
element with the <code>name</code> attribute set to <val>keywords</val>, see <ref
target="http://www.w3.org/TR/html5/single-page.html#standard-metadata-names"
- >standard metadata names in HTML5</ref>. Alternatively, following the process for
+ >standard metadata names in HTML</ref>. Alternatively, following the process for
<ref target="http://www.w3.org/TR/html5/single-page.html#other-metadata-names"
>other metadata names</ref> the <ref
target="http://wiki.whatwg.org/wiki/MetaExtensions">extension value</ref> of
@@ -3185,7 +3185,7 @@
</list>
</item>
</list>
- <p>Any node selected by the <ref target="#Disambiguation">disambiguation</ref> data category with the <att>disambigConfidence</att> attribute specified <ref target="#rfc2119">MUST</ref> be contained in an element with the <att>toolsRef</att> (or in HTML5 <att>its-tools-ref</att>) attribute specified for the <ref target="#Disambiguation">disambiguation</ref> data category. For more information, see <ptr target="#its-tool-annotation" type="specref"/>.</p>
+ <p>Any node selected by the <ref target="#Disambiguation">disambiguation</ref> data category with the <att>disambigConfidence</att> attribute specified <ref target="#rfc2119">MUST</ref> be contained in an element with the <att>toolsRef</att> (or in HTML <att>its-tools-ref</att>) attribute specified for the <ref target="#Disambiguation">disambiguation</ref> data category. For more information, see <ptr target="#its-tool-annotation" type="specref"/>.</p>
<exemplum xml:id="EX-disambiguation-html5-local-1">
<head>Local mixed usage of Usage of <att>disambigClassRef</att>,
<att>disambigGranularity</att>, and <att>disambigIdentRef</att> in HTML.</head>
@@ -3200,7 +3200,7 @@
entities are distinct from types of lexical concepts or ontology concepts. While
this distinction exists, the specification does not prescribe a way of automatically
inferring a disambiguation level from a target type.</p>
- <p>When serializing the ITS mark-up in HTML5, the preferred way is to serialize in
+ <p>When serializing the ITS mark-up in HTML, the preferred way is to serialize in
RDFa Lite or Microdata due to the existing search and crawling infrastructure that
is able to consume this kind of data.</p>
</note>
@@ -3436,7 +3436,7 @@
<att>revTool</att>, <att>revToolRef</att> and <att>provRef</att> are used in a standoff manner, the information they carry pertains
to the content of the element that refers to the standoff annotation, not to the content of the element <gi>provenanceRecord</gi>
where they are declared.</p>
- <p xml:id="provenance-records-in-html5-constraint">In HTML5 the standoff markup <ref target="#rfc-keywords">MUST</ref> be stored inside
+ <p xml:id="provenance-records-in-html5-constraint">In HTML the standoff markup <ref target="#rfc-keywords">MUST</ref> be stored inside
a <code>script</code> element. It <ref target="#rfc-keywords">MUST</ref> have a <code>type</code> attribute with the value
<code>application/its+xml</code>. Its <code>id</code> attribute <ref target="#rfc-keywords">MUST</ref> be set to the same value as
the <code>xml:id</code> attribute of the <gi>provenanceRecords</gi> element it contains.</p>
@@ -3507,19 +3507,19 @@
</exemplum>
<exemplum xml:id="EX-externalresource-2">
<head>Two <gi>externalResourceRefRule</gi> elements used for external resources
- associated with HTML5 <code>video</code> elements</head>
+ associated with HTML <code>video</code> elements</head>
<p>The two <gi>externalResourceRefRule</gi> elements select the <code>src</code> and
- the <code>poster</code> attributes at HTML5 <code>video</code> elements. These
+ the <code>poster</code> attributes at HTML <code>video</code> elements. These
attributes identify different external resources, and at the same time contain the
references to these resources. For this reason, the
<att>externalResourceRefPointer</att> attributes point to the value of
- <code>src</code> and <code>poster</code> respectively. The underlying HTML5
+ <code>src</code> and <code>poster</code> respectively. The underlying HTML
document is given in <ptr type="exref" target="#EX-externalresource-html5-1"/>.</p>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/xml/EX-externalresource-2.xml"/>
</exemplum>
<exemplum xml:id="EX-externalresource-html5-1">
- <head>An HTML5 document that can be used for <ptr type="exref"
+ <head>An HTML document that can be used for <ptr type="exref"
target="#EX-externalresource-2"/>.</head>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/html5/EX-externalresource-html5-1.html" type="html5"/>
@@ -3700,7 +3700,7 @@
textual content of the element, <emph>including</emph> child elements and
attributes.</p>
<note><p xml:id="preserve-space-and-html5">The <ref target="#preservespace">Preserve
- Space</ref> data category is not applicable to HTML5 documents because
+ Space</ref> data category is not applicable to HTML documents because
<code>xml:space</code> (and by extension <ref target="#preservespace">Preserve
Space</ref>) has no effect in documents parsed as text/html.</p></note>
@@ -3951,7 +3951,7 @@
in a standoff manner, the information they carry pertains to the content of the
element that refers to the standoff annotation, not to the content of the element
<gi>locQualityIssue</gi> where they are declared.</p>
- <p xml:id="loc-quality-issues-in-html5-constraint">In HTML5 the standoff markup <ref target="#rfc-keywords">MUST</ref> be stored inside a <code>script</code> element. It <ref target="#rfc-keywords">MUST</ref> have a <code>type</code> attribute with the value <code>application/its+xml</code>. Its <code>id</code> attribute <ref target="#rfc-keywords">MUST</ref> be set to the same value as the <code>xml:id</code>
+ <p xml:id="loc-quality-issues-in-html5-constraint">In HTML the standoff markup <ref target="#rfc-keywords">MUST</ref> be stored inside a <code>script</code> element. It <ref target="#rfc-keywords">MUST</ref> have a <code>type</code> attribute with the value <code>application/its+xml</code>. Its <code>id</code> attribute <ref target="#rfc-keywords">MUST</ref> be set to the same value as the <code>xml:id</code>
attribute of the <gi>locQualityIssues</gi> element it contains.</p>
</item>
</list>
@@ -4105,7 +4105,7 @@
of the element, <emph>including</emph> child elements, but <emph>excluding</emph>
attributes.</p>
<p>Any node selected by the <ref target="#mtconfidence">MT Confidence</ref> data category <ref target="#rfc2119">MUST</ref> be contained in an element
- with the <att>toolsRef</att> (or in HTML5, <att>its-tools-ref</att>) attribute specified for the
+ with the <att>toolsRef</att> (or in HTML, <att>its-tools-ref</att>) attribute specified for the
<ref target="#mtconfidence">MT Confidence</ref> data category. For more information, see <ptr target="#its-tool-annotation" type="specref"/>.</p>
<p xml:id="mtconfidence-global">GLOBAL: The <gi>mtConfidenceRule</gi> element contains
the following:</p>
@@ -4126,7 +4126,7 @@
</exemplum>
<p>Where the external ITS rules file is as shown:</p>
<exemplum xml:id="EX-mtconfidence-global-html5-1-external-rules">
- <head>XML file with external rules references from an HTML5 file.</head>
+ <head>XML file with external rules references from an HTML file.</head>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/html5/EX-mtconfidence-global-html5-1-external-rules.xml"/>
</exemplum>
@@ -4144,7 +4144,7 @@
</exemplum>
<exemplum xml:id="EX-mtConfidence-html5-local-1">
<head>The <ref target="#mtconfidence">MT Confidence</ref> data category expressed
- locally for the content of two separate spans in a HTML5 document.</head>
+ locally for the content of two separate spans in a HTML document.</head>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/html5/EX-mtConfidence-html5-local-1.html" type="html5"/>
@@ -5196,7 +5196,7 @@
translate="no">Ireland</b>
]]></eg>
<p>CASE 2: The NLP annotation created in NIF is a substring of the text node. Solution:
- Create a new element, e.g. for HTML5 "span". A different input example is given below as
+ Create a new element, e.g. for HTML "span". A different input example is given below as
case 2 is not covered in the original example input.</p>
<eg><![CDATA[# Input:
[57 lines skipped]
Received on Thursday, 29 November 2012 11:51:05 UTC