CVS WWW/International/multilingualweb/lt/drafts/its20

Update of /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20
In directory gil:/tmp/cvs-serv29254

Modified Files:
	its20.html its20.odd 
Log Message:
editorial fixes related to terminology and tool annotation section

--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html	2012/11/20 20:40:32	1.249
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html	2012/11/20 21:04:20	1.250
@@ -1241,7 +1241,7 @@
               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 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 an IRI. These two part are separated by the <code>|</code> [U+007C] character.</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 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 annotatesa 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 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 th 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">&lt;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 part are separated by the <code>|</code> [U+007C] character.</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 about the procssor 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 this XML documet 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">&lt;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">&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;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">&gt;</strong>Text translated with tool T1<strong class="hl-tag" style="color: #000096">&lt;/p&gt;</strong>
@@ -1422,7 +1422,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="d0e3698" id="d0e3698" 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="d0e3716" id="d0e3716" 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
@@ -1568,7 +1568,7 @@
   <strong class="hl-tag" style="color: #000096">&lt;body&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;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">&gt;</strong>Cannot find {0} on {1}.<strong class="hl-tag" style="color: #000096">&lt;/msg&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;/body&gt;</strong>
-<strong class="hl-tag" style="color: #000096">&lt;/myRes&gt;</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="d0e4095" id="d0e4095" 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">&lt;/myRes&gt;</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="d0e4113" id="d0e4113" 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">&lt;dataFile&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;prolog&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;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">&gt;</strong>
@@ -1589,7 +1589,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="d0e4156" id="d0e4156" 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="d0e4174" id="d0e4174" 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">&lt;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">&gt;</strong>
  <strong class="hl-tag" style="color: #000096">&lt;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">&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;value&gt;</strong> Variant {0} = {1} ({2})<strong class="hl-tag" style="color: #000096">&lt;/value&gt;</strong>
@@ -1597,7 +1597,7 @@
  <strong class="hl-tag" style="color: #000096">&lt;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">&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;value&gt;</strong>Translated from English content dated <strong class="hl-tag" style="color: #000096">&lt;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">&gt;</strong>%1\$s<strong class="hl-tag" style="color: #000096">&lt;/span&gt;</strong> GMT.<strong class="hl-tag" style="color: #000096">&lt;/value&gt;</strong>
  <strong class="hl-tag" style="color: #000096">&lt;/data&gt;</strong>
-<strong class="hl-tag" style="color: #000096">&lt;/msgList&gt;</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="d0e4169" id="d0e4169" shape="rect"/>Example 36: The <a href="#locNote-datacat" shape="rect">Localization Note</a> data category
+<strong class="hl-tag" style="color: #000096">&lt;/msgList&gt;</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="d0e4187" id="d0e4187" 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">&lt;!DOCTYPE html&gt;</strong>
 <strong class="hl-tag" style="color: #000096">&lt;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">&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;head&gt;</strong>
@@ -1626,14 +1626,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="d0e4267" id="d0e4267" 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">&lt;text&gt;</strong>
+                    IRI referring to the location of the terminology information.</p></li></ul></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d0e4285" id="d0e4285" 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">&lt;text&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;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">&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;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">/&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;/its:rules&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;p&gt;</strong>We may define <strong class="hl-tag" style="color: #000096">&lt;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">&gt;</strong>discoursal point of view<strong class="hl-tag" style="color: #000096">&lt;/term&gt;</strong> as 
     <strong class="hl-tag" style="color: #000096">&lt;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">&gt;</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">&lt;/gloss&gt;</strong><strong class="hl-tag" style="color: #000096">&lt;/p&gt;</strong>
-<strong class="hl-tag" style="color: #000096">&lt;/text&gt;</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="d0e4280" id="d0e4280" 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">&lt;text&gt;</strong>
+<strong class="hl-tag" style="color: #000096">&lt;/text&gt;</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="d0e4298" id="d0e4298" 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">&lt;text&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;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">&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;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">/&gt;</strong>
@@ -1643,7 +1643,7 @@
 structure, between the implied author or some other addresser,
 and the fiction.<strong class="hl-tag" style="color: #000096">&lt;/gloss&gt;</strong><strong class="hl-tag" style="color: #000096">&lt;/p&gt;</strong>
 <strong class="hl-tag" style="color: #000096">&lt;/text&gt;</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="d0e4293" id="d0e4293" 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">&lt;text&gt;</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="d0e4311" id="d0e4311" 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">&lt;text&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;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">&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;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">/&gt;</strong>
