- From: CVS User fsasaki <cvsmail@w3.org>
- Date: Tue, 20 Nov 2012 11:30:45 +0000
- To: public-multilingualweb-lt-commits@w3.org
Update of /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20
In directory gil:/tmp/cvs-serv17865
Modified Files:
its20.html its20.odd
Log Message:
added tool information draft
--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2012/11/20 09:26:31 1.235
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2012/11/20 11:30:45 1.236
@@ -61,6 +61,7 @@
<div class="toc2">5.5 <a href="#selection-precedence" shape="rect">Precedence between Selections</a></div>
<div class="toc2">5.6 <a href="#associating-its-with-existing-markup" shape="rect">Associating ITS Data Categories with Existing Markup</a></div>
<div class="toc2">5.7 <a href="#conversion-to-nif" shape="rect">Conversion to NIF</a></div>
+<div class="toc2">5.8 <a href="#its-tool-annotation" shape="rect">ITS Tools Annotation</a></div>
</div>
<div class="toc1">6 <a href="#datacategory-description" shape="rect">Description of Data Categories</a><div class="toc2">6.1 <a href="#datacategories-defaults-etc" shape="rect">Position, Defaults, Inheritance and Overriding of Data Categories</a></div>
<div class="toc2">6.2 <a href="#trans-datacat" shape="rect">Translate</a><div class="toc3">6.2.1 <a href="#translatability-definition" shape="rect">Definition</a></div>
@@ -1240,7 +1241,35 @@
</pre></div></div><p>A complete sample output in RDF/XML format after step 7, given the input document <a href="#EX-HTML-whitespace-normalization" shape="rect">Example 24</a>, is available at <a href="examples/nif/EX-nif-conversion-output.xml" shape="rect">examples/nif/EX-nif-conversion-output.xml</a>.</p><div class="note"><p class="prefix"><b>Note:</b></p><p>The conversion to NIF is the basis for natural language processing (NLP)
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><div class="div1">
+ 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 MT Confidence data category 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.</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 anotations 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 a IRI. These two part are separated by the "<span class="quote">"</span>" [U+007C] character.</p><p>The data category identifier either be one the data category identifiers defined in this specification or a user defined data category identifier. In the latter case the behaviour of the association between the identifier and the IRI is undefined.</p><span class="editor-note">[Ed. note: Ed Note: I’m still not sure if mentioning user defined data categories makes sense here, since we don’t have a mechanism for such extensions elsewhere]</span><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 prcessor 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 its:toolsRef 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 this XML document to indicate that information about the processor that generated the mtConfidence values for the first two <code>p</code> elements are ound 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: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>
+ <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.55"</span> <span class="hl-attribute" style="color: #F5844C">its:locQualityIssueType</span>=<span class="hl-value" style="color: #993300">"typographical"</span>
+ <span class="hl-attribute" style="color: #F5844C">its:locQualityIssueComment</span>=<span class="hl-value" style="color: #993300">"Sentence without capitalization"</span>
+ <span class="hl-attribute" style="color: #F5844C">its:locQualityIssueSeverity</span>=<span class="hl-value" style="color: #993300">"50"</span><strong class="hl-tag" style="color: #000096">></strong>text also translated with tool T1<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: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> attribute is used in this HTML document to indicate that the <a href="#mtconfidence" shape="rect">MTconfidence</a> annotation on the first two <code>span</code> elemetns come from one MT (fr-to-en) engine, while the annotation on the third comes from another (it-to-en) engine. Both processor <code>its-tool-ref</code> attribute refer to a web resource for information about the engine generating the MT confidence 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
+ machine translated into english with mtConfidence defined
+ locally.<strong class="hl-tag" style="color: #000096"></title></strong>
+ <strong class="hl-tag" style="color: #000096"></head></strong>
+ <strong class="hl-tag" style="color: #000096"><body</strong> <span class="hl-attribute" style="color: #F5844C">its-tools-ref</span>=<span class="hl-value" style="color: #993300">"MTConfidence|http://www.exmt-prov.com/2012/11/9/fr-t-en"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><p></strong>
+ <strong class="hl-tag" style="color: #000096"><span</strong> <span class="hl-attribute" style="color: #F5844C">its-mt-confidence</span>=<span class="hl-value" style="color: #993300">0.8982</span><strong class="hl-tag" style="color: #000096">></strong>Dublin is the capital of Ireland.<strong class="hl-tag" style="color: #000096"></span></strong>
+ <strong class="hl-tag" style="color: #000096"><span</strong> <span class="hl-attribute" style="color: #F5844C">its-mt-confidence</span>=<span class="hl-value" style="color: #993300">0.8536</span><strong class="hl-tag" style="color: #000096">></strong>The capital of the Czech Republic is Prague.<strong class="hl-tag" style="color: #000096"></span></strong>
+ <strong class="hl-tag" style="color: #000096"><span</strong> <span class="hl-attribute" style="color: #F5844C">its-mt-confidence</span>=<span class="hl-value" style="color: #993300">0.7009</span>
+ <span class="hl-attribute" style="color: #F5844C">its-tools-ref</span>=<span class="hl-value" style="color: #993300">"MTConfidence|http://www.exmt-prov.com/2012/11/9/it-t-en"</span><strong class="hl-tag" style="color: #000096">></strong>The capital Italia is Roma.<strong class="hl-tag" style="color: #000096"></span></strong>
+ <strong class="hl-tag" style="color: #000096"></p></strong>
+ <strong class="hl-tag" style="color: #000096"></body></strong>
+<strong class="hl-tag" style="color: #000096"></html></strong>
+</pre></div><p>[Source file: <a href="examples/html5/EX-its-tool-annotation-html5-1.html" shape="rect">examples/html5/EX-its-tool-annotation-html5-1.html</a>]</p></div></div></div><div class="div1">
<h2><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="datacategory-description" id="datacategory-description" shape="rect"/>6 Description of Data Categories</h2><p>
<em>This section is normative.</em>
</p><div class="div2">
@@ -1269,7 +1298,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 71</a>. This information does not
+ available in a <code>target</code> element; see <a href="#EX-target-pointer-global-1" shape="rect">Example 73</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
@@ -1395,7 +1424,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="d0e3599" id="d0e3599" shape="rect"/>Example 25: 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="d0e3693" id="d0e3693" 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
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
@@ -1442,7 +1471,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 26: The <a href="#trans-datacat" shape="rect">Translate</a> data category expressed
+ "yes" or "no".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translate-selector-1" id="EX-translate-selector-1" shape="rect"/>Example 28: The <a href="#trans-datacat" shape="rect">Translate</a> data category expressed
globally</div><p>The <code>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>
@@ -1452,13 +1481,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 27: 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 29: The <a href="#trans-datacat" shape="rect">Translate</a> data category expressed
locally</div><p>The local <code>its:translate="no"</code> specifies that the content of
<code>panelmsg</code> must not be translated.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><messages</strong> <span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><msg</strong> <span class="hl-attribute" style="color: #F5844C">num</span>=<span class="hl-value" style="color: #993300">"123"</span><strong class="hl-tag" style="color: #000096">></strong>Click Resume Button on Status Display or <strong class="hl-tag" style="color: #000096"><panelmsg</strong> <span class="hl-attribute" style="color: #F5844C">its:translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">
></strong>CONTINUE<strong class="hl-tag" style="color: #000096"></panelmsg></strong> Button on printer panel<strong class="hl-tag" style="color: #000096"></msg></strong>
<strong class="hl-tag" style="color: #000096"></messages></strong>
-</pre></div><p>[Source file: <a href="examples/xml/EX-translate-selector-2.xml" shape="rect">examples/xml/EX-translate-selector-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translate-html5" id="EX-translate-html5" shape="rect"/>Example 28: The <a href="#trans-datacat" shape="rect">Translate</a> data category expressed locally
+</pre></div><p>[Source file: <a href="examples/xml/EX-translate-selector-2.xml" shape="rect">examples/xml/EX-translate-selector-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translate-html5" id="EX-translate-html5" shape="rect"/>Example 30: The <a href="#trans-datacat" shape="rect">Translate</a> data category expressed locally
in 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>
@@ -1495,7 +1524,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 a 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 29: 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 31: 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>
@@ -1510,7 +1539,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 30: 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 32: 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>
@@ -1528,7 +1557,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 31: 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 33: 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>
@@ -1541,7 +1570,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="d0e3996" id="d0e3996" shape="rect"/>Example 32: 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="d0e4090" id="d0e4090" 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
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>
@@ -1562,7 +1591,7 @@
itself.</p></li><li><p>A <code>locNoteRef</code> attribute that contains a 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="d0e4057" id="d0e4057" shape="rect"/>Example 33: 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="d0e4151" id="d0e4151" shape="rect"/>Example 35: 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>
@@ -1570,7 +1599,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="d0e4070" id="d0e4070" shape="rect"/>Example 34: 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="d0e4164" id="d0e4164" shape="rect"/>Example 36: 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>
@@ -1599,14 +1628,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 a 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="d0e4168" id="d0e4168" shape="rect"/>Example 35: 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="d0e4262" id="d0e4262" 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>
<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="d0e4181" id="d0e4181" shape="rect"/>Example 36: 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="d0e4275" id="d0e4275" 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"><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>
@@ -1616,7 +1645,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="d0e4194" id="d0e4194" shape="rect"/>Example 37: 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="d0e4288" id="d0e4288" 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>
<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>
@@ -1629,7 +1658,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 a IRI
- referring to the resource providing information about the term.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-terms-selector-4" id="EX-terms-selector-4" shape="rect"/>Example 38: The <a href="#terminology" shape="rect">Terminology</a> data category expressed
+ referring to the resource providing information about the term.</p></li></ul><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
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">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>
@@ -1638,7 +1667,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 39: 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 41: 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>
@@ -1685,7 +1714,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 40: 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 42: 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>פעילות
@@ -1693,14 +1722,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 41: 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 43: 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="d0e4465" id="d0e4465" shape="rect"/>Example 42: 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="d0e4559" id="d0e4559" shape="rect"/>Example 44: 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>
@@ -1709,7 +1738,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="d0e4486" id="d0e4486" 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-3.xml" shape="rect">examples/xml/EX-dir-selector-3.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d0e4580" id="d0e4580" shape="rect"/>Example 45: 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>
@@ -1740,7 +1769,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 44: 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 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>
<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>
@@ -1759,7 +1788,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 45: 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 47: 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>
@@ -1778,7 +1807,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 46: 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 48: 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
@@ -1789,7 +1818,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 46</a>).</p><p>
+ format in question (as in <a href="#EX-lang-definition-1" shape="rect">Example 48</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
@@ -1834,16 +1863,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="d0e4902" id="d0e4902" shape="rect"/>Example 47: 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="d0e4996" id="d0e4996" 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>
<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 48: 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 50: 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 49: 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 51: 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>
@@ -1901,14 +1930,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 50: 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 52: 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 51: 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 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 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>
@@ -1926,7 +1955,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 51</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 53</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
@@ -1999,7 +2028,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 54</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 56</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>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>.
@@ -2008,7 +2037,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 a IRI that
- represents a unique identifier for the disambiguation target.</p></li></ul></li></ul></p></li></ul></p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-disambiguation-html5-local-1" id="EX-disambiguation-html5-local-1" shape="rect"/>Example 52: 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><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>,
<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><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><head></strong>
@@ -2034,8 +2063,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 53: 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 54</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 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>
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>
@@ -2049,7 +2078,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 54: Companion document, having the mapping data for <a href="#EX-disambiguation-html5-rdfa" shape="rect">Example 53</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 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"><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>
@@ -2071,7 +2100,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 55: 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 57: 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
@@ -2087,7 +2116,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 56: 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 58: 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>
@@ -2099,7 +2128,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 57: 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 59: 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>
@@ -2192,7 +2221,7 @@
<code>transRevOrgPointer</code>, <code>transRevOrgRefPointer</code>,
<code>transRevToolPointer</code>, <code>transRevToolRefPointer</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-translation-agent-provenance-global-1" id="EX-translation-agent-provenance-global-1" shape="rect"/>Example 58: The <a href="#translation-agent-provenance" shape="rect">Translation Agent
+ direct annotation in HTML.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translation-agent-provenance-global-1" id="EX-translation-agent-provenance-global-1" shape="rect"/>Example 60: The <a href="#translation-agent-provenance" shape="rect">Translation Agent
Provenance</a> data category used globally.</div><p>This example shows how the provenance of the <code>par</code> and the
<code>legalnotice</code> elements in this XML document is different. Therefore it
is recorded in separate <code>provRule</code> 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><strong class="hl-tag" style="color: #000096">></strong>
@@ -2217,8 +2246,8 @@
<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><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-translation-agent-provenance-global-1.xml" shape="rect">examples/xml/EX-translation-agent-provenance-global-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translation-agent-provenance-global-2" id="EX-translation-agent-provenance-global-2" shape="rect"/>Example 59: The <a href="#translation-agent-provenance" shape="rect">Translation Agent
- Provenance</a> data category used globally with pointer attributes.</div><p>This example expresses the same provenance information as <a href="#EX-translation-agent-provenance-global-1" shape="rect">Example 58</a>, but the
+<strong class="hl-tag" style="color: #000096"></text></strong></pre></div><p>[Source file: <a href="examples/xml/EX-translation-agent-provenance-global-1.xml" shape="rect">examples/xml/EX-translation-agent-provenance-global-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translation-agent-provenance-global-2" id="EX-translation-agent-provenance-global-2" shape="rect"/>Example 61: The <a href="#translation-agent-provenance" shape="rect">Translation Agent
+ Provenance</a> data category used globally with pointer attributes.</div><p>This example expresses the same provenance information as <a href="#EX-translation-agent-provenance-global-1" shape="rect">Example 60</a>, but the
provenance information for the <code>par</code> element is stored differently,
inside a format specific element <code>my-provenance-info</code>. The first
<code>provRule</code> element and its attributes <code>transToolRefPointer</code>,
@@ -2254,9 +2283,9 @@
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-translation-agent-provenance-global-2.xml" shape="rect">examples/xml/EX-translation-agent-provenance-global-2.xml</a>]</p></div><span class="editor-note">[Ed. note: Not sure if we need the standoff version globally. We don't have it with
- quality either. Thoughts?]</span><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translation-agent-provenance-global-3" id="EX-translation-agent-provenance-global-3" shape="rect"/>Example 60: The <a href="#translation-agent-provenance" shape="rect">Translation Agent
+ quality either. Thoughts?]</span><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translation-agent-provenance-global-3" id="EX-translation-agent-provenance-global-3" shape="rect"/>Example 62: The <a href="#translation-agent-provenance" shape="rect">Translation Agent
Provenance</a> data category used globally with standoff provenance
- records.</div><p>This example expresses the same plus some additional provenance information as <a href="#EX-translation-agent-provenance-global-1" shape="rect">Example 58</a>, but the
+ records.</div><p>This example expresses the same plus some additional provenance information as <a href="#EX-translation-agent-provenance-global-1" shape="rect">Example 60</a>, but the
provenance information is realized standoff within
[476 lines skipped]
--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2012/11/20 09:26:32 1.233
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2012/11/20 11:30:45 1.234
@@ -1764,6 +1764,37 @@
target="#nif-backconversion" type="specref"/>. The algorithm in that appendix is
non-normative since many choices depend on the actual NLP application.</p></note>
</div>
+ <div xml:id="its-tool-annotation">
+ <head>ITS Tools Annotation</head>
+ <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 MT Confidence data category 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.</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 <att>toolsRef</att> 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 <att>toolsRef</att> is a space-separated list of references where each reference is composed of two parts: a data category identifier and a IRI. These two part are separated by the <quote>"</quote> [U+007C] character.</p>
+
+ <p>The data category identifier either be one the data category identifiers defined in this specification or a user defined data category identifier. In the latter case the behaviour of the association between the identifier and the IRI is undefined.</p>
+
+ <note type="ed">Ed Note: I’m still not sure if mentioning user defined data categories makes sense here, since we don’t have a mechanism for such extensions elsewhere</note>
+
+ <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 its:toolsRef 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>
+
+ <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 mtConfidence 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>
+ </exemplum>
+ <exemplum xml:id="EX-its-tool-annotation-2">
+ <head>Example of ITS Tool Annotation</head>
+ <p>The <att>its-tools-ref</att> attribute is used in this HTML document to indicate that the <ref target="#mtconfidence">MTconfidence</ref> annotation on the first two <code>span</code> elemetns come from one MT (fr-to-en) engine, while the annotation on the third comes from another (it-to-en) engine. Both processor <att>its-tool-ref</att> attribute refer to a web resource for information about the engine generating the MT confidence annotation.</p>
+ <egXML xmlns="http://www.tei-c.org/ns/Examples" target="examples/html5/EX-its-tool-annotation-html5-1.html"></egXML>
+ </exemplum>
+ </div>
</div>
<div xml:id="datacategory-description">
<head>Description of Data Categories</head>
@@ -4500,8 +4531,8 @@
<p>Where the external ITS rules file is as shown:</p>
<exemplum>
<head>XML file with external rules references from an HTML5 file.</head>
- <egXML xmlns="http://www.tei-c.org/ns/Examples"
- target="examples/html5/EX-mtconfidence-global-html5-1-external-rules.xml"/>
+ <egXML xmlns="http://www.tei-c.org/ns/Examples"
+ target="examples/html5/EX-mtconfidence-global-html5-1-external-rules.xml"/>
</exemplum>
<p xml:id="mtconfidence-local">LOCAL: the following local markup is available for the
<ref target="#mtconfidence">MT Confidence</ref> data category:</p>
Received on Tuesday, 20 November 2012 11:30:58 UTC