- From: CVS User ysavoure <cvsmail@w3.org>
- Date: Wed, 21 Nov 2012 17:54:57 +0000
- To: public-multilingualweb-lt-commits@w3.org
Update of /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20
In directory gil:/tmp/cvs-serv5178
Modified Files:
its20.html its20.odd
Log Message:
Added text/example about toolsRef
--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2012/11/21 15:28:40 1.255
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2012/11/21 17:54:57 1.256
@@ -1241,7 +1241,25 @@
applications, creating 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 H: Conversion NIF2ITS</a>. The algorithm in that appendix is
non-normative since many choices depend on the actual NLP application.</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="its-tool-annotation" id="its-tool-annotation" shape="rect"/>5.8 ITS Tools Annotation</h3><p>In some cases, it may be important for instances of data categories to be associated with information about the processor that generated them. For example, the score of the <a href="#mtconfidence" shape="rect">MT Confidence</a> data category (provided via the <code>mtConfidence</code> attribute) is meaningful only when the consumer of the information also knows what MT engine produced it, because the score provides the relative confidence of translations from the same MT engine but does not provide a score that can be reliably compared between MT engines. The same is true for confidence provided for the <a href="#Disambiguation" shape="rect">Disambiguation</a> data category, providing confidence information via the <code>disambgConfidence</code> attribute, or the <a href="#terminology" shape="rect">Terminology</a> data category, providing confidence information via the <code>termConfidence</code> attribute.</p><p>ITS 2.0 provides a mechanism to associate such processor information with the use of individual data categories in a document, independently from data category annotations themselves.</p><p>The attribute <code>toolsRef</code> provides a way to associates all the annotations of a given data category within the element with information about the processor that generated those data category annotations.</p><p>The value of <code>toolsRef</code> is a space-separated list of references where each reference is composed of two parts: a data category identifier and an IRI. These two parts are separated by a character <code>|</code> VERTICAL LINE (U+007C).</p><p>The data category identifier <a href="#rfc2119" shape="rect">MUST</a> be the data category identifiers defined in this specification.</p><p>The IRI indicates information aout the processor used to generate the data category annotation. No single means is specified for how this IRI should be used to indicate processor information. Possible mechanisms are: to encode information directly in the IRI, e.g. as parameters; to reference an external resource that provides such information, e.g. an XML file or an RDF declaration; or to reference another part of the document that provides such information.</p><p>When a data category annotates a node that is contained within more than one element possessing a <code>toolsRef</code> attribute, only the IRI value from the most immediate enclosing element’s <code>toolsRef</code> attribute shall apply.</p><p>In HTML5 documents, the same mechanism is implemented with the <code>its-tools-ref</code> attribute.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-tool-annotation-1" id="EX-its-tool-annotation-1" shape="rect"/>Example 25: Example of ITS Tool Annotation</div><p>The <code>toolsRef</code> attribute is used in ths XML document to indicate that information about the processor that generated the <code>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 <code>p</code> element is found in the element with <code>id="T2"</code> in the same document. In addition, <code>toolsRef</code> is used to identify a Web resource with information about the QA tool used to generate the <a href="#lqissue" shape="rect">Localization Quality Issue</a> annotation in the document.</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>
+<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="its-tool-annotation" id="its-tool-annotation" shape="rect"/>5.8 ITS Tools Annotation</h3><p>In some cases, it may be important for instances of data categories to be associated with information about the processor that generated them. For example, the score of the <a href="#mtconfidence" shape="rect">MT Confidence</a> data category (provided via the <code>mtConfidence</code> attribute) is meaningful only when the consumer of the information also knows what MT engine produced it, because the score provides the relative confidence of translations from the same MT engine but does not provide a score that can be reliably compared between MT engines. The same is true for confidence provided for the <a href="#Disambiguation" shape="rect">Disambiguation</a> data category, providing confidence information via the <code>disambgConfidence</code> attribute, or the <a href="#terminology" shape="rect">Terminology</a> data category, providing confidence information via the <code>termConfidence</code> attribute.</p><p>ITS 2.0 provides a mechanism to associate such processor information with the use of individual data categories in a document, independently from data category annotations themselves.</p><p>The attribute <code>toolsRef</code> provides a way to associates all the annotations of a given data category within the element with information about the processor that generated those data category annotations.</p><p>The value of <code>toolsRef</code> is a space-separated list of references where each reference is composed of two parts: a data category identifier and an IRI. These two parts are separated by a character <code>|</code> VERTICAL LINE (U+007C).</p><ul><li><p>The data category identifier <a href="#rfc2119" shape="rect">MUST</a> be the data category identifiers defined in this specification.</p></li><li><p>The IRI indicaes information about the processor used to generate the data category annotation. No single means is specified for how this IRI should be used to indicate processor information. Possible mechanisms are: to encode information directly in the IRI, e.g. as parameters; to reference an external resource that provides such information, e.g. an XML file or an RDF declaration; or to reference another part of the document that provides such information.</p></li></ul><p>In HTML5 documents, the mechanism is implemented with the <code>its-tools-ref</code> attribute.</p><p>The attribute applies to the content of the element where it is declared (including its children elements) and to the attributes of that element.</p><p>On any given node, the information provided by this mechanism is a space-separated list of the accumulated references found it the <code>toolsRef</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 declarartion.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d0e2887" id="d0e2887" shape="rect"/>Example 25: Accumulation and Overriding of the <code>toolsRef</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:toolsRef</span>=<span class="hl-value" style="color: #993300">"MTConfidence|MT1"</span><strong class="hl-tag" style="color: #000096">
+></strong>doc node: "MTConfidence|MT1"
+ <strong class="hl-tag" style="color: #000096"><group</strong> <span class="hl-attribute" style="color: #F5844C">its:toolsRef</span>=<span class="hl-value" style="color: #993300">"LocalizationQualityIssue|ABC"</span><strong class="hl-tag" style="color: #000096">
+ ></strong>group node: "LocalizationQualityIssue|ABC MTConfidence|MT1"
+ <strong class="hl-tag" style="color: #000096"><p</strong> <span class="hl-attribute" style="color: #F5844C">its:toolsRef</span>=<span class="hl-value" style="color: #993300">"Disambiguation|Tool3"</span><strong class="hl-tag" style="color: #000096">
+ ></strong>This p node: "Disambiguation|Tool3 LocalizationQualityIssue|ABC MTConfidence|MT1"<strong class="hl-tag" style="color: #000096"></p></strong>
+ <strong class="hl-tag" style="color: #000096"><p</strong> <span class="hl-attribute" style="color: #F5844C">its:toolsRef</span>=<span class="hl-value" style="color: #993300">"MTConfidence|MT123"</span><strong class="hl-tag" style="color: #000096">
+ ></strong>This p node: "Disambiguation|Tool3 LocalizationQualityIssue|ABC MTConfidence|MT123"<strong class="hl-tag" style="color: #000096"></p></strong>
+ <strong class="hl-tag" style="color: #000096"></group></strong>
+ <strong class="hl-tag" style="color: #000096"><p</strong> <span class="hl-attribute" style="color: #F5844C">its:toolsRef</span>=<span class="hl-value" style="color: #993300">"Disambiguation|XYZ"</span><strong class="hl-tag" style="color: #000096">
+ ></strong>This p node: "Disambiguation|XYZ MTConfidence|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-1" id="EX-its-tool-annotation-1" shape="rect"/>Example 26: Example of ITS Tool Annotation</div><p>The <code>toolsRef</code> attribute is used in this XML document to indicate that information about the processor that generated the <code>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 <code>p</code> element is found in the element with <code>id="T2"</code> in the same document. In addition, <code>toolsRef</code> is used to identify a Web
+ resource with information about the QA tool used to generate the <a href="#lqissue" shape="rect">Localization Quality Issue</a> annotation in the document.</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">its:toolsRef</span>=<span class="hl-value" style="color: #993300">"MTConfidence|file:///tools.xml#T1 LocalisationQualityIssue|http://www.qalsp-ex.com/qatools/transcheckv1.3"</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"><p</strong> <span class="hl-attribute" style="color: #F5844C">its:mtConfidence</span>=<span class="hl-value" style="color: #993300">"0.78"</span><strong class="hl-tag" style="color: #000096">></strong>Text translated with tool T1<strong class="hl-tag" style="color: #000096"></p></strong>
@@ -1251,7 +1269,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:toolsRef</span>=<span class="hl-value" style="color: #993300">"MTConfidence|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-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 26: Example of ITS Tool Annotation</div><p>The <code>its-tools-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 <code>its-tools-ref</code> attributes refer to a Web resource for information about the engine generating the <a href="#mtconfidence" shape="rect">MT Confidence</a> annotation.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><html</strong> <span class="hl-attribute" style="color: #F5844C">lang<span>=<span class="hl-value" style="color: #993300">en</span><strong class="hl-tag" style="color: #000096">></strong>
+</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-2" id="EX-its-tool-annotation-2" shape="rect"/>Example 27: Example of ITS Tool Annotation</div><p>The <code>its-tools-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 <code>its-tools-ref</code> attributes refer to a Web resource for information about the engine generating the <a href="#mtconfidence" shape="rect">MT Confidence</a> annotation.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><html</strong> <span class="hl-attribute" style="color: #F5844C">lang<span>=<span class="hl-value" style="color: #993300">en</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><head></strong>
<strong class="hl-tag" style="color: #000096"><meta</strong> <span class="hl-attribute" style="color: #F5844C">charset</span>=<span class="hl-value" style="color: #993300">utf-8</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><title></strong>Sentences about capital cities 
@@ -1296,7 +1314,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> element 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 68</a>. This information does not
+ available in a <code>target</code> element; see <a href="#EX-target-pointer-global-1" shape="rect">Example 69</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
@@ -1422,7 +1440,7 @@
<a href="#storagesize" shape="rect">Storage Size</a>
</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">
<code>storageEncoding="UTF-8"</code>
- </td><td rowspan="1" colspan="1">None</td><td rowspan="1" colspan="1">tbd</td><td rowspan="1" colspan="1">tbd</td></tr></tbody></table><div class="exampleOuter"><div class="exampleHeader"><a name="d0e3718" id="d0e3718" 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
+ </td><td rowspan="1" colspan="1">None</td><td rowspan="1" colspan="1">tbd</td><td rowspan="1" colspan="1">tbd</td></tr></tbody></table><div class="exampleOuter"><div class="exampleHeader"><a name="d0e3735" id="d0e3735" shape="rect"/>Example 28: Defaults, inheritance and overriding behavior of data categories</div><p>In this example, the content of all the <code>data</code> elements is translatable
because the default for the <a href="#trans-datacat" shape="rect">Translate</a> data category
in elements is "yes". The content of <code>revision</code> and <code>locNote</code>
is not translatable because the default is overridden by the local
@@ -1469,7 +1487,7 @@
<em>All</em> selector related definitions has to be update to
reflect queryLanguage]</span><ul><li><p>A required <code>selector</code> attribute. It contains an <a href="#selectors" shape="rect">absolute selector</a> which selects the nodes to which this
rule applies.</p></li><li><p>A required <code>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 28: 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 29: The <a href="#trans-datacat" shape="rect">Translate</a> data category expressed
globally</div><p>The <code>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>
@@ -1479,13 +1497,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 (e.g., an HTML <code>alt</code> attribute), then
- this must be declared globally.</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
+ this must be declared globally.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translate-selector-2" id="EX-translate-selector-2" shape="rect"/>Example 30: 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 30: 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 31: The <a href="#trans-datacat" shape="rect">Translate</a> data category expressed locally
in HTML5</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>
@@ -1522,7 +1540,7 @@
"description" or "alert".</p></li><li><p>Exactly one of the following:</p><ul><li><p>A <code>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>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>locNoteRef</code> attribute that contains an IRI referring to the
location of the localization note.</p></li><li><p>A <code>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 31: The <code>locNote</code> element</div><p>The <code>locNoteRule</code> element associates the content of the <code>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 32: The <code>locNote</code> element</div><p>The <code>locNoteRule</code> element associates the content of the <code>locNote</code>
element with the message with the identifier 'DisableInfo' and flags it as
important. This would also work if the rule was in an external file, allowing 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>
@@ -1537,7 +1555,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 32: The <code>locNotePointer</code> attribute</div><p>The <code>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 33: The <code>locNotePointer</code> attribute</div><p>The <code>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>
@@ -1555,7 +1573,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 33: The <code>locNoteRef</code> attribute</div><p>The <code>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 34: The <code>locNoteRef</code> attribute</div><p>The <code>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>locNoteRef</code>
attribute.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><myRes></strong>
@@ -1568,7 +1586,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">"NotFound"</span><strong class="hl-tag" style="color: #000096">></strong>Cannot find {0} on {1}.<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-locNoteRef-attribute-1.xml" shape="rect">examples/xml/EX-locNoteRef-attribute-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d0e4115" id="d0e4115" shape="rect"/>Example 34: The <code>locNoteRefPointer</code> attribute</div><p>The <code>locNoteRefPointer</code> attribute contains a <a href="#selectors" shape="rect">relative selector</a> pointing to a node that holds the IRI referring to the
+<strong class="hl-tag" style="color: #000096"></myRes></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locNoteRef-attribute-1.xml" shape="rect">examples/xml/EX-locNoteRef-attribute-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d0e4132" id="d0e4132" shape="rect"/>Example 35: The <code>locNoteRefPointer</code> attribute</div><p>The <code>locNoteRefPointer</code> attribute contains a <a href="#selectors" shape="rect">relative selector</a> pointing to a node that holds the IRI referring to the
location of the note.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><dataFile></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>
@@ -1589,7 +1607,7 @@
itself.</p></li><li><p>A <code>locNoteRef</code> attribute that contains an IRI referring
to the location of the localization note.</p></li></ul></li><li><p>An optional <code>locNoteType</code> attribute with the
value"description" or "alert". If the <code>locNoteType</code> attribute is not present, the type of localization note will
- be assumed to be "description".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d0e4176" id="d0e4176" shape="rect"/>Example 35: The <a href="#locNote-datacat" shape="rect">Localization Note</a> data category
+ be assumed to be "description".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d0e4193" id="d0e4193" shape="rect"/>Example 36: The <a href="#locNote-datacat" shape="rect">Localization Note</a> data category
expressed locally</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><msgList</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">xml:space</span>=<span class="hl-value" style="color: #993300">"preserve"</span> <span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"LISTFILTERS_VARIANT"</span> <span class="hl-attribute" style="color: #F5844C">its:locNote</span>=<span class="hl-value" style="color: #993300">"Keep the leading space!"</span> <span class="hl-attribute" style="color: #F5844C">its:locNoteType</span>=<span class="hl-value" style="color: #993300">"alert"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><value></strong> Variant {0} = {1} ({2})<strong class="hl-tag" style="color: #000096"></value></strong>
@@ -1597,7 +1615,7 @@
<strong class="hl-tag" style="color: #000096"><data</strong> <span class="hl-attribute" style="color: #F5844C">its:locNote</span>=<span class="hl-value" style="color: #993300">"%1\$s is the original text's date in the format YYYY-MM-DD HH:MM always in GMT"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><value></strong>Translated from English content dated <strong class="hl-tag" style="color: #000096"><span</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"version-info"</span><strong class="hl-tag" style="color: #000096">></strong>%1\$s<strong class="hl-tag" style="color: #000096"></span></strong> GMT.<strong class="hl-tag" style="color: #000096"></value></strong>
<strong class="hl-tag" style="color: #000096"></data></strong>
-<strong class="hl-tag" style="color: #000096"></msgList></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locNote-selector-2.xml" shape="rect">examples/xml/EX-locNote-selector-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d0e4189" id="d0e4189" shape="rect"/>Example 36: The <a href="#locNote-datacat" shape="rect">Localization Note</a> data category
+<strong class="hl-tag" style="color: #000096"></msgList></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locNote-selector-2.xml" shape="rect">examples/xml/EX-locNote-selector-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d0e4206" id="d0e4206" shape="rect"/>Example 37: The <a href="#locNote-datacat" shape="rect">Localization Note</a> data category
expressed locally in HTML5</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: blue"><!DOCTYPE html></strong>
<strong class="hl-tag" style="color: #000096"><html</strong> <span class="hl-attribute" style="color: #F5844C">lang</span>=<span class="hl-value" style="color: #993300">en</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><head></strong>
@@ -1626,14 +1644,14 @@
"yes" or "no".</p></li><li><p>None or exactly one of the following:</p><ul><li><p>A <code>termInfoPointer</code> attribute that contains a <a href="#selectors" shape="rect">relative selector</a> pointing to a node that holds the
terminology information.</p></li><li><p>A <code>termInfoRef</code> attribute that contains an IRI referring to the
resource providing information about the term.</p></li><li><p>A <code>termInfoRefPointer</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 terminology information.</p></li></ul></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d0e4287" id="d0e4287" shape="rect"/>Example 37: Usage of the <code>termInfoPointer</code> attribute</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><text></strong>
+ IRI referring to the location of the terminology information.</p></li></ul></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d0e4304" id="d0e4304" shape="rect"/>Example 38: Usage of the <code>termInfoPointer</code> attribute</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: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> <span class="hl-attribute" style="color: #F5844C">termInfoPointer</span>=<span class="hl-value" style="color: #993300">"id(@def)"</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"><p></strong>We may define <strong class="hl-tag" style="color: #000096"><term</strong> <span class="hl-attribute" style="color: #F5844C">def</span>=<span class="hl-value" style="color: #993300">"TDPV"</span><strong class="hl-tag" style="color: #000096">></strong>discoursal point of view<strong class="hl-tag" style="color: #000096"></term></strong> as 
<strong class="hl-tag" style="color: #000096"><gloss</strong> <span class="hl-attribute" style="color: #F5844C">xml:id</span>=<span class="hl-value" style="color: #993300">"TDPV"</span><strong class="hl-tag" style="color: #000096">></strong>the relationship, expressed through discourse structure, between the
implied author or some other addresser, and the fiction.<strong class="hl-tag" style="color: #000096"></gloss></strong><strong class="hl-tag" style="color: #000096"></p></strong>
-<strong class="hl-tag" style="color: #000096"></text></strong></pre></div><p>[Source file: <a href="examples/xml/EX-terms-selector-1.xml" shape="rect">examples/xml/EX-terms-selector-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d0e4300" id="d0e4300" shape="rect"/>Example 38: Usage of the <code>termInfoRef</code> attribute</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><text></strong>
+<strong class="hl-tag" style="color: #000096"></text></strong></pre></div><p>[Source file: <a href="examples/xml/EX-terms-selector-1.xml" shape="rect">examples/xml/EX-terms-selector-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d0e4317" id="d0e4317" shape="rect"/>Example 39: Usage of the <code>termInfoRef</code> attribute</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:termRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//term[1]"</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">termInfoRef</span>=<span class="hl-value" style="color: #993300">"#TDPV"</span><strong class="hl-tag" style="color: #000096">/></strong>
@@ -1643,7 +1661,7 @@
structure, between the implied author or some other addresser,
and the fiction.<strong class="hl-tag" style="color: #000096"></gloss></strong><strong class="hl-tag" style="color: #000096"></p></strong>
<strong class="hl-tag" style="color: #000096"></text></strong>
-</pre></div><p>[Source file: <a href="examples/xml/EX-terms-selector-2.xml" shape="rect">examples/xml/EX-terms-selector-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d0e4313" id="d0e4313" shape="rect"/>Example 39: Usage of the <code>termInfoRefPointer</code> attribute</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><text></strong>
+</pre></div><p>[Source file: <a href="examples/xml/EX-terms-selector-2.xml" shape="rect">examples/xml/EX-terms-selector-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d0e4330" id="d0e4330" shape="rect"/>Example 40: Usage of the <code>termInfoRefPointer</code> attribute</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: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>
<span class="hl-attribute" style="color: #F5844C">termInfoRefPointer</span>=<span class="hl-value" style="color: #993300">"@target"</span><strong class="hl-tag" style="color: #000096">/></strong>
@@ -1656,7 +1674,7 @@
</pre></div><p>[Source file: <a href="examples/xml/EX-terms-selector-3.xml" shape="rect">examples/xml/EX-terms-selector-3.xml</a>]</p></div><p id="terminology-local">LOCAL: The following local markup is available for the
<a href="#terminology" shape="rect">Terminology</a> data category:</p><ul><li><p>A <code>term</code> attribute with the value "yes" or
"no".</p></li><li><p>An optional <code>termInfoRef</code> attribute that contains an IRI
- referring to the resource providing information about the term.</p></li><li><p>An optional <code>termConfidence</code> attribute with the value of a rational number in the interval 0 to 1. The value follows the <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#decimal" shape="rect">XML Schema decimal data type</a> with the constraining facets <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#rf-minInclusive" shape="rect">minInclusive</a> set to 0 and <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#rf-maxInclusive" shape="rect">maxInclusive</a> set to 1. <code>termConfidence</code> represents the confidence of the agents producing the annotation that the values of the term and, where provided, <code>termInfoRef</code>, are accurate. 1 represents the highest level of confidence.</p></li></ul><p>Any node selected by the terminology data category with the <code>termConfidence</code> attribute specified <a href="#rfc2119" shape="rect">MUST</a> be contained in a element with the <code>toolsRef</code> (or in HTML5 <code>its-tools-ref</code>) attribute specified for the <a href="#terminology" shape="rect">Terminology</a> data category. See <a class="section-ref" href="#its-tool-annotation" shape="rect">Section 5.8: ITS Tools Annotation</a> for more information.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-terms-selector-4" id="EX-terms-selector-4" shape="rect"/>Example 40: The <a href="#terminology" shape="rect">Terminology</a> data category expressed
+ referring to the resource providing information about the term.</p></li><li><p>An optional <code>termConfidence</code> attribute with the value of a rational number in the interval 0 to 1. The value follows the <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#decimal" shape="rect">XML Schema decimal data type</a> with the constraining facets <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#rf-minInclusive" shape="rect">minInclusive</a> set to 0 and <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#rf-maxInclusive" shape="rect">maxInclusive</a> set to 1. <code>termConfidence</code> represents the confidence of the agents producing the annotation that the values of the term and, where provided, <code>termInfoRef</code>, are accurate. 1 represents the highest level of confidence.</p></li></ul><p>Any node selected by the terminology data category with the <code>termConfidence</code> attribute specified <a href="#rfc2119" shape="rect">MUST</a> be contained in a element with the <code>toolsRef</code> (or in HTML5 <code>its-tools-ref</code>) attribute specified for the <a href="#terminology" shape="rect">Terminology</a> data category. See <a class="section-ref" href="#its-tool-annotation" shape="rect">Section 5.8: ITS Tools Annotation</a> for more information.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-terms-selector-4" id="EX-terms-selector-4" shape="rect"/>Example 41: The <a href="#terminology" shape="rect">Terminology</a> data category expressed
locally, including term information reference and confidence score.</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><book</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:toolsRef</span>=<span class="hl-value" style="color: #993300">"terminology|http://example.com/term-tool"</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"></head></strong>
<strong class="hl-tag" style="color: #000096"><body></strong>
@@ -1667,7 +1685,7 @@
...
<strong class="hl-tag" style="color: #000096"></body></strong> 
<strong class="hl-tag" style="color: #000096"></book></strong>
-</pre></div><p>[Source file: <a href="examples/xml/EX-terms-selector-4.xml" shape="rect">examples/xml/EX-terms-selector-4.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-term-local-html-1" id="EX-term-local-html-1" shape="rect"/>Example 41: The <a href="#terminology" shape="rect">Terminology</a> data category expressed locally
+</pre></div><p>[Source file: <a href="examples/xml/EX-terms-selector-4.xml" shape="rect">examples/xml/EX-terms-selector-4.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-term-local-html-1" id="EX-term-local-html-1" shape="rect"/>Example 42: The <a href="#terminology" shape="rect">Terminology</a> data category expressed locally
in HTML5</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: blue"><!DOCTYPE html></strong>
<strong class="hl-tag" style="color: #000096"><html</strong> <span class="hl-attribute" style="color: #F5844C">lang</span>=<span class="hl-value" style="color: #993300">en</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><head></strong>
@@ -1714,7 +1732,7 @@
left-to-right.</p><p id="directionality-global">GLOBAL: The <code>dirRule</code> element contains the
following:</p><ul><li><p>A required <code>selector</code> attribute. It contains an <a href="#selectors" shape="rect">absolute selector</a> which selects the nodes to which this
rule applies.</p></li><li><p>A required <code>dir</code> attribute with the value
- "ltr", "rtl", "lro" or "rlo".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-dir-selector-1.xml" id="EX-dir-selector-1.xml" shape="rect"/>Example 42: Document which needs global rules for directionality</div><p>In this document the right-to-left directionality is marked using a
+ "ltr", "rtl", "lro" or "rlo".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-dir-selector-1.xml" id="EX-dir-selector-1.xml" shape="rect"/>Example 43: Document which needs global rules for directionality</div><p>In this document the right-to-left directionality is marked using a
<code>direction</code> attribute with a value "rtlText".</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><text</strong> <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"><body></strong>
<strong class="hl-tag" style="color: #000096"><par></strong>In Hebrew, the title <strong class="hl-tag" style="color: #000096"><quote</strong> <span class="hl-attribute" style="color: #F5844C">xml:lang</span>=<span class="hl-value" style="color: #993300">"he"</span> <span class="hl-attribute" style="color: #F5844C">direction</span>=<span class="hl-value" style="color: #993300">"rtlText"</span><strong class="hl-tag" style="color: #000096">></strong>פעילות
@@ -1722,14 +1740,14 @@
W3C<strong class="hl-tag" style="color: #000096"></quote></strong>.<strong class="hl-tag" style="color: #000096"></par></strong>
<strong class="hl-tag" style="color: #000096"></body></strong>
<strong class="hl-tag" style="color: #000096"></text></strong>
-</pre></div><p>[Source file: <a href="examples/xml/EX-dir-selector-1.xml" shape="rect">examples/xml/EX-dir-selector-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-dir-selector-2.xml" id="EX-dir-selector-2.xml" shape="rect"/>Example 43: The <a href="#directionality" shape="rect">Directionality</a> data category expressed
+</pre></div><p>[Source file: <a href="examples/xml/EX-dir-selector-1.xml" shape="rect">examples/xml/EX-dir-selector-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-dir-selector-2.xml" id="EX-dir-selector-2.xml" shape="rect"/>Example 44: The <a href="#directionality" shape="rect">Directionality</a> data category expressed
with global rules</div><p>The <code>dirRule</code> element indicates that all elements with an attribute
<code>direction="rtlText"</code> have right-to-left content.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><its:dirRule</strong> <span class="hl-attribute" style="color: #F5844C">dir</span>=<span class="hl-value" style="color: #993300">"rtl"</span> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//*[@direction='rtlText']"</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-dir-selector-2.xml" shape="rect">examples/xml/EX-dir-selector-2.xml</a>]</p></div><p id="directionality-local">LOCAL: The following local markup is available for the
<a href="#directionality" shape="rect">Directionality</a> data category:</p><ul><li><p>A <code>dir</code> attribute with the value "ltr",
- "rtl", "lro" or "rlo".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d0e4624" id="d0e4624" shape="rect"/>Example 44: The <a href="#directionality" shape="rect">Directionality</a> data category expressed
+ "rtl", "lro" or "rlo".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d0e4641" id="d0e4641" shape="rect"/>Example 45: The <a href="#directionality" shape="rect">Directionality</a> data category expressed
locally</div><p>On the first <code>quote</code> element, the <code>its:dir="rtl"</code> attribute
indicates a right-to-left content.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><text</strong> <span class="hl-attribute" style="color: #F5844C">xml:lang</span>=<span class="hl-value" style="color: #993300">"en"</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><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><body></strong>
@@ -1738,7 +1756,7 @@
W3C<strong class="hl-tag" style="color: #000096"></quote></strong>.<strong class="hl-tag" style="color: #000096"></par></strong>
<strong class="hl-tag" style="color: #000096"></body></strong>
<strong class="hl-tag" style="color: #000096"></text></strong>
-</pre></div><p>[Source file: <a href="examples/xml/EX-dir-selector-3.xml" shape="rect">examples/xml/EX-dir-selector-3.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d0e4645" id="d0e4645" shape="rect"/>Example 45: The <a href="#directionality" shape="rect">Directionality</a> data category expressed
+</pre></div><p>[Source file: <a href="examples/xml/EX-dir-selector-3.xml" shape="rect">examples/xml/EX-dir-selector-3.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d0e4662" id="d0e4662" shape="rect"/>Example 46: The <a href="#directionality" shape="rect">Directionality</a> data category expressed
locally in HTML5</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: blue"><!DOCTYPE html></strong>
<strong class="hl-tag" style="color: #000096"><html</strong> <span class="hl-attribute" style="color: #F5844C">lang</span>=<span class="hl-value" style="color: #993300">en</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><head></strong>
@@ -1769,7 +1787,7 @@
the ruby parenthesis.</p></li><li><p>An optional <code>rubyText</code> element that contains the ruby text.</p></li><li><p>An optional <code>rtPointer</code> attribute that contains a <a href="#selectors" shape="rect">relative selector</a> pointing to a node that corresponds to
the ruby text.</p></li></ul><div class="note"><p class="prefix"><b>Note:</b></p><p>Where legacy formats do not contain ruby markup, it is still possible to
associate ruby text with a specified range of document content using the
- <code>rubyRule</code> element.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-ruby-legacy-1" id="EX-ruby-legacy-1" shape="rect"/>Example 46: Adding ruby text with a <code>rubyRule</code> element</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><text</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <code>rubyRule</code> element.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-ruby-legacy-1" id="EX-ruby-legacy-1" shape="rect"/>Example 47: Adding ruby text with a <code>rubyRule</code> element</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><text</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><head></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><strong class="hl-tag" style="color: #000096">></strong>
@@ -1788,7 +1806,7 @@
allows for <a href="#selection-local" shape="rect">local ITS markup</a>.</p></li><li><p>An <code>rp</code> element that contains the ruby parenthesis. It is used in case of
simple markup to specify characters that can denote the beginning and end of ruby
text when user agents do not have other ways to present ruby text distinctively from
- the base text.</p></li><li><p>An <code>rt</code> element that contains the ruby text and allows for <a href="#selection-local" shape="rect">local ITS markup</a>.</p></li></ul><p>All these elements share the attributes of the <code>span</code> element. </p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-ruby-implementation-1" id="EX-ruby-implementation-1" shape="rect"/>Example 47: The <a href="#ruby-annotation" shape="rect">Ruby</a> data category expressed
+ the base text.</p></li><li><p>An <code>rt</code> element that contains the ruby text and allows for <a href="#selection-local" shape="rect">local ITS markup</a>.</p></li></ul><p>All these elements share the attributes of the <code>span</code> element. </p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-ruby-implementation-1" id="EX-ruby-implementation-1" shape="rect"/>Example 48: The <a href="#ruby-annotation" shape="rect">Ruby</a> data category expressed
locally</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><text</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"><head></strong> ... <strong class="hl-tag" style="color: #000096"></head></strong>
<strong class="hl-tag" style="color: #000096"><body></strong>
@@ -1807,7 +1825,7 @@
language of the text selected by the selector attribute. This markup <a href="#rfc-keywords" shape="rect">MUST</a> use values that conform to <a title="Tags for Identifying
 Languages" href="#bcp47" shape="rect">[BCP47]</a>. The recommended way to specify language identification is to use
<code>xml:lang</code> in XML, and <code>lang</code> in HTML5. The <code>langRule</code>
element is intended only as a fall-back mechanism for documents where language is
- identified with another construct.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-lang-definition-1" id="EX-lang-definition-1" shape="rect"/>Example 48: Pointing to language information via <code>langRule</code>
+ identified with another construct.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-lang-definition-1" id="EX-lang-definition-1" shape="rect"/>Example 49: Pointing to language information via <code>langRule</code>
</div><p>The following <code>langRule</code> element expresses that the content of all
<code>p</code> elements (including attribute values and textual content of child
elements) are in the language indicated by <code>mylangattribute</code>, which is
@@ -1818,7 +1836,7 @@
</pre></div><p>[Source file: <a href="examples/xml/EX-lang-definition-1.xml" shape="rect">examples/xml/EX-lang-definition-1.xml</a>]</p></div><div class="note"><p class="prefix"><b>Note:</b></p><p>The <a href="#language-information" shape="rect">Language Information</a> data category
only provides for rules to be expressed at a global level. Locally users are able to
use <code>xml:lang</code> (which is defined by XML) or an attribute specific to the
- format in question (as in <a href="#EX-lang-definition-1" shape="rect">Example 48</a>).</p><p>
+ format in question (as in <a href="#EX-lang-definition-1" shape="rect">Example 49</a>).</p><p>
<code>xml:lang</code> is the preferable means of language identification. To ease the
usage of <code>xml:lang</code>, a declaration for this attribute is part of the
non-normative XML DTD and XML Schema document for ITS markup declarations. There is
@@ -1863,16 +1881,16 @@
inheritance. The default is that elements are not within text.</p><p id="withintext-global">GLOBAL: The <code>withinTextRule</code> element contains the
following:</p><ul><li><p>A required <code>selector</code> attribute. It contains an <a href="#selectors" shape="rect">absolute selector</a> which selects the nodes to which this
rule applies.</p></li><li><p>A required <code>withinText</code> attribute with the value "yes",
- "no" or "nested".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d0e5061" id="d0e5061" shape="rect"/>Example 49: Specifying elements within text with a <code>withinTextRule</code> element</div><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>
+ "no" or "nested".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d0e5078" id="d0e5078" shape="rect"/>Example 50: Specifying elements within text with a <code>withinTextRule</code> element</div><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:withinTextRule</strong> <span class="hl-attribute" style="color: #F5844C">withinText</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">"//b | //em | //i"</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-within-text-implementation-1.xml" shape="rect">examples/xml/EX-within-text-implementation-1.xml</a>]</p></div><p id="withintext-local">LOCAL: The following local markup is available for the <a href="#elements-within-text" shape="rect">Elements Within Text</a> data category:</p><ul><li><p>A <code>withinText</code> attribute with the values "yes",
- "no" or "nested".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-within-text-local-1" id="EX-within-text-local-1" shape="rect"/>Example 50: The <a href="#trans-datacat" shape="rect">Elements Within Text</a> data category
+ "no" or "nested".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-within-text-local-1" id="EX-within-text-local-1" shape="rect"/>Example 51: The <a href="#trans-datacat" shape="rect">Elements Within Text</a> data category
expressed locally</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><text</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><body></strong>
<strong class="hl-tag" style="color: #000096"><par></strong>Text with <strong class="hl-tag" style="color: #000096"><bold</strong> <span class="hl-attribute" style="color: #F5844C">its:withinText</span>=<span class="hl-value" style="color: #993300">"yes"</span><strong class="hl-tag" style="color: #000096">></strong>bold<strong class="hl-tag" style="color: #000096"></bold></strong>.<strong class="hl-tag" style="color: #000096"></par></strong>
<strong class="hl-tag" style="color: #000096"></body></strong>
-<strong class="hl-tag" style="color: #000096"></text></strong></pre></div><p>[Source file: <a href="examples/xml/EX-within-text-local-1.xml" shape="rect">examples/xml/EX-within-text-local-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-within-text-local-html5-1" id="EX-within-text-local-html5-1" shape="rect"/>Example 51: The <a href="#trans-datacat" shape="rect">Elements Within Text</a> data category
+<strong class="hl-tag" style="color: #000096"></text></strong></pre></div><p>[Source file: <a href="examples/xml/EX-within-text-local-1.xml" shape="rect">examples/xml/EX-within-text-local-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-within-text-local-html5-1" id="EX-within-text-local-html5-1" shape="rect"/>Example 52: The <a href="#trans-datacat" shape="rect">Elements Within Text</a> data category
expressed locally in HTML5</div><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>
@@ -1930,14 +1948,14 @@
some consumer systems or existing content, the domain may be identified via an IRI
like <code>http://example.com/domains/automotive</code>. The
<code>domainMapping</code> allows for using IRIs too. For the mapping, they are
- regarded as ordinary string values.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-domain-1" id="EX-domain-1" shape="rect"/>Example 52: The <code>domainRule</code> element</div><p>The <code>domainRule</code> element expresses that the content of the HTML
+ regarded as ordinary string values.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-domain-1" id="EX-domain-1" shape="rect"/>Example 53: The <code>domainRule</code> element</div><p>The <code>domainRule</code> element expresses that the content of the HTML
<code>body</code> element is in the domain expressed by the HTML <code>meta</code>
element with the <code>name</code> attribute, value <code>keywords</code>. The
<code>domainPointer</code> attribute points to that <code>meta</code> element.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span>
<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:domainRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"/h:html/h:body"</span>
<span class="hl-attribute" style="color: #F5844C">domainPointer</span>=<span class="hl-value" style="color: #993300">"/h:html/h:head/h:meta[@name='keywords']/@content"</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-domain-1.xml" shape="rect">examples/xml/EX-domain-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-domain-2" id="EX-domain-2" shape="rect"/>Example 53: The <code>domainRule</code> element</div><p>The <code>domainRule</code> element expresses that the content of the HTML
+<strong class="hl-tag" style="color: #000096"></its:rules></strong></pre></div><p>[Source file: <a href="examples/xml/EX-domain-1.xml" shape="rect">examples/xml/EX-domain-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-domain-2" id="EX-domain-2" shape="rect"/>Example 54: The <code>domainRule</code> element</div><p>The <code>domainRule</code> element expresses that the content of the HTML
<code>body</code> element is in the domain expressed by associated values. The
<code>domainPointer</code> attribute points to the values in the source content. In
this case it points to the <code>meta</code> elements with the <code>name</code>
@@ -1955,7 +1973,7 @@
element with the <code>name</code> attribute set to <code>keywords</code>, see <a href="http://www.w3.org/TR/html5/single-page.html#standard-metadata-names" shape="rect">standard metadata names in HTML5</a>. Alternatively, following the process for
<a href="http://www.w3.org/TR/html5/single-page.html#other-metadata-names" shape="rect">other metadata names</a> the <a href="http://wiki.whatwg.org/wiki/MetaExtensions" shape="rect">extension value</a> of
<code>dcterms.subject</code> can be used. The usage of both <code>keywords</code>
- and <code>dcterms.subject</code> is shown in example <a href="#EX-domain-2" shape="rect">Example 53</a>.</p><p>In the area of machine translation (e.g. machine translation systems or systems
+ and <code>dcterms.subject</code> is shown in example <a href="#EX-domain-2" shape="rect">Example 54</a>.</p><p>In the area of machine translation (e.g. machine translation systems or systems
harvesting content for machine translation training), there is no agreed upon set of
value sets for domain. Nevertheless it is recommended to use a small set of values
both in source content and within consumer tools, to foster interoperability. If
@@ -2035,7 +2053,7 @@
target.</p></li></ul></p></li></ul></p></li><li><p>An optional <code>disambigGranularity</code> attribute that contains a string,
specifying the granularity level of the disambiguation. The value can be one of the
following identifiers: <code>lexicalConcept</code>, <code>ontologyConcept</code>, or
- <code>entity</code>. The default value is <code>entity</code>.</p></li></ul><p>For an example, see <a href="#EX-disambiguation-html5-rdfa-companion-document" shape="rect">Example 56</a>.</p><p id="disambiguation-local">LOCAL: The following local markup is available for the
+ <code>entity</code>. The default value is <code>entity</code>.</p></li></ul><p>For an example, see <a href="#EX-disambiguation-html5-rdfa-companion-document" shape="rect">Example 57</a>.</p><p id="disambiguation-local">LOCAL: The following local markup is available for the
<a href="#Disambiguation" shape="rect">Disambiguation</a> data category:</p><ul><li><p>An optional <code>disambigConfidence</code> attribute with the value of a rational number in the interval 0 to 1 (inclusive). The value follows the <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#decimal" shape="rect">XML Schema decimal data type</a> with the constraining facets <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#rf-minInclusive" shape="rect">minInclusive</a> set to 0 and <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#rf-maxInclusive" shape="rect">maxInclusive</a> set to 1. <code>disambigConfidence</code> represents the confidence of the agents producing the annotation that the union of the values for the other disambiguation attributes in this instance are accurate. 1 represents the highest level of confidence.</p></li><li><p>An optional <code>disambigGranularity</code> attribute that contains a string,
specifying the granularity level of the disambiguation. The value <a href="#rfc2119" shape="rect">MUST</a> be one of the following identifiers:
<code>lexicalConcept</code>, <code>ontologyConcept</code>, or <code>entity</code>.
@@ -2044,7 +2062,7 @@
representing the disambiguation identifier collection source.</p></li><li><p>A <code>disambigIdent</code> attribute that contains a string,
representing the disambiguation identifier for the disambiguation target
that is valid within the specified disambiguation source.</p></li></ul></li><li><p>When using the addressing <a href="#disambiguation-use-cases" shape="rect">mode 2</a>:</p><ul><li><p>A <code>disambigIdentRef</code> attribute that contains an IRI that
- represents a unique identifier for the disambiguation target.</p></li></ul></li></ul></p></li></ul></p></li></ul><p>Any node selected by the <a href="#Disambiguation" shape="rect">disambiguation</a> data category with the <code>disambigConfidence</code> attribute specified <a href="#rfc2119" shape="rect">MUST</a> be contained in an element with the <code>toolsRef</code> (or in HTML5 <code>its-tools-ref</code>) attribute specified for the <a href="#Disambiguation" shape="rect">disambiguation</a> data category. For more information, see <a class="section-ref" href="#its-tool-annotation" shape="rect">Section 5.8: ITS Tools Annotation</a>.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-disambiguation-html5-local-1" id="EX-disambiguation-html5-local-1" shape="rect"/>Example 54: Local mixed usage of Usage of <code>disambigClassRef</code>,
+ represents a unique identifier for the disambiguation target.</p></li></ul></li></ul></p></li></ul></p></li></ul><p>Any node selected by the <a href="#Disambiguation" shape="rect">disambiguation</a> data category with the <code>disambigConfidence</code> attribute specified <a href="#rfc2119" shape="rect">MUST</a> be contained in an element with the <code>toolsRef</code> (or in HTML5 <code>its-tools-ref</code>) attribute specified for the <a href="#Disambiguation" shape="rect">disambiguation</a> data category. For more information, see <a class="section-ref" href="#its-tool-annotation" shape="rect">Section 5.8: ITS Tools Annotation</a>.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-disambiguation-html5-local-1" id="EX-disambiguation-html5-local-1" shape="rect"/>Example 55: Local mixed usage of Usage of <code>disambigClassRef</code>,
<code>disambigGranularity</code>, and <code>disambigIdentRef</code> in HTML.</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: blue"><!DOCTYPE html></strong>
<strong class="hl-tag" style="color: #000096"><html</strong> <span class="hl-attribute" style="color: #F5844C">lang</span>=<span class="hl-value" style="color: #993300">"en"</span> <span class="hl-attribute" style="color: #F5844C">its-tools-ref</span>=<span class="hl-value" style="color: #993300">"disambiguation|http://enrycher.ijs.si"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><head></strong>
@@ -2072,8 +2090,8 @@
this distinction exists, the specification does not prescribe a way of automatically
inferring a disambiguation level from a target type.</p><p>When serializing the ITS mark-up in HTML5, the preferred way is to serialize in
RDFa Lite or Microdata due to the existing search and crawling infrastructure that
- is able to consume this kind of data.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-disambiguation-html5-rdfa" id="EX-disambiguation-html5-rdfa" shape="rect"/>Example 55: Local mixed usage of <code>disambigClassRef</code>, <code>disambigSourceRef</code>,
- <code>disambigIdentRef</code> in HTML+RDFa Lite.</div><p>See <a href="#EX-disambiguation-html5-rdfa-companion-document" shape="rect">Example 56</a>
+ is able to consume this kind of data.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-disambiguation-html5-rdfa" id="EX-disambiguation-html5-rdfa" shape="rect"/>Example 56: Local mixed usage of <code>disambigClassRef</code>, <code>disambigSourceRef</code>,
+ <code>disambigIdentRef</code> in HTML+RDFa Lite.</div><p>See <a href="#EX-disambiguation-html5-rdfa-companion-document" shape="rect">Example 57</a>
for the companion document with the mapping data.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: blue"><!DOCTYPE html></strong>
<strong class="hl-tag" style="color: #000096"><html</strong> <span class="hl-attribute" style="color: #F5844C">lang</span>=<span class="hl-value" style="color: #993300">en</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><head></strong>
@@ -2087,7 +2105,7 @@
<span class="hl-attribute" style="color: #F5844C">typeof</span>=<span class="hl-value" style="color: #993300">"http:/nerd.eurecom.fr/ontology#Place"</span><strong class="hl-tag" style="color: #000096">></strong>Dublin<strong class="hl-tag" style="color: #000096"></span></strong> is 
the capital of Ireland.<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-disambiguation-html5-rdfa.html" shape="rect">examples/html5/EX-disambiguation-html5-rdfa.html</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-disambiguation-html5-rdfa-companion-document" id="EX-disambiguation-html5-rdfa-companion-document" shape="rect"/>Example 56: Companion document, having the mapping data for <a href="#EX-disambiguation-html5-rdfa" shape="rect">Example 55</a>.</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong>
+<strong class="hl-tag" style="color: #000096"></html></strong></pre></div><p>[Source file: <a href="examples/html5/EX-disambiguation-html5-rdfa.html" shape="rect">examples/html5/EX-disambiguation-html5-rdfa.html</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-disambiguation-html5-rdfa-companion-document" id="EX-disambiguation-html5-rdfa-companion-document" shape="rect"/>Example 57: Companion document, having the mapping data for <a href="#EX-disambiguation-html5-rdfa" shape="rect">Example 56</a>.</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><its:disambiguationRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//*[@typeof and @about]"</span> 
<span class="hl-attribute" style="color: #F5844C">disambiguationClassRefPointer</span>=<span class="hl-value" style="color: #993300">"@typeof"</span> <span class="hl-attribute" style="color: #F5844C">disambigIdentRefPointer</span>=<span class="hl-value" style="color: #993300">"@about"</span> <span class="hl-attribute" style="color: #F5844C">disambigGranularity</span>=<span class="hl-value" style="color: #993300">"entity"</span><strong class="hl-tag" style="color: #000096">/></strong>
<strong class="hl-tag" style="color: #000096"></its:rules></strong>
@@ -2109,7 +2127,7 @@
ranges from multiple rules or local attributes.</p><p id="localefilter-global">GLOBAL: The <code>localeFilterRule</code> element contains
the following:</p><ul><li><p>A required <code>selector</code> attribute. It contains an <a href="#selectors" shape="rect">absolute selector</a> which selects the nodes to which this
rule applies.</p></li><li><p>A required <code>localeFilterList</code> attribute with a comma-separated list of
- extended language ranges, or an empty string value.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locale-filter-selector-1" id="EX-locale-filter-selector-1" shape="rect"/>Example 57: The <a href="#LocaleFilter" shape="rect">Locale Filter</a> data category expressed
+ extended language ranges, or an empty string value.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locale-filter-selector-1" id="EX-locale-filter-selector-1" shape="rect"/>Example 58: The <a href="#LocaleFilter" shape="rect">Locale Filter</a> data category expressed
globally</div><p>The <code>localeFilterRule</code> element specifies that certain legal notice elements
should only be shown in the specified locales. Note that using the extended language
range "*-CA" in the <code>localeFilterList</code> attribute would cover all
@@ -2125,7 +2143,7 @@
<strong class="hl-tag" style="color: #000096"></legalnotice></strong>
<strong class="hl-tag" style="color: #000096"></info></strong>
<strong class="hl-tag" style="color: #000096"></book></strong>
-</pre></div><p>[Source file: <a href="examples/xml/EX-locale-filter-selector-1.xml" shape="rect">examples/xml/EX-locale-filter-selector-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locale-filter-selector-2" id="EX-locale-filter-selector-2" shape="rect"/>Example 58: The <a href="#LocaleFilter" shape="rect">Locale Filter</a> data category expressed
+</pre></div><p>[Source file: <a href="examples/xml/EX-locale-filter-selector-1.xml" shape="rect">examples/xml/EX-locale-filter-selector-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locale-filter-selector-2" id="EX-locale-filter-selector-2" shape="rect"/>Example 59: The <a href="#LocaleFilter" shape="rect">Locale Filter</a> data category expressed
globally</div><p>The <code>localeFilterRule</code> element specifies that editorial remarks should be
removed from all translations.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><section</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><info></strong>
@@ -2137,7 +2155,7 @@
<strong class="hl-tag" style="color: #000096"></section></strong>
</pre></div><p>[Source file: <a href="examples/xml/EX-locale-filter-selector-2.xml" shape="rect">examples/xml/EX-locale-filter-selector-2.xml</a>]</p></div><p id="localefilter-local">LOCAL: The following local markup is available for the
<a href="#LocaleFilter" shape="rect">Locale Filter</a> data category:</p><ul><li><p>A <code>localeFilterList</code> attribute with a comma-separated list of extended
- language ranges, or an empty string value.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locale-filter-attribute-1" id="EX-locale-filter-attribute-1" shape="rect"/>Example 59: The <a href="#LocaleFilter" shape="rect">Locale Filter</a> data category expressed
+ language ranges, or an empty string value.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locale-filter-attribute-1" id="EX-locale-filter-attribute-1" shape="rect"/>Example 60: The <a href="#LocaleFilter" shape="rect">Locale Filter</a> data category expressed
locally</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><book</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><info></strong>
<strong class="hl-tag" style="color: #000096"><legalnotice</strong> <span class="hl-attribute" style="color: #F5844C">its:localeFilterList</span>=<span class="hl-value" style="color: #993300">"en-CA, fr-CA"</span><strong class="hl-tag" style="color: #000096">></strong>
@@ -2186,7 +2204,7 @@
<code>revOrgPointer</code>, <code>revOrgRefPointer</code>,
<code>revToolPointer</code>, <code>revToolRefPointer</code> and
<code>provRefPointer</code> do not apply to HTML as local markup is provided for
- direct annotation in HTML.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-provenance-global-3" id="EX-provenance-global-3" shape="rect"/>Example 60: The <a href="#provenance" shape="rect">Provenance</a> data category used globally with standoff provenance
+ direct annotation in HTML.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-provenance-global-3" id="EX-provenance-global-3" shape="rect"/>Example 61: The <a href="#provenance" shape="rect">Provenance</a> data category used globally with standoff provenance
records.</div><p>This example expresses provenance information in a standoff manner within
<code>provenanceRecords</code> elements. The <code>provRule</code> elements
have <code>provenanceRecordsRefPointer</code> attributes that point to <code>ref</code> attributes. The <code>ref</code> attributes hold references to
@@ -2227,7 +2245,7 @@
<strong class="hl-tag" style="color: #000096"><legalnotice</strong> <span class="hl-attribute" style="color: #F5844C">postediting-by</span>=<span class="hl-value" style="color: #993300">"http://www.vistatec.com/"</span> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"#pr2"</span><strong class="hl-tag" style="color: #000096">></strong>This text was
translated directly by a person.<strong class="hl-tag" style="color: #000096"></legalnotice></strong>
<strong class="hl-tag" style="color: #000096"></body></strong>
-<strong class="hl-tag" style="color: #000096"></text></strong></pre></div><p>[Source file: <a href="examples/xml/EX-provenance-global-3.xml" shape="rect">examples/xml/EX-provenance-global-3.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-provenance-global-pointer-xliff" id="EX-provenance-global-pointer-xliff" shape="rect"/>Example 61: The <a href="#provenance" shape="rect">Provenance</a> data category used with global rules for an XLIFF file.</div><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon"><?xml version="1.0" encoding="UTF-8"?></span>
+<strong class="hl-tag" style="color: #000096"></text></strong></pre></div><p>[Source file: <a href="examples/xml/EX-provenance-global-3.xml" shape="rect">examples/xml/EX-provenance-global-3.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-provenance-global-pointer-xliff" id="EX-provenance-global-pointer-xliff" shape="rect"/>Example 62: The <a href="#provenance" shape="rect">Provenance</a> data category used with global rules for an XLIFF file.</div><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon"><?xml version="1.0" encoding="UTF-8"?></span>
<strong class="hl-tag" style="color: #000096"><xliff</strong> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">'1.2'</span>
<span class="hl-attribute" style="color: #F5844C">xmlns</span>=<span class="hl-value" style="color: #993300">'urn:oasis:names:tc:xliff:document:1.2'</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><strong class="hl-tag" style="color: #000096">></strong>
@@ -2305,7 +2323,7 @@
their equivalent representations) are used in a standoff manner, the
information they carry pertains to the content of the element that refers to the
standoff annotation, not to the content of the element <code>provenanceRecord</code> where they are
- declared.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-provenance-local-1" id="EX-provenance-local-1" shape="rect"/>Example 62: Annotating provenance information in XML with local inline markup</div><p>The provenance related attributes at the <code>par</code> and
+ declared.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-provenance-local-1" id="EX-provenance-local-1" shape="rect"/>Example 63: Annotating provenance information in XML with local inline markup</div><p>The provenance related attributes at the <code>par</code> and
<code>legalnotice</code> elements are used to associate the provenance information
directly with the content of theses elements.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><text</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:dc</span>=<span class="hl-value" style="color: #993300">"http://purl.org/dc/elements/1.1/"</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><strong class="hl-tag" style="color: #000096">></strong>
@@ -2324,7 +2342,7 @@
<span class="hl-attribute" style="color: #F5844C">its:ref</span>=<span class="hl-value" style="color: #993300">"http://www.examplelsp.com/excontent987/legal/prov/e6354 http://www.vistatec.com/job-12-7-15-X31/reviewed/prov/re8573469"</span><strong class="hl-tag" style="color: #000096">
></strong>This text was translated directly by a person.<strong class="hl-tag" style="color: #000096"></legalnotice></strong>
<strong class="hl-tag" style="color: #000096"></body></strong>
-<strong class="hl-tag" style="color: #000096"></text></strong></pre></div><p>[Source file: <a href="examples/xml/EX-provenance-local-1.xml" shape="rect">examples/xml/EX-provenance-local-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-provenance-html5-local-1" id="EX-provenance-html5-local-1" shape="rect"/>Example 63: Annotating provenance information in HTML with local inline markup</div><p>In this example several spans of content are associated with provenance
+<strong class="hl-tag" style="color: #000096"></text></strong></pre></div><p>[Source file: <a href="examples/xml/EX-provenance-local-1.xml" shape="rect">examples/xml/EX-provenance-local-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-provenance-html5-local-1" id="EX-provenance-html5-local-1" shape="rect"/>Example 64: Annotating provenance information in HTML with local inline markup</div><p>In this example several spans of content are associated with provenance
information.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: blue"><!DOCTYPE html></strong>
<strong class="hl-tag" style="color: #000096"><html</strong> <span class="hl-attribute" style="color: #F5844C">lang</span>=<span class="hl-value" style="color: #993300">en</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><head></strong>
@@ -2342,7 +2360,7 @@
<span class="hl-attribute" style="color: #F5844C">its-prov-ref</span>=<span class="hl-value" style="color: #993300">"http://www.examplelsp.com/excontent987/legal/prov/e6354 http://www.vistatec.com/job-12-7-15-X31/reviewed/prov/re8573469"</span><strong class="hl-tag" style="color: #000096">
></strong>This text was translated directly by a person.<strong class="hl-tag" style="color: #000096"></legalnotice></strong>
[359 lines skipped]
--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2012/11/21 15:28:40 1.252
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2012/11/21 17:54:57 1.253
@@ -1774,18 +1774,32 @@
<p>The value of <att>toolsRef</att> is a space-separated list of references where each reference is composed of two parts: a data category identifier and an IRI. These two parts are separated by a character <code>|</code> VERTICAL LINE (U+007C).</p>
- <p>The data category identifier <ref target="#rfc2119">MUST</ref> be the data category identifiers defined in this specification.</p>
-
- <p>The IRI indicates information about the processor used to generate the data category annotation. No single means is specified for how this IRI should be used to indicate processor information. Possible mechanisms are: to encode information directly in the IRI, e.g. as parameters; to reference an external resource that provides such information, e.g. an XML file or an RDF declaration; or to reference another part of the document that provides such information.</p>
-
- <p>When a data category annotates a node that is contained within more than one element possessing a <att>toolsRef</att> attribute, only the IRI value from the most immediate enclosing element’s <att>toolsRef</att> attribute shall apply.</p>
-
- <p>In HTML5 documents, the same mechanism is implemented with the <att>its-tools-ref</att> attribute.</p>
+ <list>
+ <item><p>The data category identifier <ref target="#rfc2119">MUST</ref> be the data category identifiers defined in this specification.</p></item>
+ <item><p>The IRI indicates information about the processor used to generate the data category annotation. No single means is specified for how this IRI should be used to indicate processor information. Possible mechanisms are: to encode information directly in the IRI, e.g. as parameters; to reference an external resource that provides such information, e.g. an XML file or an RDF declaration; or to reference another part of the document that provides such information.</p></item>
+ </list>
+
+ <p>In HTML5 documents, the mechanism is implemented with the <att>its-tools-ref</att> attribute.</p>
+
+ <p>The attribute applies to the content of the element where it is declared (including its children elements) and to the attributes of that element.</p>
+
+ <p>On any given node, the information provided by this mechanism is a space-separated list of the accumulated references found it the <att>toolsRef</att> attributes
+ declared in the enclosing elements and sorted by data category identifiers. For each data category, the IRI part is the one of the inner-most declarartion.</p>
+
+ <exemplum>
+ <head>Accumulation and Overriding of the <att>toolsRef</att> Values</head>
+ <p>In this example, the text shows the computed tools reference information for the given node. Note that the references are ordered alphabetically and
+ that the IRI values are always the ones of the inner-most declaration.</p>
+ <egXML xmlns="http://www.tei-c.org/ns/Examples" target="examples/xml/EX-its-tool-annotation-1.xml"></egXML>
+ </exemplum>
<exemplum xml:id="EX-its-tool-annotation-1">
<head>Example of ITS Tool Annotation</head>
- <p>The <att>toolsRef</att> attribute is used in this XML document to indicate that information about the processor that generated the <att>mtConfidence</att> values for the first two <code>p</code> elements are found in element with <code>id="T1"</code> in the external document tools.xml, while that information for the third <code>p</code> element is found in the element with <code>id="T2"</code> in the same document. In addition, <att>toolsRef</att> is used to identify a Web resource with information about the QA tool used to generate the <ref target="#lqissue">Localization Quality Issue</ref> annotation in the document.</p>
- <egXML xmlns="http://www.tei-c.org/ns/Examples" target="examples/xml/EX-its-tool-annotation-1.xml"></egXML>
+ <p>The <att>toolsRef</att> attribute is used in this XML document to indicate that information about the processor that generated the <att>mtConfidence</att> values
+ for the first two <code>p</code> elements are found in element with <code>id="T1"</code> in the external document tools.xml, while that information for the
+ third <code>p</code> element is found in the element with <code>id="T2"</code> in the same document. In addition, <att>toolsRef</att> is used to identify a Web
+ resource with information about the QA tool used to generate the <ref target="#lqissue">Localization Quality Issue</ref> annotation in the document.</p>
+ <egXML xmlns="http://www.tei-c.org/ns/Examples" target="examples/xml/EX-its-tool-annotation-2.xml"></egXML>
</exemplum>
<exemplum xml:id="EX-its-tool-annotation-2">
<head>Example of ITS Tool Annotation</head>
Received on Wednesday, 21 November 2012 17:55:09 UTC