- From: CVS User ysavoure <cvsmail@w3.org>
- Date: Mon, 17 Jun 2013 10:16:09 +0000
- To: public-multilingualweb-lt-commits@w3.org
Update of /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20
In directory gil:/tmp/cvs-serv20984
Modified Files:
its20.html
Log Message:
updated html
--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2013/06/17 09:54:44 1.457
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2013/06/17 10:16:09 1.458
@@ -59,9 +59,9 @@
<div class="toc3">5.2.2 <a href="#selection-local" shape="rect">Local Selection in an XML Document</a></div>
</div>
<div class="toc2">5.3 <a href="#selectors" shape="rect">Query Language of Selectors</a><div class="toc3">5.3.1 <a href="#queryLanguage" shape="rect">Choosing Query Language</a></div>
-<div class="toc3">5.3.2 <a href="#d0e2585" shape="rect">XPath 1.0</a></div>
+<div class="toc3">5.3.2 <a href="#d0e2603" shape="rect">XPath 1.0</a></div>
<div class="toc3">5.3.3 <a href="#css-selectors" shape="rect">CSS Selectors</a></div>
-<div class="toc3">5.3.4 <a href="#d0e2830" shape="rect">Additional query languages</a></div>
+<div class="toc3">5.3.4 <a href="#d0e2848" shape="rect">Additional query languages</a></div>
<div class="toc3">5.3.5 <a href="#its-param" shape="rect">Variables in selectors</a></div>
</div>
<div class="toc2">5.4 <a href="#link-external-rules" shape="rect">Link to External Rules</a></div>
@@ -351,9 +351,19 @@
systems provide about their translation. </p></li><li><p><a href="#allowedchars" shape="rect">Allowed Characters</a>: specifies the characters that
are permitted in a given piece of content.</p></li><li><p><a href="#storagesize" shape="rect">Storage Size</a>: specifies the maximum storage size
of a given piece of content.</p></li></ul></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="basic-concepts-selection" id="basic-concepts-selection" shape="rect"/>2.2 Selection</h3><p>Information (e.g. “translate this”) captured by an ITS data category always pertains to one or more XML or HTML nodes, primarily element and attribute nodes. In a sense, the relevant node(s) get “selected”. Selection may be explicit or implicit. ITS distinguishes two mechanisms for explicit selection: (1) local approach, and (2) global approach (via <code class="its-elem-markup">rules</code>). Both local and global approach can interact with each other, and with additional ITS dimensions such as inheritance and defaults.</p><p>The mechanisms defined for ITS selection resemble those defined in <a title="Cascading Style Sheets,
 level 2 revision 1 CSS 2.1 Specification" href="#css2-1" shape="rect">[CSS 21]</a>. The local approach can be compared to the
- <code>style</code> attribute in HTML/XHTML, and the global approach is similar to the <code>style</code> element in HTML/XHTML.</p><ul><li><p>the local approach puts ITS markup in the relevant element of the host vocabulary (e.g. the <code>author</code> element in DocBook)</p></li><li><p>the global, <a href="#selection-global" shape="rect">rule-based approach</a> puts the ITS
- markup in elements defined by ITS itself (namely the <code class="its-elem-markup">rules</code> element)</p></li></ul><p>ITS usually uses XPath in rules for identifying nodes although CSS Selectors and other query languages can in addition be implemented by applications.</p><p>ITS 2.0 can be used with XML documents (e.g. a DocBook article), HTML documents, or schemas (e.g. an XML Schema document for a proprietary document format).</p><p>The following two examples provide more details about the distinction between the local and global approach, using the <a href="#trans-datacat" shape="rect">Translate</a> data category as example.</p><div class="div3">
+<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="basic-concepts-selection" id="basic-concepts-selection" shape="rect"/>2.2 Selection</h3><p>Information (e.g. “translate this”) captured by an ITS data category always
+ pertains to one or more XML or HTML nodes, primarily element and attribute nodes. In a
+ sense, the relevant node(s) get “selected”. Selection may be explicit or implicit.
+ ITS distinguishes two mechanisms for explicit selection: (1) local and (2) global (via
+ <code class="its-elem-markup">rules</code>). Both local and global approaches can interact with each other, and
+ with additional ITS dimensions such as inheritance and defaults.</p><p>The mechanisms defined for ITS selection resemble those defined in <a title="Cascading Style Sheets,
 level 2 revision 1 CSS 2.1 Specification" href="#css2-1" shape="rect">[CSS 2.1]</a>. The local approach can be compared to the