@@ -1656,14 +1656,14 @@
 </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. This 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 termConfidence attribute specified MUST be contained in an element with the <code>toolsRef</code> (or in HTML5 <code>its-tools-ref</code>) attribute specified for the terminology data category.</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. This 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 an 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
                 locally, including term information reference and confidence score.</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096">&lt;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">&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;head&gt;</strong>...<strong class="hl-tag" style="color: #000096">&lt;/head&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;body&gt;</strong>
     ... 
     <strong class="hl-tag" style="color: #000096">&lt;p&gt;</strong>And he said: you need a new 
       <strong class="hl-tag" style="color: #000096">&lt;quote</strong> <span class="hl-attribute" style="color: #F5844C">its:term</span>=<span class="hl-value" style="color: #993300">"yes"</span> 
-        <span class="hl-attribute" style="color: #F5844C">its-info-term-ref</span>=<span class="hl-value" style="color: #993300">"http://www.directron.com/motherboards1.html"</span> <span class="hl-attribute" style="color: #F5844C">its-term-confidence</span>=<span class="hl-value" style="color: #993300">"0.5"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>motherboard<strong class="hl-tag" style="color: #000096">&lt;/quote&gt;</strong><strong class="hl-tag" style="color: #000096">&lt;/p&gt;</strong>
+        <span class="hl-attribute" style="color: #F5844C">its:termInfoRef</span>=<span class="hl-value" style="color: #993300">"http://www.directron.com/motherboards1.html"</span> <span class="hl-attribute" style="color: #F5844C">its:termConfidence</span>=<span class="hl-value" style="color: #993300">"0.5"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>motherboard<strong class="hl-tag" style="color: #000096">&lt;/quote&gt;</strong><strong class="hl-tag" style="color: #000096">&lt;/p&gt;</strong>
     ...
  <strong class="hl-tag" style="color: #000096">&lt;/body&gt;</strong> 
 <strong class="hl-tag" style="color: #000096">&lt;/book&gt;</strong>
@@ -1729,7 +1729,7 @@
 <strong class="hl-tag" style="color: #000096">&lt;/its:rules&gt;</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="d0e4581" id="d0e4581" 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="d0e4610" id="d0e4610" 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">&lt;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">&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;body&gt;</strong>
@@ -1738,7 +1738,7 @@
       W3C<strong class="hl-tag" style="color: #000096">&lt;/quote&gt;</strong>.<strong class="hl-tag" style="color: #000096">&lt;/par&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;/body&gt;</strong>
 <strong class="hl-tag" style="color: #000096">&lt;/text&gt;</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="d0e4602" id="d0e4602" 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="d0e4631" id="d0e4631" 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">&lt;!DOCTYPE html&gt;</strong>
 <strong class="hl-tag" style="color: #000096">&lt;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">&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;head&gt;</strong>
@@ -1863,7 +1863,7 @@
               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="d0e5018" id="d0e5018" 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">&lt;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">&gt;</strong>
+                  "no" or "nested".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d0e5047" id="d0e5047" 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">&lt;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">&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;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">/&gt;</strong>
 <strong class="hl-tag" style="color: #000096">&lt;/its:rules&gt;</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",
@@ -2977,7 +2977,7 @@
                <span class="hl-attribute" style="color: #F5844C">title</span>=<span class="hl-value" style="color: #993300">"A tart with a cart"</span><strong class="hl-tag" style="color: #000096">/&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;/p&gt;</strong>  
  <strong class="hl-tag" style="color: #000096">&lt;/body&gt;</strong>
-<strong class="hl-tag" style="color: #000096">&lt;/html&gt;</strong></pre></div><p>[Source file: <a href="examples/html5/EX-mtConfidence-global-html5-1.html" shape="rect">examples/html5/EX-mtConfidence-global-html5-1.html</a>]</p></div><p>Where the external ITS rules file is as shown:</p><div class="exampleOuter"><div class="exampleHeader"><a name="d0e7988" id="d0e7988" shape="rect"/>Example 87: XML file with external rules references from an HTML5 file.</div><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon">&lt;?xml version="1.0" encoding="UTF-8"?&gt;</span>
+<strong class="hl-tag" style="color: #000096">&lt;/html&gt;</strong></pre></div><p>[Source file: <a href="examples/html5/EX-mtConfidence-global-html5-1.html" shape="rect">examples/html5/EX-mtConfidence-global-html5-1.html</a>]</p></div><p>Where the external ITS rules file is as shown:</p><div class="exampleOuter"><div class="exampleHeader"><a name="d0e8017" id="d0e8017" shape="rect"/>Example 87: XML file with external rules references from an HTML5 file.</div><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon">&lt;?xml version="1.0" encoding="UTF-8"?&gt;</span>
 <strong class="hl-tag" style="color: #000096">&lt;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">&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;its:mtConfidenceRule</strong> <span class="hl-attribute" style="color: #F5844C">mtConfidence</span>=<span class="hl-value" style="color: #993300">"0.785"</span> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//h:img[@title='Front gate of Trinity College Dublin']/@title"</span><strong class="hl-tag" style="color: #000096">/&gt;</strong>        
@@ -3543,7 +3543,7 @@
             <em>This section is informative.</em>
          </p><p>Several constraints of ITS markup cannot be validated with ITS schemas. The following
             <a title="Rule-based validation --&#xA;              Schematron" href="#schematron" shape="rect">[Schematron]</a> document allows for validating some of these
-          constraints.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d0e9801" id="d0e9801" shape="rect"/>Example 98: Testing constraints in ITS markup</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096">&lt;schema</strong> <span class="hl-attribute" style="color: #F5844C">xmlns</span>=<span class="hl-value" style="color: #993300">"http://www.ascc.net/xml/schematron"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
+          constraints.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d0e9830" id="d0e9830" shape="rect"/>Example 98: Testing constraints in ITS markup</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096">&lt;schema</strong> <span class="hl-attribute" style="color: #F5844C">xmlns</span>=<span class="hl-value" style="color: #993300">"http://www.ascc.net/xml/schematron"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
   <em class="hl-comment" style="color: silver">&lt;!-- Schematron document to test constraints for global and local ITS markup.
  For ITS markup definitions, see http://www.w3.org/TR/its/ . --&gt;</em>
   <strong class="hl-tag" style="color: #000096">&lt;ns</strong> <span class="hl-attribute" style="color: #F5844C">prefix</span>=<span class="hl-value" style="color: #993300">"its"</span> <span class="hl-attribute" style="color: #F5844C">uri</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">/&gt;</strong>
@@ -3590,7 +3590,7 @@
          </p><p>The following <a title="Namespace-based Validation Dispatching Language&#xA;              (NVDL)" href="#nvdl" shape="rect">[NVDL]</a> document allows validation of ITS
           markup which has been added to a host vocabulary. Only ITS elements and attributes are
           checked. Elements and attributes of host language are ignored during validation against
-          this NVDL document/schema.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d0e9823" id="d0e9823" shape="rect"/>Example 99: NVDL schema for ITS</div><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon">&lt;?xml version="1.0" encoding="UTF-8"?&gt;</span>
+          this NVDL document/schema.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d0e9852" id="d0e9852" shape="rect"/>Example 99: NVDL schema for ITS</div><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon">&lt;?xml version="1.0" encoding="UTF-8"?&gt;</span>
 <strong class="hl-tag" style="color: #000096">&lt;rules</strong> <span class="hl-attribute" style="color: #F5844C">xmlns</span>=<span class="hl-value" style="color: #993300">"http://purl.oclc.org/dsdl/nvdl/ns/structure/1.0"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
   <strong class="hl-tag" style="color: #000096">&lt;namespace</strong> <span class="hl-attribute" style="color: #F5844C">ns</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">&gt;</strong>
     <strong class="hl-tag" style="color: #000096">&lt;validate</strong> <span class="hl-attribute" style="color: #F5844C">schema</span>=<span class="hl-value" style="color: #993300">"its20-elements.rng"</span><strong class="hl-tag" style="color: #000096">/&gt;</strong>   
--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd	2012/11/20 20:40:32	1.247
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd	2012/11/20 21:04:20	1.248
@@ -1765,7 +1765,7 @@
         </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>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 <ref target="#mtconfidence">MT Confidence</ref> data category (provided via the <att>mtConfidence</att> 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 <ref target="#Disambiguation">Disambiguation</ref> data category, providing confidence information via the <att>disambigConfidence</att> attribute, or the <ref target="#terminology">Terminology</ref> data category, providing confidence information via the <att>termConfidence</att> 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>
           
@@ -2560,7 +2560,7 @@
                 referring to the resource providing information about the term.</item>
               <item>An optional <att>termConfidence</att> attribute with the value of a rational number in the interval 0 to 1. This represents the confidence of the agents producing the annotation that the values of the term and, where provided, <att>termInfoRef</att>, are accurate. 1 represents the highest level of confidence. </item>
             </list>
-            <p>Any node selected by the terminology data category with the termConfidence attribute specified MUST be contained in an element with the <att>toolsRef</att> (or in HTML5 <att>its-tools-ref</att>) attribute specified for the terminology data category.</p>
+            <p>Any node selected by the terminology data category with the <att>termConfidence</att> attribute specified <ref target="#rfc2119">MUST</ref> be contained in an element with the <att>toolsRef</att> (or in HTML5 <att>its-tools-ref</att>) attribute specified for the <ref target="#terminology">Terminology</ref> data category. See <ptr target="#its-tool-annotation" type="specref"/> for more information.</p>
             <exemplum xml:id="EX-terms-selector-4">
               <head>The <ref target="#terminology">Terminology</ref> data category expressed
                 locally, including term information reference and confidence score.</head>

Received on Tuesday, 20 November 2012 21:04:28 UTC