+ <code>style</code> attribute in HTML/XHTML, and the global approach is similar to the <code>style</code> element in HTML/XHTML.</p><ul><li><p>The local approach puts ITS markup in the relevant element of the host vocabulary
+ (e.g. the <code>author</code> element in DocBook)</p></li><li><p>The global <a href="#selection-global" shape="rect">rule-based approach</a> puts the ITS
+ markup in elements defined by ITS itself (namely the <code class="its-elem-markup">rules</code> element)</p></li></ul><p>ITS usually uses XPath in rules for identifying nodes although CSS Selectors and other query languages can in addition be implemented by applications.</p><p>ITS 2.0 can be used with XML documents (e.g. a DocBook article), HTML documents,
+ document schemas (e.g. an XML Schema document for a proprietary document format), or
+ data models in RDF.</p><p>The following two examples provide more details about the distinction between the local
+ and global approach, using the <a href="#trans-datacat" shape="rect">Translate</a> data
+ category as an example.</p><div class="div3">
<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="basic-concepts-selection-local" id="basic-concepts-selection-local" shape="rect"/>2.2.1 Local Approach</h4><p>The document in <a href="#EX-basic-concepts-1" shape="rect">Example 3</a> shows how a content author 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 (i.e. must not be translated). Translation tools that are aware of the meaning of the attribute can protect the relevant content from being translated (possibly still allowing translators to see the protected content as context information).</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-basic-concepts-1" id="EX-basic-concepts-1" shape="rect"/>Example 3: ITS markup on elements in an XML document (local approach) </iv><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><article</strong> <span class="hl-attribute" style="color: #F5844C">xmlns</span>=<span class="hl-value" style="color: #993300">"http://docbook.org/ns /docbook"</span>
<span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span>
<span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"5.0"</span> <span class="hl-attribute" style="color: #F5844C">xml:lang</span>=<span class="hl-value" style="color: #993300">"en"</span><strong class="hl-tag" style="color: #000096">></strong>
@@ -446,12 +456,30 @@
<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><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="html5-its-local-markup" id="html5-its-local-markup" shape="rect"/>2.5.2 Local approach</h4><p>In HTML, an ITS 2.0 local data category is realized with the prefix <code>its-*</code>.
- The general mapping of the XML based ITS 2.0 attributes to their HTML <code>its-*</code> counterparts is defined in
+</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="exampleOuter"><div class="exampleHeader"><a name="EX-translate-html5-inline-global-1" id="EX-translate-html5-inline-global-1" shape="rect"/>Example 8: Using ITS inline global rules in HTML</div><p>The <code>script</code> element contains the same rules as the external rules file
+ <code>EX-translateRule-html5-1.xml</code> in <a href="#EX-translate-html5-global-1-rules-file" shape="rect">the above example</a>.</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"><script</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">application/its+xml</span> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">ru1</span><strong class="hl-tag" style="color: #000096">></strong>
+ <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>
+ <strong class="hl-tag" style="color: #000096"></script></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.
+ Of course there are always exceptions: certain code values should be translated,
+ e.g. to a value in your language like <strong class="hl-tag" style="color: #000096"><code</strong> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">yes</span><strong class="hl-tag" style="color: #000096">></strong>warning<strong class="hl-tag" style="color: #000096"></code></strong>.<strong class="hl-tag" style="color: #000096"></p></strong>
+ <strong class="hl-tag" style="color: #000096"></body></strong>
+<strong class="hl-tag" style="color: #000096"></html></strong></pre></div><p>[Source file: <a href="examples/html5/EX-translate-html5-inline-global-1.html" shape="rect">examples/html5/EX-translate-html5-inline-global-1.html</a>]</p></div></div><div class="div3">
+<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="html5-its-local-markup" id="html5-its-local-markup" shape="rect"/>2.5.2 Local approach</h4><p>In HTML, an ITS 2.0 local data category is realized with the prefix <code>its-</code>.
+ The general mapping of the XML based ITS 2.0 attributes to their HTML counterparts is defined in
<a class="section-ref" href="#html5-local-attributes" shape="rect">Section 6.1: Mapping of Local Data Categories to HTML</a>. An informative table in <a class="section-ref" href="#list-of-elements-and-attributes" shape="rect">Appendix G: List of ITS 2.0 Global Elements and Local Attributes</a>
provides an overview of the mapping for all data categories.</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="html5-existing-markup-versus-its" id="html5-existing-markup-versus-its" shape="rect"/>2.5.3 HTML markup with ITS 2.0 counterparts</h4><p>There are four ITS 2.0 data categories, which have counterparts in HTML markup. Put differently: native HTML markup reveals information for some ITS 2.0 data categories. For these data categories, ITS 2.0 defines the following:</p><ul><li><p>The <a href="#language-information" shape="rect">Language Information</a> data category has the HTML <code>lang</code>
+<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="html5-existing-markup-versus-its" id="html5-existing-markup-versus-its" shape="rect"/>2.5.3 HTML markup with ITS 2.0 counterparts</h4><p>There are four ITS 2.0 data categories, which have counterparts in HTML markup. In these cases the native HTML markup locally overrides ITS 2.0 data categories as defined here:</p><ul><li><p>The <a href="#language-information" shape="rect">Language Information</a> data category has the HTML <code>lang</code>
attribute as counterpart. In XHTML the counterpart is the <code>xml:lang</code> attribute. These attributes act as
local markup for the <a href="#language-information" shape="rect">Language Information</a> data category in HTML and
take <a href="#selection-precedence" shape="rect">precedence</a> over language information conveyed via a global <code class="its-elem-markup">langRule</code>.</p></li><li><p>The <a href="#idvalue" shape="rect">Id Value</a> data category has the HTML or XHTML <code>id</code> attribute as counterpart.
@@ -465,7 +493,7 @@
and <code class="its-elem-markup">textarea</code> are interpreted as <code>withinText="nested"</code>.</p></li><li><p id="translate-in-html5">The <a href="#trans-datacat" shape="rect">Translate</a> data category has a direct counterpart in
<a title="HTML5" href="#html5" shape="rect">[HTML5]</a>, namely the <a title="HTML5" href="#html5" shape="rect">[HTML5]</a>
<code>translate</code> attribute. ITS 2.0 does not define its own behavior for <a title="HTML5" href="#html5" shape="rect">[HTML5]</a>
- <code>translate</code>, but just refers to <a href="http://www.w3.org/TR/html51/dom.html#the-translate-attribute" shape="rect">the HTML5 definition</a>. That definition also applies to nodes selected via global rules. That is, a <code class="its-elem-markup">translateRule</code> like <code><its:translateRule selector=""//h:img" translate="yes"/></code> will set the <code>img</code> element and its translatable attributes like <code>alt</code> to "yes".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-and-existing-HTML5-markup" id="EX-its-and-existing-HTML5-markup" shape="rect"/>Example 8: The <a href="#language-information" shape="rect">Language Information</a>, <a href="#idvalue" shape="rect">Id Value</a>,
+ <code>translate</code>, but just refers to <a href="http://www.w3.org/TR/html51/dom.html#the-translate-attribute" shape="rect">the HTML5 definition</a>. That definition also applies to nodes selected via global rules. That is, a <code class="its-elem-markup">translateRule</code> like <code><its:translateRule selector=""//h:img" translate="yes"/></code> will set the <code>img</code> element and its translatable attributes like <code>alt</code> to "yes".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-and-existing-HTML5-markup" id="EX-its-and-existing-HTML5-markup" shape="rect"/>Example 9: The <a href="#language-information" shape="rect">Language Information</a>, <a href="#idvalue" shape="rect">Id Value</a>,
<a href="#elements-within-text" shape="rect">Elements within Text</a> and <a href="#trans-datacat" shape="rect">Translate</a>
ITS 2.0 data categories expressed by native HTML markup.</div><p>The <code>lang</code> attribute of the <code>html</code> element conveys the
<a href="#language-information" shape="rect">Language Information</a> value "en".
@@ -482,17 +510,17 @@
<strong class="hl-tag" style="color: #000096"><img</strong> <span class="hl-attribute" style="color: #F5844C">src</span>=<span class="hl-value" style="color: #993300">"http://example.com/myimg.png"</span> <span class="hl-attribute" style="color: #F5844C">alt</span>=<span class="hl-value" style="color: #993300">"My image"</span><strong class="hl-tag" style="color: #000096">/></strong>.<strong class="hl-tag" style="color: #000096"></p></strong>
<strong class="hl-tag" style="color: #000096"></body></strong>
<strong class="hl-tag" style="color: #000096"></html></strong></pre></div><p>[Source file: <a href="examples/html5/EX-its-and-existing-HTML5-markup.html" shape="rect">examples/html5/EX-its-and-existing-HTML5-markup.html</a>]</p></div><p>There are also some HTML markup elements that have or can have similar, but not necessarily identical, roles and behavior than certain ITS 2.0 data categories. For example, the HTML <code>dfn</code> element could be used to identify a term in the sense of the <a href="#terminology" shape="rect">Terminology</a> data category. However, this is not always the case and it depends on the intentions of the HTML content author. To accommodate this situation, users of ITS 2.0 are encouraged to specify the semantics of existing HTML markup in an ITS 2.0 context with a dedicated global rules file. Example: use a rule to define that the HTML <code>dfn</code> has the semantics of ITS <code>term="yes</code>. For additional examples see the <a href="http://www.w3.org/TR/2008/NOTE-xl-i18n-bp-20080213/#relating-its-plus-xhtml" shape="rect">XML I18N Best Practices</a> document.</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="html5-standoff-markup-explanation" id="html5-standoff-markup-explanation" shape="rect"/>2.5.4 Standoff Markup in HTML5</h4><p>The <a href="#provenance" shape="rect">Provenance</a> and the <a href="#lqissue" shape="rect">Localization Quality Issue</a> data categories allow for using so-called standoff markup, see the XML <a href="#EX-provenance-global-1" shape="rect">Example 58</a>. In HTML such standoff markup is placed into a <code>script</code> element. If this is done, the constraints for <a href="#provenance-records-in-html5-constraint" shape="rect">Provenance standoff</a> markup in HTML and <a href="#loc-quality-issues-in-html5-constraint" shape="rect">Localization quality issue</a> markup in HTML need to be taken into account. Examples of standoff markup in HTML for the two data categories are <a href="#EX-proveance-html5-local-2" shape="rect">Example 61</a> and <a href="#EX-locQualityIssue-html5-local-2" shape="rect">Example 76</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="html5-standoff-markup-explanation" id="html5-standoff-markup-explanation" shape="rect"/>2.5.4 Standoff Markup in HTML5</h4><p>The <a href="#provenance" shape="rect">Provenance</a> and the <a href="#lqissue" shape="rect">Localization Quality Issue</a> data categories allow for using so-called standoff markup, see the XML <a href="#EX-provenance-global-1" shape="rect">Example 59</a>. In HTML such standoff markup is placed into a <code>script</code> element. If this is done, the constraints for <a href="#provenance-records-in-html5-constraint" shape="rect">Provenance standoff</a> markup in HTML and <a href="#loc-quality-issues-in-html5-constraint" shape="rect">Localization quality issue</a> markup in HTML need to be taken into account. Examples of standoff markup in HTML for the two data categories are <a href="#EX-proveance-html5-local-2" shape="rect">Example 62</a> and <a href="#EX-locQualityIssue-html5-local-2" shape="rect">Example 77</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"/>2.5.5 Version of HTML</h4><p>ITS 2.0 does not define how to use ITS in HTML versions prior to version 5. Users are
thus encouraged to migrate their content to <a title="HTML5" href="#html5" shape="rect">[HTML5]</a> or XHTML. While it is possible to use
<code>its-*</code> attributes introduced for <a title="HTML5" href="#html5" shape="rect">[HTML5]</a> 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 by validators.</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="traceability" id="traceability" shape="rect"/>2.6 Traceability</h3><p>The <a href="#its-tool-annotation" shape="rect">ITS Tools Annotation</a> mechanism allows associating processor information with individual data categories in a document, independently from data category annotations themselves (e.g. the Entity Type related to Text Analysis). The mechanism associates identifiers for tools with data categories via the <code class="its-attr-markup">annotatorsRef</code> attribute (or <a href="" shape="rect">annotators-ref</a> in <a title="HTML5" href="#html5" shape="rect">[HTML5]</a>) and is mandatory for the <a href="#mtconfidence" shape="rect">MT Confidence</a> data category. For the <a href="#terminology" shape="rect">Terminology</a> and <a href="#textanalysis" shape="rect">Text Analysis</a> data categories the ITS Tols Annotation is mandatory if the data categories provide confidence information. Nevertheless, <a href="#its-tool-annotation" shape="rect">ITS Tools Annotation</a> can be used for all data categories. <a href="#EX-its-tool-annotation-2" shape="rect">Example 23</a> demonstrates the usage in the context of several data categories.
+<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="traceability" id="traceability" shape="rect"/>2.6 Traceability</h3><p>The <a href="#its-tool-annotation" shape="rect">ITS Tools Annotation</a> mechanism allows associating processor information with individual data categories in a document, independently from data category annotations themselves (e.g. the Entity Type related to Text Analysis). The mechanism associates identifiers for tools with data categories via the <code class="its-attr-markup">annotatorsRef</code> attribute (or <a href="" shape="rect">annotators-ref</a> in <a title="HTML5" href="#html5" shape="rect">[HTML5]</a>) and is mandatory for the <a href="#mtconfidence" shape="rect">MT Confidence</a> data category. For the <a href="#terminology" shape="rect">Terminology</a> and <a href="#textanalysis" shape="rect">Text Analysis</a> data categories the ITS Tols Annotation is mandatory if the data categories provide confidence information. Nevertheless, <a href="#its-tool-annotation" shape="rect">ITS Tools Annotation</a> can be used for all data categories. <a href="#EX-its-tool-annotation-2" shape="rect">Example 24</a> demonstrates the usage in the context of several data categories.
</p></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="mapping-conversion" id="mapping-conversion" shape="rect"/>2.7 Mapping and conversion</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="mapping-NIF" id="mapping-NIF" shape="rect"/>2.7.1 ITS and RDF/NIF</h4><p>ITS 2.0 defines an algorithm to convert XML or HTML documents (or their DOM
- representations) that contain ITS metadata to the RDF-based format based on <a title="" href="#nif-reference" shape="rect">[NIF]</a>. NIF is an RDF/OWL-based format that aims at interoperability between Natural Language Processing (NLP) tools, language resources and annotations.</p><p>The conversion <a href="#conversion-to-nif" shape="rect">ITS 2.0 to NIF</a> results in RDF triples. These triples represent the textual content of the original document as RDF typed information. The ITS annotation is represented as properties of content related triples and relies on an <a href="http://www.w3.org/2005/11/its/rdf#" shape="rect">ITS RDF vocabulary</a>.</p><p>The back conversion from <a href="#nif-backconversion" shape="rect">NIF to ITS 2.0</a> is defined informatively. One motivation for the back conversion is a round tripping work flow like: 1) conversion to NIF 2) in NIF representation detection of named entities using NLP tools 3) back conversion to HTML and generation of <a href="#textanalysis" shape"rect">Text Analysis</a> markup. The outcome are HTML documents with linked information, see <a href="#EX-text-analysis-html5-local-1" shape="rect">Example 52</a>.</p></div><div class="div3">
+ representations) that contain ITS metadata to the RDF-based format based on <a title="" href="#nif-reference" shape="rect">[NIF]</a>. NIF is an RDF/OWL-based format that aims at interoperability between Natural Language Processing (NLP) tools, language resources and annotations.</p><p>The conversion <a href="#conversion-to-nif" shape="rect">ITS 2.0 to NIF</a> results in RDF triples. These triples represent the textual content of the original document as RDF typed information. The ITS annotation is represented as properties of content related triples and relies on an <a href="http://www.w3.org/2005/11/its/rdf#" shape="rect">ITS RDF vocabulary</a>.</p><p>The back conversion from <a href="#nif-backconversion" shape="rect">NIF to ITS 2.0</a> is defined informatively. One motivation for the back conversion is a round tripping work flow like: 1) conversion to NIF 2) in NIF representation detection of named entities using NLP tools 3) back conversion to HTML and generation of <a href="#textanalysis" shape"rect">Text Analysis</a> markup. The outcome are HTML documents with linked information, see <a href="#EX-text-analysis-html5-local-1" shape="rect">Example 53</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="mapping-XLIFF" id="mapping-XLIFF" shape="rect"/>2.7.2 ITS and XLIFF</h4><p>The XML Localization Interchange File Format <a title="XLIFF Version 1.2" href="#xliff1.2" shape="rect">[XLIFF 1.2]</a> is an OASIS standard that enables translatable source text and its translation to be passed between different tools within localization and translation workflows. <a title="XLIFF Version 2.0" href="#xliff2.0" shape="rect">[XLIFF 2.0]</a> is the successor of <a title="XLIFF Version 1.2" href="#xliff1.2" shape="rect">[XLIFF 1.2]</a> and under development. XLIFF has been widely implemented in various translation management systems, computer supported translation tools and in utilities for extracting translatable content from source documents.</p><p>The mapping between ITS and XLIFF therefore unpins several important ITS 2.0 usagescenarios <a title="Metadata for the Multilingual Web - Usage Scenarios and Implementations " href="#mlw-metadata-us-impl" shape="rect">[MLW US IMPL]</a>. These usage scenarios involve:</p><ul><li><p>the extraction of ITS meta-data from a source language file into XLIFF</p></li><li><p>the addition of ITS meta-data into an XLIFF file by translation tools</p></li><li><p>the mapping of ITS meta-data in an XLIFF file into ITS meta-data in the resulting target language files.</p></li></ul><p>ITS 2.0 has no normative dependency on XLIFF, however a <a href="http://www.w3.org/International/its/wiki/XLIFF_Mapping" shape="rect">non-normative definition of how to represent ITS 2.0 data categories in XLIFF 1.2 or XLIFF 2.0</a> is being defined within the <a href="http://www.w3.org/International/its/ig/" shape="rect">Internationalization Tag Set Interest Group</a>.</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="implementing-its20" id="implementing-its20" shape="rect"/>2.8 ITS 2.0 Implementations and Conformance</h3><p>What does it mean to implement ITS 2.0? This specification provides several conformance clauses as the normative answer (see <a class="section-ref" href="#conformance" shape="rect">Section 4: Conformance</a>). The clauses are targeted at different types of implementers.</p><ul><li><p>Conformance clauses in <a class="section-ref" href="#conformance-product-schema" shape="rect">Section 4.1: Conformance Type 1: ITS Markup Declarations</a> tell markup vocabulary developers how to add ITS 2.0 markup declarations to their schemas.</p></li><li><p>Conformance clauses in <a class="section-ref" href="#conformance-product-processing-expectations" shape="rect">Section 4.2: Conformance Type 2: The Processing Expectationsfor ITS Markup</a> tell implementers how to process XML content according to ITS 2.0 data categories.</p></li><li><p>Conformance clauses in <a class="section-ref" href="#conformance-product-html-processing-expectations" shape="rect">Section 4.3: Conformance Type 3: Processing Expectations for ITS Markup in HTML</a> tell implementers how to process <a title="HTML5" href="#html5" shape="rect">[HTML5]</a> content.</p></li><li><p>Conformance clauses in <a class="section-ref" href="#conformance-product-html5-its" shape="rect">Section 4.4: Conformance Type 4: Markup conformance for HTML5+ITS documents</a> tell implementers how ITS 2.0 markup is integrated into <a title="HTML5" href="#html5" shape="rect">[HTML5]</a>.</p></li></ul><p>The conformance clauses in <a class="section-ref" href="#conformance-product-processing-expectations" shape="rect">Section 4.2: Conformance Type 2: The Processing Expectations for ITS Markup</a> and <a class="section-ref" href="#conformance-product-html-processing-expectations" shap="rect">Section 4.3: Conformance Type 3: Processing Expectations for ITS Markup in HTML</a> clarify how information needs to be made available for given pieces of markup when processing a dedicated ITS 2.0 data category. To allow for flexibility, an implementation can choose whether it wants to support only ITS 2.0 global or local information, or XML or HTML content. These choices are reflected in separate conformance clauses and also in the <a href="@@@@" shape="rect">ITS 2.0 test suite</a>.</p><p>ITS 2.0 processing expectations only define which information needs to be made available. They do not define how that information actually should be used. This is due to the fact that there is a wide variety of usage scenarios for ITS 2.0, and a wide variety of tools for working with ITS 2.0 is possible. Each of these tools may have its own way of using ITS 2.0 data categories (see <a title="Metadata for the Multilingual Web - Usage Scenarios and Implementations " href="#mlw-metadata-us-impl" shape="rect">[MLW U IMPL]</a> for more information).</p><span class="editor-note">[Ed. note: Add link to test suite]</span></div></div><div class="div1">
<h2><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="notation-terminology" id="notation-terminology" shape="rect"/>3 Notation and Terminology</h2><p>
@@ -516,7 +544,7 @@
and localization of XML schemas and documents.] The concept of a data
category is independent of its implementation in an XML and HTML environment (e.g.,
using an element or attribute).</p><p>For each data category, ITS distinguishes between the following:</p><ul><li><p>the prose description, see <a class="section-ref" href="#datacategory-description" shape="rect">Section 8: Description of Data Categories</a></p></li><li><p>schema language-independent formalization, see the "implementation" subsections in
- <a class="section-ref" href="#datacategory-description" shape="rect">Section 8: Description of Data Categories</a></p></li><li><p>schema language-specific implementations, see <a class="section-ref" href="#its-schemas" shape="rect">Appendix D: Schemas for ITS</a></p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d0e1619" id="d0e1619" shape="rect"/>Example 9: A data category and its implementation</div><p>The <a href="#trans-datacat" shape="rect">Translate</a> data category conveys information as
+ <a class="section-ref" href="#datacategory-description" shape="rect">Section 8: Description of Data Categories</a></p></li><li><p>schema language-specific implementations, see <a class="section-ref" href="#its-schemas" shape="rect">Appendix D: Schemas for ITS</a></p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d0e1637" id="d0e1637" shape="rect"/>Example 10: A data category and its implementation</div><p>The <a href="#trans-datacat" shape="rect">Translate</a> data category conveys information as
to whether a piece of content should be translated or not.</p><p>The simplest formalization of this prose description on a schema language-independent
level is a <code class="its-attr-markup">translate</code> attribute with two possible values:
"yes" and "no". An implementation on a schema language-specific
@@ -539,7 +567,7 @@
pointer itself, not the object to which it points. Thus in the following example, the
translation information specified via the <code class="its-elem-markup">translateRule</code> element applies to
the filename "instructions.jpg", and is not an instruction to open the
- graphic and change the words therein.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-notation-terminology-1" id="EX-notation-terminology-1" shape="rect"/>Example 10: Selecting the text of a pointer to an external object</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><text></strong>
+ graphic and change the words therein.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-notation-terminology-1" id="EX-notation-terminology-1" shape="rect"/>Example 11: Selecting the text of a pointer to an external object</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><text></strong>
<strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> 
<span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><its:translateRule</strong> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"yes"</span> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//p/img/@src"</span><strong class="hl-tag" style="color: #000096">/></strong>
@@ -754,7 +782,7 @@
<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="selection-local" id="selection-local" shape="rect"/>5.2.2 Local Selection in an XML Document</h4><p>Local selection in XML documents is realized with <a href="#local-attributes" shape="rect">ITS
local attributes</a> or the <code class="its-elem-markup">span</code> element. <code class="its-elem-markup">span</code> serves just as a
carrier for the local ITS attributes.</p><p>The data category determines what is being selected. The necessary data category
- specific defaults are described in <a class="section-ref" href="#datacategories-defaults-etc" shape="rect">Section 8.1: Position, Defaults, Inheritance and Overriding of Data Categories</a>.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-selection-local-1" id="EX-selection-local-1" shape="rect"/>Example 11: Defaults for various data categories</div><p>By default the content of all elements in a document is translatable. The attribute
+ specific defaults are described in <a class="section-ref" href="#datacategories-defaults-etc" shape="rect">Section 8.1: Position, Defaults, Inheritance and Overriding of Data Categories</a>.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-selection-local-1" id="EX-selection-local-1" shape="rect"/>Example 12: Defaults for various data categories</div><p>By default the content of all elements in a document is translatable. The attribute
<code>its:translate="no"</code> in the <code>head</code> element means that the
content of this element, including child elements, should not be translated. The
attribute <code>its:translate="yes"</code> in the <code>title</code> element means
@@ -788,9 +816,9 @@
actual query language. The query language is set by <code class="its-attr-markup">queryLanguage</code> attribute
on <code class="its-elem-markup">rules</code> element. If <code class="its-attr-markup">queryLanguge</code> is not specified XPath 1.0 is
used as a default query language.</p></div><div class="div3">
-<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="d0e2585" id="d0e2585" shape="rect"/>5.3.2 XPath 1.0</h4><p>XPath 1.0 is identified by <code>xpath</code> value in <code class="its-attr-markup">queryLanguage</code>
+<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="d0e2603" id="d0e2603" shape="rect"/>5.3.2 XPath 1.0</h4><p>XPath 1.0 is identified by <code>xpath</code> value in <code class="its-attr-markup">queryLanguage</code>
attribute.</p><div class="div4">
-<h5><a name="d0e2596" id="d0e2596" shape="rect"/>5.3.2.1 Absolute selector</h5><p>The absolute selector <a href="#rfc-keywords" shape="rect">MUST</a> be an XPath expression
+<h5><a name="d0e2614" id="d0e2614" shape="rect"/>5.3.2.1 Absolute selector</h5><p>The absolute selector <a href="#rfc-keywords" shape="rect">MUST</a> be an XPath expression
that starts with "<code>/</code>". That is, it must be an <a href="http://www.w3.org/TR/xpath/#NT-AbsoluteLocationPath" shape="rect">
AbsoluteLocationPath</a> or union of <a href="http://www.w3.org/TR/xpath/#NT-AbsoluteLocationPath" shape="rect">
AbsoluteLocationPath</a>s as described in <a href="#xpath" shape="rect">XPath 1.0</a>.
@@ -801,12 +829,12 @@
expression to include a call to any other function.</p></li><li><p>The set of namespace declarations are those in scope on the element that has
the attribute in which the expression occurs. This includes the implicit
declaration of the prefix <code>xml</code> required by the <a href="#xmlns" shape="rect">XML Namespaces Recommendation</a>; the default namespace (as declared by
- <code>xmlns</code>) is not part of this set.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-selection-global-1" id="EX-selection-global-1" shape="rect"/>Example 12: XPath expressions with namespaces</div><p>The <code>term</code> element from the TEI is in a namespace
+ <code>xmlns</code>) is not part of this set.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-selection-global-1" id="EX-selection-global-1" shape="rect"/>Example 13: XPath expressions with namespaces</div><p>The <code>term</code> element from the TEI is in a namespace
<code>http://www.tei-c.org/ns/1.0</code>. </p><div class="exampleInner"><pre xml:space="preserve"><em class="hl-comment" style="color: silver"><!-- Definitions for TEI --></em>
<strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><its:termRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//tei:term"</span> <span class="hl-attribute" style="color: #F5844C">term</span>=<span class="hl-value" style="color: #993300">"yes"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:tei</span>=<span class="hl-value" style="color: #993300">"http://www.tei-c.org/ns/1.0"</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-selection-global-1.xml" shape="rect">examples/xml/EX-selection-global-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-selection-global-2" id="EX-selection-global-2" shape="rect"/>Example 13: XPath expressions without namespaces</div><p>The <code class="its-elem-markup">term</code> element from DocBook V4.5 is in no namespace.</p><div class="exampleInner"><pre xml:space="preserve"><em class="hl-comment" style="color: silver"><!-- Definitions for DocBook --></em>
+</pre></div><p>[Source file: <a href="examples/xml/EX-selection-global-1.xml" shape="rect">examples/xml/EX-selection-global-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-selection-global-2" id="EX-selection-global-2" shape="rect"/>Example 14: XPath expressions without namespaces</div><p>The <code class="its-elem-markup">term</code> element from DocBook V4.5 is in no namespace.</p><div class="exampleInner"><pre xml:space="preserve"><em class="hl-comment" style="color: silver"><!-- Definitions for DocBook --></em>
<strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><its:termRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//term"</span> <span class="hl-attribute" style="color: #F5844C">term</span>=<span class="hl-value" style="color: #993300">"yes"</span><strong class="hl-tag" style="color: #000096">/></strong>
<strong class="hl-tag" style="color: #000096"></its:rules></strong>
@@ -835,14 +863,14 @@
be used.</p></div><div class="note"><p class="prefix"><b>Note:</b></p><p id="css-selectors-and-attributes">CSS selectors have no ability to point to
attributes.</p></div><p>CSS Selectors are identified by the value <code>css</code> in the
<code class="its-attr-markup">queryLanguage</code> attribute.</p><div class="div4">
-<h5><a name="d0e2807" id="d0e2807" shape="rect"/>5.3.3.1 Absolute selector</h5><p>An absolute selector <a href="#rfc-keywords" shape="rect">MUST</a> be interpreted as a
+<h5><a name="d0e2825" id="d0e2825" shape="rect"/>5.3.3.1 Absolute selector</h5><p>An absolute selector <a href="#rfc-keywords" shape="rect">MUST</a> be interpreted as a
selector as defined in <a title="Selectors Level
 3" href="#css3-selectors" shape="rect">[Selectors Level 3]</a>. Both simple
selectors and groups of selectors can be used.</p></div><div class="div4">
-<h5><a name="d0e2817" id="d0e2817" shape="rect"/>5.3.3.2 Relative selector</h5><p>A relative selector <a href="#rfc-keywords" shape="rect">MUST</a> be interpreted as a
+<h5><a name="d0e2835" id="d0e2835" shape="rect"/>5.3.3.2 Relative selector</h5><p>A relative selector <a href="#rfc-keywords" shape="rect">MUST</a> be interpreted as a
selector as defined in <a title="Selectors Level
 3" href="#css3-selectors" shape="rect">[Selectors Level 3]</a>. A selector is
not evaluated against the complete document tree but only against subtrees rooted at
nodes selected by the selector in the <code class="its-attr-markup">selector</code> attribute.</p></div></div><div class="div3">
-<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="d0e2830" id="d0e2830" shape="rect"/>5.3.4 Additional query languages</h4><p>ITS processors <a href="#rfc-keywords" shape="rect">MAY</a> support additional query
+<h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="d0e2848" id="d0e2848" shape="rect"/>5.3.4 Additional query languages</h4><p>ITS processors <a href="#rfc-keywords" shape="rect">MAY</a> support additional query
languages. For each additional query language the processor <a href="#rfc-keywords" shape="rect">MUST</a> define:</p><ul><li><p>the identifier of the query language used in <code class="its-attr-markup">queryLanguage</code>;</p></li><li><p>rules for evaluating an absolute selector to a collection of nodes;</p></li><li><p>rules for evaluating a relative selector to a collection of nodes.</p></li></ul><p>Because future versions of this specification are likely to define additional query
languages, the following query language identifiers are reserved: <code>xpath</code>,
<code>css</code>, <code>xpath2</code>, <code>xpath3</code>, <code>xquery</code>,
@@ -855,7 +883,7 @@
the <code class="its-elem-markup">param</code> elements. Such means are implementation-specific.</p><p>The <code class="its-elem-markup">param</code> element has a required <code class="its-attr-markup">name</code> attribute. The value of the
<code class="its-attr-markup">name</code> attribute is a <a href="http://www.w3.org/TR/2009/REC-xml-names-20091208/#NT-QName" shape="rect">QName</a>, see
<a title="Namespaces in XML
 (Second Edition)" href="#xmlns" shape="rect">[XML Names]</a>. The content of the element is a string used as
- default value for the corresponding variable.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-param-in-global-rules-1" id="EX-param-in-global-rules-1" shape="rect"/>Example 14: Using the <code class="its-elem-markup">param</code> element to define the default value of a variable in a
+ default value for the corresponding variable.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-param-in-global-rules-1" id="EX-param-in-global-rules-1" shape="rect"/>Example 15: Using the <code class="its-elem-markup">param</code> element to define the default value of a variable in a
<code class="its-attr-markup">selector</code> attribute.</div><p>The <code class="its-elem-markup">param</code> element defines the default value for the <code>$LCID</code>
variable. In this case, only the <code>msg</code> element with the attribute
<code>lcid</code> set to "0x049" is seen as translatable.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><doc</strong> <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">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">></strong>
@@ -880,7 +908,7 @@
root element or be located anywhere within the document tree (for example, the document
could be an XML Schema).</p><p>The rules contained in the referenced document <a href="#rfc-keywords" shape="rect">MUST</a>
be processed as if they were at the top of the <code class="its-elem-markup">rules</code> element with the XLink
- <code class="its-attr-markup">href</code> attribute.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-link-external-rules-1" id="EX-link-external-rules-1" shape="rect"/>Example 15: External file EX-link-external-rules-1.xml with global rules:</div><p>The example demonstrates how metadata can be added to ITS rules.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><myFormatInfo></strong>
+ <code class="its-attr-markup">href</code> attribute.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-link-external-rules-1" id="EX-link-external-rules-1" shape="rect"/>Example 16: External file EX-link-external-rules-1.xml with global rules:</div><p>The example demonstrates how metadata can be added to ITS rules.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><myFormatInfo></strong>
<strong class="hl-tag" style="color: #000096"><desc></strong>ITS rules used by the Open University<strong class="hl-tag" style="color: #000096"></desc></strong>
<strong class="hl-tag" style="color: #000096"><hostVoc></strong>http://www.tei-c.org/ns/1.0<strong class="hl-tag" style="color: #000096"></hostVoc></strong>
<strong class="hl-tag" style="color: #000096"><rulesId></strong>98ECED99DF63D511B1250008C784EFB1<strong class="hl-tag" style="color: #000096"></rulesId></strong>
@@ -894,7 +922,7 @@
<strong class="hl-tag" style="color: #000096"></its:rules></strong>
<strong class="hl-tag" style="color: #000096"></myFormatInfo></strong>

-</pre></div><p>[Source file: <a href="examples/xml/EX-link-external-rules-1.xml" shape="rect">examples/xml/EX-link-external-rules-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-link-external-rules-2" id="EX-link-external-rules-2" shape="rect"/>Example 16: Document with a link to EX-link-external-rules-1.xml</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><myDoc></strong>
+</pre></div><p>[Source file: <a href="examples/xml/EX-link-external-rules-1.xml" shape="rect">examples/xml/EX-link-external-rules-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-link-external-rules-2" id="EX-link-external-rules-2" shape="rect"/>Example 17: Document with a link to EX-link-external-rules-1.xml</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><myDoc></strong>
<strong class="hl-tag" style="color: #000096"><header></strong>
<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: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-link-external-rules-1.xml"</span><strong class="hl-tag" style="color: #000096">></strong>
@@ -908,7 +936,7 @@
<strong class="hl-tag" style="color: #000096"></body></strong>
<strong class="hl-tag" style="color: #000096"></myDoc></strong>
</pre></div><p>[Source file: <a href="examples/xml/EX-link-external-rules-2.xml" shape="rect">examples/xml/EX-link-external-rules-2.xml</a>]</p></div><p>The result of processing the two documents above is the same as processing the
- following document.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-link-external-rules-3" id="EX-link-external-rules-3" shape="rect"/>Example 17: Document with identical rules as in the case of included rules</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><myDoc></strong>
+ following document.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-link-external-rules-3" id="EX-link-external-rules-3" shape="rect"/>Example 18: Document with identical rules as in the case of included rules</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><myDoc></strong>
<strong class="hl-tag" style="color: #000096"><header></strong>
<strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><its:translateRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//header"</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>
@@ -924,9 +952,9 @@
<strong class="hl-tag" style="color: #000096"><p></strong>A <strong class="hl-tag" style="color: #000096"><term></strong>Palouse horse<strong class="hl-tag" style="color: #000096"></term></strong> has a spotted coat.<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"></myDoc></strong>
-</pre></div><p>[Source file: <a href="examples/xml/EX-link-external-rules-3.xml" shape="rect">examples/xml/EX-link-external-rules-3.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-link-external-rules-4" id="EX-link-external-rules-4" shape="rect"/>Example 18: External rules file with the <code class="its-elem-markup">rules</code> element as the root element</div><p>As with <a href="#EX-link-external-rules-1" shape="rect">Example 15</a>, these rules can be
- applied to <a href="#EX-link-external-rules-2" shape="rect">Example 16</a>. The only difference
- is that in <a href="#EX-link-external-rules-4" shape="rect">Example 18</a>, the <code class="its-elem-markup">rules</code>
+</pre></div><p>[Source file: <a href="examples/xml/EX-link-external-rules-3.xml" shape="rect">examples/xml/EX-link-external-rules-3.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-link-external-rules-4" id="EX-link-external-rules-4" shape="rect"/>Example 19: External rules file with the <code class="its-elem-markup">rules</code> element as the root element</div><p>As with <a href="#EX-link-external-rules-1" shape="rect">Example 16</a>, these rules can be
+ applied to <a href="#EX-link-external-rules-2" shape="rect">Example 17</a>. The only difference
+ is that in <a href="#EX-link-external-rules-4" shape="rect">Example 19</a>, the <code class="its-elem-markup">rules</code>
element is the root element of the external file.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><its:translateRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//header"</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:translateRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//term"</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>
@@ -936,9 +964,9 @@
</pre></div><p>[Source file: <a href="examples/xml/EX-link-external-rules-4.xml" shape="rect">examples/xml/EX-link-external-rules-4.xml</a>]</p></div><p>Applications processing global ITS markup <a href="#rfc-keywords" shape="rect">MUST</a>
recognize the XLink <code class="its-attr-markup">href</code> attribute in the <code class="its-elem-markup">rules</code> element; they <a href="#rfc-keywords" shape="rect">MUST</a> load the corresponding referenced document and
process its rules element before processing the content of the <code class="its-elem-markup">rules</code> element
- where the original XLink <code class="its-attr-markup">href</code> attribute is.</p><p>External rules may also have links to other external rules (see <a href="#EX-link-external-rules-2" shape="rect">Example 16</a>). The linking mechanism is recursive
+ where the original XLink <code class="its-attr-markup">href</code> attribute is.</p><p>External rules may also have links to other external rules (see <a href="#EX-link-external-rules-2" shape="rect">Example 17</a>). The linking mechanism is recursive
in a depth-first approach, and subsequently after the processing the rules MUST be read
- top-down (see <a href="#EX-link-external-rules-3" shape="rect">Example 17</a>).</p></div><div class="div2">
+ top-down (see <a href="#EX-link-external-rules-3" shape="rect">Example 18</a>).</p></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="selection-precedence" id="selection-precedence" shape="rect"/>5.5 Precedence between Selections</h3><p>The following precedence order is defined for selections of ITS information in various
positions (the first item in the list has the highest precedence):</p><ol class="depth1"><li><p>Selection via explicit (i.e., not inherited) local ITS
markup in documents (<a href="#local-attributes" shape="rect">ITS local attributes</a> on a
@@ -952,7 +980,7 @@
precedence.</p><div class="note"><p class="prefix"><b>Note:</b></p><p>The precedence order fulfills the same purpose as the built-in template rules of <a title="XSL Transformations (XSLT)
 Version 1.0" href="#xslt10" shape="rect">[XSLT 1.0]</a>. Override semantics are always complete, that is
all information provided via lower precedence is overriden by the higher precedence.
E.g. defaults are overridden by inherited values and these are overriden by nodes
- selected via global rules, which are in turn overridden by local markup.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-selection-precedence-1" id="EX-selection-precedence-1" shape="rect"/>Example 19: Conflicts between selections of ITS information resolved using the precedence
+ selected via global rules, which are in turn overridden by local markup.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-selection-precedence-1" id="EX-selection-precedence-1" shape="rect"/>Example 20: Conflicts between selections of ITS information resolved using the precedence
order</div><p>The two elements <code>title</code> and <code>author</code> of this document should
be treated as separate content when inside a <code>prolog</code> element, but in other
contexts as part of the content of their parent element. In order to make this
@@ -981,7 +1009,7 @@
expectations of the host markup are the same as, or greater than, those of ITS. For
example, the <a title="OASIS
 Darwin Information Typing Architecture (DITA) Language Specification
 v1.0" href="#dita10" shape="rect">[DITA 1.0]</a> format can use its translate
attribute to apply to “transcluded” content, going beyond the ITS 2.0 local selection
- mechanism, but not contradicting it.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-associating-its-with-existing-markup-1" id="EX-associating-its-with-existing-markup-1" shape="rect"/>Example 20: Association of the ITS data categories <a href="#trans-datacat" shape="rect">
+ mechanism, but not contradicting it.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-associating-its-with-existing-markup-1" id="EX-associating-its-with-existing-markup-1" shape="rect"/>Example 21: Association of the ITS data categories <a href="#trans-datacat" shape="rect">
Translate</a> and <a href="#terminology" shape="rect">Terminology</a> with DITA 1.0
markup</div><p>In this example, there is an existing <code>translate</code> attribute in DITA, and
it is associated with the ITS semantics using the its:rules section. Similarly, the
@@ -1013,8 +1041,8 @@
<strong class="hl-tag" style="color: #000096"><p></strong><strong class="hl-tag" style="color: #000096"><ph</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">xml:lang</span>=<span class="hl-value" style="color: #993300">"fr"</span><strong class="hl-tag" style="color: #000096">></strong>Et voilà !<strong class="hl-tag" style="color: #000096"></ph></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"></topic></strong>
-</pre></div><p>[Source file: <a href="examples/xml/EX-associating-its-with-existing-markup-1.xml" shape="rect">examples/xml/EX-associating-its-with-existing-markup-1.xml</a>]</p></div><p>Global rules can be associated with a given XML document using different means:</p><ul><li><p>By using an <code class="its-elem-markup">rules</code> element in the document itself:</p><ul><li><p>with the rules directly inside the document, as shown in <a href="#EX-associating-its-with-existing-markup-1" shape="rect">Example 20</a></p></li><li><p>with a link to an external rules file using the XLink <code class="its-attr-markup">href</code>
- attribute, as shown in <a href="#EX-link-external-rules-1" shape="rect">Example 15</a></p></li></ul></li><li><p>By associating the rules and the document through a tool-specific mechanism. For
+</pre></div><p>[Source file: <a href="examples/xml/EX-associating-its-with-existing-markup-1.xml" shape="rect">examples/xml/EX-associating-its-with-existing-markup-1.xml</a>]</p></div><p>Global rules can be associated with a given XML document using different means:</p><ul><li><p>By using an <code class="its-elem-markup">rules</code> element in the document itself:</p><ul><li><p>with the rules directly inside the document, as shown in <a href="#EX-associating-its-with-existing-markup-1" shape="rect">Example 21</a></p></li><li><p>with a link to an external rules file using the XLink <code class="its-attr-markup">href</code>
+ attribute, as shown in <a href="#EX-link-external-rules-1" shape="rect">Example 16</a></p></li></ul></li><li><p>By associating the rules and the document through a tool-specific mechanism. For
example, in the case of a command-line tool by providing the paths of both the XML
document to process and its corresponding external rules file.</p></li></ul></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="conversion-to-nif" id="conversion-to-nif" shape="rect"/>5.7 Conversion to NIF</h3><p>This section defines an algorithm to convert XML or HTML documents (or their DOM
@@ -1027,7 +1055,7 @@
algorithm itself is format dependent (for example, it differs for HTML compared to
general XML), no normative algorithm for whitespace normalization is given as part of
this specification.</p></div><div class="note"><p class="prefix"><b>Note:</b></p><p id="its-rdf-ontology-status">The output of the algorithm shown below uses the ITS RDF ontology <a title="ITS RDF Ontology" href="#its-rdf-ontology" shape="rect">[ITS RDF]</a> and its namespace<br clear="none"/><a href="http://www.w3.org/2005/11/its/rdf#" shape="rect">http://www.w3.org/2005/11/its/rdf#</a>
- <br clear="none"/>This ontology is not a normative part of the ITS 2.0 specification and is being discussed in the <a href="http://www.w3.org/International/its/wiki/ITS-RDF_mapping" shape="rect">ITS Interest Group</a>.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-HTML-whitespace-normalization" id="EX-HTML-whitespace-normalization" shape="rect"/>Example 21: Example (see <a href="examples/html5/EX-HTML-whitespace-normalization.html" shape="rect">source code</a>) of an HTML document with whitespace character normalization as preparation for the conversion to NIF</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><html></strong><strong class="hl-tag" style="color: #000096"><body></strong><strong class="hl-tag" style="color: #000096"><h2</strong> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"yes"</span><strong class="hl-tag" style=color: #000096">></strong>Welcome to <strong class="hl-tag" style="color: #000096"><span</strong>
+ <br clear="none"/>This ontology is not a normative part of the ITS 2.0 specification and is being discussed in the <a href="http://www.w3.org/International/its/wiki/ITS-RDF_mapping" shape="rect">ITS Interest Group</a>.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-HTML-whitespace-normalization" id="EX-HTML-whitespace-normalization" shape="rect"/>Example 22: Example (see <a href="examples/html5/EX-HTML-whitespace-normalization.html" shape="rect">source code</a>) of an HTML document with whitespace character normalization as preparation for the conversion to NIF</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><html></strong><strong class="hl-tag" style="color: #000096"><body></strong><strong class="hl-tag" style="color: #000096"><h2</strong> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"yes"</span><strong class="hl-tag" style=color: #000096">></strong>Welcome to <strong class="hl-tag" style="color: #000096"><span</strong>
<span class="hl-attribute" style="color: #F5844C">its-ta-ident-ref</span>=<span class="hl-value" style="color: #993300">"http://dbpedia.org/resource/Dublin"</span> <span class="hl-attribute" style="color: #F5844C">its-within-text</span>=<span class="hl-value" style="color: #993300">"yes"</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>Dublin<strong class="hl-tag" style="color: #000096"></span></strong> in <strong class="hl-tag" style="color: #000096"><b</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">its-within-text</span>=<span class="hl-value" style="color: #993300">"yes"</span><strong class="hl-tag" style="color: #000096">></strong>Ireland<strong class="hl-tag" style="color: #000096"></b></strong>!<strong class="hl-tag" style="color: #000096"></h2></strong><strong class="hl-tag" style="color: #000096"></body></strong><strong class="hl-tag" style="color: #000096"></html></strong></pre></div></div><p id="its2nif-algorithm">The conversion algorithm to generate NIF consists of seven
steps.</p><ul><li><p id="its2nif-algorithm-step1">STEP 1: Get an ordered list of all text nodes
@@ -1120,7 +1148,7 @@
nif:endIndex "28" ;
itsrdf:translate "no";
nif:referenceContext <http://example.com/exampledoc.html#char=0,29> .
-</pre></div></div><p>A complete sample output in RDF/XML format after step 7, given the input document <a href="#EX-HTML-whitespace-normalization" shape="rect">Example 21</a>, is available at <a href="examples/nif/EX-nif-conversion-output.xml" shape="rect">examples/nif/EX-nif-conversion-output.xml</a>.</p><div class="note"><p class="prefix"><b>Note:</b></p><p>The conversion to NIF is a possible basis for a natural language processing (NLP) application
+</pre></div></div><p>A complete sample output in RDF/XML format after step 7, given the input document <a href="#EX-HTML-whitespace-normalization" shape="rect">Example 22</a>, is available at <a href="examples/nif/EX-nif-conversion-output.xml" shape="rect">examples/nif/EX-nif-conversion-output.xml</a>.</p><div class="note"><p class="prefix"><b>Note:</b></p><p>The conversion to NIF is a possible basis for a natural language processing (NLP) application
that creates, for example, named entity annotations. A non-normative algorithm to
integrate these annotations into the original input document is given in <a class="section-ref" href="#nif-backconversion" shape="rect">Appendix F: Conversion NIF2ITS</a>. This algorithm is non-normative
because many decisions depend on the particular NLP application being used.</p></div></div><div class="div2">
@@ -1166,7 +1194,7 @@
children elements) and to the attributes of that element.</p><p>On any given node, the information provided by this mechanism is a space-separated list
of the accumulated references found in the <code class="its-attr-markup">annotatorsRef</code> attributes declared
in the enclosing elements and sorted by data category identifiers. For each data
- category, the IRI part is the one of the inner-most declaration.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-tool-annotation-1" id="EX-its-tool-annotation-1" shape="rect"/>Example 22: Accumulation and Overriding of the <code class="its-attr-markup">annotatorsRef</code> Values</div><p>In this example, the text shows the computed tools reference information for the
+ category, the IRI part is the one of the inner-most declaration.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-tool-annotation-1" id="EX-its-tool-annotation-1" shape="rect"/>Example 23: Accumulation and Overriding of the <code class="its-attr-markup">annotatorsRef</code> Values</div><p>In this example, the text shows the computed tools reference information for the
given node. Note that the references are ordered alphabetically and that the IRI
values are always the ones of the inner-most declaration.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><doc</strong> <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">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:annotatorsRef</span>=<span class="hl-value" style="color: #993300">"mt-confidence|MT1"</span><strong class="hl-tag" style="color: #000096">
@@ -1184,7 +1212,7 @@
<strong class="hl-tag" style="color: #000096"><p</strong> <span class="hl-attribute" style="color: #F5844C">its:annotatorsRef</span>=<span class="hl-value" style="color: #993300">"text-analysis|XYZ"</span><strong class="hl-tag" style="color: #000096">
></strong>This p node: "text-analysis|XYZ mt-confidence|MT1"<strong class="hl-tag" style="color: #000096"></p></strong>
<strong class="hl-tag" style="color: #000096"></doc></strong>
-</pre></div><p>[Source file: <a href="examples/xml/EX-its-tool-annotation-1.xml" shape="rect">examples/xml/EX-its-tool-annotation-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-tool-annotation-2" id="EX-its-tool-annotation-2" shape="rect"/>Example 23: Example of ITS Tools Annotation</div><p>The <code class="its-attr-markup">annotatorsRef</code> attribute is used in this XML document to indicate that
+</pre></div><p>[Source file: <a href="examples/xml/EX-its-tool-annotation-1.xml" shape="rect">examples/xml/EX-its-tool-annotation-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-tool-annotation-2" id="EX-its-tool-annotation-2" shape="rect"/>Example 24: Example of ITS Tools Annotation</div><p>The <code class="its-attr-markup">annotatorsRef</code> attribute is used in this XML document to indicate that
information about the processor that generated the <code class="its-attr-markup">mtConfidence</code> values for
the first two <code>p</code> elements are found in element with <code>id="T1"</code>
in the external document tools.xml, while that information for the third
@@ -1200,7 +1228,7 @@
<strong class="hl-tag" style="color: #000096"><p</strong> <span class="hl-attribute" style="color: #F5844C">its:mtConfidence</span>=<span class="hl-value" style="color: #993300">"0.34"</span> <span class="hl-attribute" style="color: #F5844C">its:annotatorsRef</span>=<span class="hl-value" style="color: #993300">"mt-confidence|file:///tools.xml#T2"</span><strong class="hl-tag" style="color: #000096">></strong> Text translated
with tool T2<strong class="hl-tag" style="color: #000096"></p></strong>
<strong class="hl-tag" style="color: #000096"></doc></strong>
-</pre></div><p>[Source file: <a href="examples/xml/EX-its-tool-annotation-2.xml" shape="rect">examples/xml/EX-its-tool-annotation-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-tool-annotation-html5-1" id="EX-its-tool-annotation-html5-1" shape="rect"/>Example 24: Example of ITS Tool Annotation</div><p>The <code class="its-attr-markup">its-annotators-ref</code> attributes are used in this HTML document to
+</pre></div><p>[Source file: <a href="examples/xml/EX-its-tool-annotation-2.xml" shape="rect">examples/xml/EX-its-tool-annotation-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-tool-annotation-html5-1" id="EX-its-tool-annotation-html5-1" shape="rect"/>Example 25: Example of ITS Tool Annotation</div><p>The <code class="its-attr-markup">its-annotators-ref</code> attributes are used in this HTML document to
indicate that the <a href="#mtconfidence" shape="rect">MT Confidence</a> annotation on the
first two <code>span</code> elements come from one MT (French to English) engine,
while the annotation on the third comes from another (Italian to English) engine. Both
@@ -1236,8 +1264,8 @@
the following rules:</p><ol class="depth1"><li><p>The attribute name is prefixed with <code>its-</code></p></li><li><p>Each uppercase letter in the attribute name is replaced by <code>-</code>
(U+002D) followed by a lowercase variant of the letter.</p></li></ol><p>
</p><p>
- <a href="#EX-within-text-local-1" shape="rect">Example 48</a> demonstrates the <a href="#elements-within-text" shape="rect">Elements Within Text</a> data category with the local
- XML attribute <code class="its-attr-markup">withinText</code>. <a href="#EX-within-text-local-html5-1" shape="rect">Example 49</a> demonstrates the counterpart in HTML, i.e.,
+ <a href="#EX-within-text-local-1" shape="rect">Example 49</a> demonstrates the <a href="#elements-within-text" shape="rect">Elements Within Text</a> data category with the local
+ XML attribute <code class="its-attr-markup">withinText</code>. <a href="#EX-within-text-local-html5-1" shape="rect">Example 50</a> demonstrates the counterpart in HTML, i.e.,
the local attribute <code class="its-attr-markup">its-within-text</code>.</p><p>Values of attributes which corresponds to data categories with a predefined set of
values <a href="#rfc2119" shape="rect">MUST</a> be matched ASCII-case-insensitively. </p><div class="note"><p class="prefix"><b>Note:</b></p><p>Case of attribute names is also irrelevant given the nature of HTML syntax. So in HTML the <a href="#terminology" shape="rect">terminology data category</a> can be stored as
<code class="its-attr-markup">its-term</code>, <code>ITS-TERM</code>, <code>its-Term</code> etc. All of those
@@ -1287,7 +1315,7 @@
<em>This section is normative.</em>
</p><p>XHTML documents aimed at public consumption by Web browsers, including HTML5 documents in
XHTML syntax, <a href="#rfc2119" shape="rect">SHOULD</a> use the syntax described in <a class="section-ref" href="#html5-markup" shape="rect">Section 6: Using ITS Markup in HTML</a> in order to adhere to <a href="http://www.w3.org/TR/html-design-principles/#dom-consistency" shape="rect">DOM Consistency
- HTML Design Principle</a>.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-xhtml-markup-1" id="EX-xhtml-markup-1" shape="rect"/>Example 25: Using ITS 2.0 markup in XHTML</div><p>This examples illustrates the use of ITS 2.0 local markup in XHTML.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: blue"><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"></strong>
+ HTML Design Principle</a>.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-xhtml-markup-1" id="EX-xhtml-markup-1" shape="rect"/>Example 26: Using ITS 2.0 markup in XHTML</div><p>This examples illustrates the use of ITS 2.0 local markup in XHTML.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: blue"><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"></strong>
<strong class="hl-tag" style="color: #000096"><html</strong> <span class="hl-attribute" style="color: #F5844C">xmlns</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/1999/xhtml"</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"><head></strong>
<strong class="hl-tag" style="color: #000096"><title></strong>XHTML and ITS2.0<strong class="hl-tag" style="color: #000096"></title></strong>
@@ -1333,7 +1361,7 @@
via <a href="#idvalue" shape="rect">ID Value</a> pertains only to the <code>p</code>
element. It cannot be used to identify nested elements or attributes.</p></li><li><p>Using <a href="#target-pointer" shape="rect">target pointer</a>, selected
<code>source</code> elements have the ITS information that their translation is
- available in a <code>target</code> element; see <a href="#EX-target-pointer-global-1" shape="rect">Example 65</a>. This information does not
+ available in a <code>target</code> element; see <a href="#EX-target-pointer-global-1" shape="rect">Example 66</a>. This information does not
inherit to child elements of <code>target pointer</code>. E.g., the translation of a
<code>span</code> element nested in <code>source</code> is not available in a
specific <code>target</code> element. Nevertheless, an application is free to use
@@ -1425,7 +1453,7 @@
</td></tr><tr><td rowspan="1" colspan="1">
<a href="#storagesize" shape="rect">Storage Size</a> (<code>storage-size</code>) </td><td rowspan="1" colspan="1">Yes</td><td rowspan="1" colspan="1">Yes</td><td rowspan="1" colspan="1">Yes</td><td rowspan="1" colspan="1">Yes</td><td rowspan="1" colspan="1">None</td><td rowspan="1" colspan="1">None</td><td rowspan="1" colspan="1">
<a href="#EX-storageSize-local-1" shape="rect">local</a>, <a href="#EX-storageSize-global-1" shape="rect">global</a>
- </td></tr></tbody></table><div class="exampleOuter"><div class="exampleHeader"><a name="EX-datacat-behavior-1" id="EX-datacat-behavior-1" shape="rect"/>Example 26: Defaults, inheritance and overriding behavior of data categories</div><p>In this example, the content of all the <code>data</code> elements is translatable and none of the attributes are translatable, because the default for the <a href="#trans-datacat" shape="rect">Translate</a> data category in elements is "yes" and in attributes is "no", and neither of their values are overridden at all. The first <code class="its-elem-markup">translateRule</code> is overridden by the local <code>its:translate="no"</code> attribute. The content of <code>revision</code>, <code>profile</code>, <code>reviser</code> and <code>locNote</code> elements are not translatable. This is because the default is overridden by the same <code>its:translate="no"</code> that these elements inherit from the local ITS markup in the <code>prolog</code> elemen. The exception is the <code>field</code> element where the second <code class="its-elem-markup">translateRule</code> takes precedence over the inherited value. The last <code class="its-elem-markup">translateRule</code> indicates that the content of <code>type</code> is not translatable because the global rule takes precedence over the default value.</p><p>The localization note for the two first <code>data</code> elements is the text defined globally with the <code class="its-elem-markup">locNoteRule</code> element. This note is overridden for the last <code>data</code> element by the local <code class="its-attr-markup">locNote</code> attribute.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><Res</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" styl="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong>
+ </td></tr></tbody></table><div class="exampleOuter"><div class="exampleHeader"><a name="EX-datacat-behavior-1" id="EX-datacat-behavior-1" shape="rect"/>Example 27: Defaults, inheritance and overriding behavior of data categories</div><p>In this example, the content of all the <code>data</code> elements is translatable and none of the attributes are translatable, because the default for the <a href="#trans-datacat" shape="rect">Translate</a> data category in elements is "yes" and in attributes is "no", and neither of their values are overridden at all. The first <code class="its-elem-markup">translateRule</code> is overridden by the local <code>its:translate="no"</code> attribute. The content of <code>revision</code>, <code>profile</code>, <code>reviser</code> and <code>locNote</code> elements are not translatable. This is because the default is overridden by the same <code>its:translate="no"</code> that these elements inherit from the local ITS markup in the <code>prolog</code> elemen. The exception is the <code>field</code> element where the second <code class="its-elem-markup">translateRule</code> takes precedence over the inherited value. The last <code class="its-elem-markup">translateRule</code> indicates that the content of <code>type</code> is not translatable because the global rule takes precedence over the default value.</p><p>The localization note for the two first <code>data</code> elements is the text defined globally with the <code class="its-elem-markup">locNoteRule</code> element. This note is overridden for the last <code>data</code> element by the local <code class="its-attr-markup">locNote</code> attribute.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><Res</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" styl="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><prolog</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"><revision></strong>Sep-07-2006<strong class="hl-tag" style="color: #000096"></revision></strong>
<strong class="hl-tag" style="color: #000096"><profile></strong>
@@ -1474,7 +1502,7 @@
<code><its:translateRule selector=""//h:img" translate="yes"/></code> will set the <code>img</code> element and its translatable attributes like <code>alt</code> to "yes".</p></div><p id="translate-global">GLOBAL: The <code class="its-elem-markup">translateRule</code> element contains the
following:</p><ul><li><p>A required <code class="its-attr-markup">selector</code> attribute. It contains an <a href="#selectors" shape="rect">absolute selector</a> that selects the nodes to which this
rule applies.</p></li><li><p>A required <code class="its-attr-markup">translate</code> attribute with the value
- "yes" or "no".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translate-selector-1" id="EX-translate-selector-1" shape="rect"/>Example 27: The <a href="#trans-datacat" shape="rect">Translate</a> data category expressed
+ "yes" or "no".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translate-selector-1" id="EX-translate-selector-1" shape="rect"/>Example 28: The <a href="#trans-datacat" shape="rect">Translate</a> data category expressed
globally</div><p>The <code class="its-elem-markup">translateRule</code> element specifies that the elements <code>code</code>
must not be translated.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><its:translateRule</strong> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"no"</span> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//code"</span><strong class="hl-tag" style="color: #000096">/></strong>
@@ -1486,13 +1514,13 @@
data category settings of attributes using local markup. This limitation is
consistent with the advised practice of not using translatable attributes. If
attributes need to be translatable, then
- this must be declared globally. Note that this restriciption does not apply to <a href="#html5-translate-handling" shape="rect">HTML5</a>.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translate-selector-2" id="EX-translate-selector-2" shape="rect"/>Example 28: The <a href="#trans-datacat" shape="rect">Translate</a> data category expressed
+ this must be declared globally. Note that this restriciption does not apply to <a href="#html5-translate-handling" shape="rect">HTML5</a>.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translate-selector-2" id="EX-translate-selector-2" shape="rect"/>Example 29: The <a href="#trans-datacat" shape="rect">Translate</a> data category expressed
locally</div><p>The local <code>its:translate="no"</code> specifies that the content of
<code>panelmsg</code> must not be translated.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><messages</strong> <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">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><msg</strong> <span class="hl-attribute" style="color: #F5844C">num</span>=<span class="hl-value" style="color: #993300">"123"</span><strong class="hl-tag" style="color: #000096">></strong>Click Resume Button on Status Display or <strong class="hl-tag" style="color: #000096"><panelmsg</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>CONTINUE<strong class="hl-tag" style="color: #000096"></panelmsg></strong> Button on printer panel<strong class="hl-tag" style="color: #000096"></msg></strong>
<strong class="hl-tag" style="color: #000096"></messages></strong>
-</pre></div><p>[Source file: <a href="examples/xml/EX-translate-selector-2.xml" shape="rect">examples/xml/EX-translate-selector-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translate-html5" id="EX-translate-html5" shape="rect"/>Example 29: The <a href="#trans-datacat" shape="rect">Translate</a> data category expressed locally
+</pre></div><p>[Source file: <a href="examples/xml/EX-translate-selector-2.xml" shape="rect">examples/xml/EX-translate-selector-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translate-html5" id="EX-translate-html5" shape="rect"/>Example 30: The <a href="#trans-datacat" shape="rect">Translate</a> data category expressed locally
in HTML</div><p>The local <code>translate="no"</code> attribute specifies that the content of
<code>span</code> must not be translated.</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>
@@ -1529,7 +1557,7 @@
"description" or "alert".</p></li><li><p>Exactly one of the following:</p><ul><li><p>A <code class="its-elem-markup">locNote</code> element that contains the note itself and allows for <a href="#selection-local" shape="rect">local ITS markup</a>.</p></li><li><p>A <code class="its-attr-markup">locNotePointer</code> attribute that contains a <a href="#selectors" shape="rect">relative selector</a> pointing to a node that holds the
localization note.</p></li><li><p>A <code class="its-attr-markup">locNoteRef</code> attribute that contains an IRI referring to the
location of the localization note.</p></li><li><p>A <code class="its-attr-markup">locNoteRefPointer</code> attribute that contains a <a href="#selectors" shape="rect">relative selector</a> pointing to a node that holds the
- IRI referring to the location of the localization note.</p></li></ul></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locNote-element-1" id="EX-locNote-element-1" shape="rect"/>Example 30: The <code class="its-elem-markup">locNote</code> element</div><p>The <code class="its-elem-markup">locNoteRule</code> element associates the content of the <code class="its-elem-markup">locNote</code>
+ IRI referring to the location of the localization note.</p></li></ul></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locNote-element-1" id="EX-locNote-element-1" shape="rect"/>Example 31: The <code class="its-elem-markup">locNote</code> element</div><p>The <code class="its-elem-markup">locNoteRule</code> element associates the content of the <code class="its-elem-markup">locNote</code>
element with the message with the identifier 'DisableInfo' and flags it as
important. This would also work if the rule is in an external file, allowing it to
provide notes without modifying the source document.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><myRes></strong>
@@ -1544,7 +1572,7 @@
<strong class="hl-tag" style="color: #000096"><body></strong>
<strong class="hl-tag" style="color: #000096"><msg</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"DisableInfo"</span><strong class="hl-tag" style="color: #000096">></strong>The {0} has been disabled.<strong class="hl-tag" style="color: #000096"></msg></strong>
<strong class="hl-tag" style="color: #000096"></body></strong>
-<strong class="hl-tag" style="color: #000096"></myRes></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locNote-element-1.xml" shape="rect">examples/xml/EX-locNote-element-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locNotePointer-attribute-1" id="EX-locNotePointer-attribute-1" shape="rect"/>Example 31: The <code class="its-attr-markup">locNotePointer</code> attribute</div><p>The <code class="its-attr-markup">locNotePointer</code> attribute is a <a href="#selectors" shape="rect">relative
+<strong class="hl-tag" style="color: #000096"></myRes></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locNote-element-1.xml" shape="rect">examples/xml/EX-locNote-element-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locNotePointer-attribute-1" id="EX-locNotePointer-attribute-1" shape="rect"/>Example 32: The <code class="its-attr-markup">locNotePointer</code> attribute</div><p>The <code class="its-attr-markup">locNotePointer</code> attribute is a <a href="#selectors" shape="rect">relative
selector</a> pointing to a node that holds the note.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><Res></strong>
<strong class="hl-tag" style="color: #000096"><prolog></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>
@@ -1562,7 +1590,7 @@
<strong class="hl-tag" style="color: #000096"><data></strong>Invalid parameter.<strong class="hl-tag" style="color: #000096"></data></strong>
<strong class="hl-tag" style="color: #000096"></msg></strong>
<strong class="hl-tag" style="color: #000096"></body></strong>
-<strong class="hl-tag" style="color: #000096"></Res></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locNotePointer-attribute-1.xml" shape="rect">examples/xml/EX-locNotePointer-attribute-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locNoteRef-attribute-1" id="EX-locNoteRef-attribute-1" shape="rect"/>Example 32: The <code class="its-attr-markup">locNoteRef</code> attribute</div><p>The <code class="its-elem-markup">locNoteRule</code> element specifies that the message with the identifier
+<strong class="hl-tag" style="color: #000096"></Res></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locNotePointer-attribute-1.xml" shape="rect">examples/xml/EX-locNotePointer-attribute-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locNoteRef-attribute-1" id="EX-locNoteRef-attribute-1" shape="rect"/>Example 33: The <code class="its-attr-markup">locNoteRef</code> attribute</div><p>The <code class="its-elem-markup">locNoteRule</code> element specifies that the message with the identifier
'NotFound' has a corresponding explanation note in an external file. The IRI for the
exact location of the note is stored in the <code class="its-attr-markup">locNoteRef</code>
attribute.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><myRes></strong>
@@ -1575,7 +1603,7 @@
[662 lines skipped]
Received on Monday, 17 June 2013 10:16:14 UTC