- From: CVS User fsasaki <cvsmail@w3.org>
- Date: Thu, 29 Nov 2012 11:40:26 +0000
- To: public-multilingualweb-lt-commits@w3.org
Update of /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20 In directory gil:/tmp/cvs-serv16969 Modified Files: its20.html its20.odd Log Message: action-328 --- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2012/11/29 10:53:07 1.276 +++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2012/11/29 11:40:26 1.277 @@ -1036,7 +1036,13 @@ <strong class="hl-tag" style="color: #000096"><p></strong>A <strong class="hl-tag" style="color: #000096"><term></strong>Palouse horse<strong class="hl-tag" style="color: #000096"></term></strong> has a spotted coat.<strong class="hl-tag" style="color: #000096"></p></strong> <strong class="hl-tag" style="color: #000096"></body></strong> <strong class="hl-tag" style="color: #000096"></myDoc></strong> -</pre></div><p>[Source file: <a href="examples/xml/EX-link-external-rules-3.xml" shape="rect">examples/xml/EX-link-external-rules-3.xml</a>]</p></div><p>Applications processing global ITS markup <a href="#rfc-keywords" shape="rect">MUST</a> +</pre></div><p>[Source file: <a href="examples/xml/EX-link-external-rules-3.xml" shape="rect">examples/xml/EX-link-external-rules-3.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-link-external-rules-4" id="EX-link-external-rules-4" shape="rect"/>Example 22: External rules file with the <code class="its-elem-markup">rules</code> element as the root element</div><p>Like <a href="#EX-link-external-rules-1" shape="rect">Example 19</a>, these rules can be applied e.g. to <a href="#EX-link-external-rules-2" shape="rect">Example 20</a>. The only difference is that in <a href="#EX-link-external-rules-4" shape="rect">Example 22</a>, the <code class="its-elem-markup">rules</code> element is the root element of the external file.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span cass="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">></strong> + <strong class="hl-tag" style="color: #000096"><its:translateRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//header"</span> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">/></strong> + <strong class="hl-tag" style="color: #000096"><its:translateRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//term"</span> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">/></strong> + <strong class="hl-tag" style="color: #000096"><its:termRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//term"</span> <span class="hl-attribute" style="color: #F5844C">term</span>=<span class="hl-value" style="color: #993300">"yes"</span><strong class="hl-tag" style="color: #000096">/></strong> + <strong class="hl-tag" style="color: #000096"><its: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">"//term | //b"</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-link-external-rules-4.xml" shape="rect">examples/xml/EX-link-external-rules-4.xml</a>]</p></div><p>Applications processing global ITS markup <a href="#rfc-keywords" shape="rect">MUST</a> recognize the XLink <code class="its-attr-markup">href</code> attribute in the <code class="its-elem-markup">rules</code> element; they <a href="#rfc-keywords" shape="rect">MUST</a> load the corresponding referenced document and process its rules element before processing the content of the <code class="its-elem-markup">rules</code> element where the original XLink <code class="its-attr-markup">href</code> attribute is.</p><p>External rules may also have links to other external rules. The linking mechanism is @@ -1049,7 +1055,7 @@ precedence.</p><div class="note"><p class="prefix"><b>Note:</b></p><p>The precedence order fulfills the same purpose as the built-in template rules of <a title="XSL Transformations (XSLT)
 Version 1.0" href="#xslt10" shape="rect">[XSLT 1.0]</a>. Override semantics are always complete, that is all information provided via lower precedence is overriden by the higher precedence. E.g. defaults are overridden by inherited values, these are overriden by nodes - selected via global rules, which are in turn overridden by local markup.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-selection-precedence-1" id="EX-selection-precedence-1" shape="rect"/>Example 22: Conflicts between selections of ITS information which are resolved using the + selected via global rules, which are in turn overridden by local markup.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-selection-precedence-1" id="EX-selection-precedence-1" shape="rect"/>Example 23: Conflicts between selections of ITS information which are resolved using the precedence order</div><p>The two elements <code>title</code> and <code>author</code> of this document should be treated as separate content when inside a <code>prolog</code> element, but as part of the content of their parent element otherwise. In order to make this distinction two @@ -1078,7 +1084,7 @@ expectations of the host markup are the same as, or greater than, those of ITS. For example, the <a title="OASIS
 Darwin Information Typing Architecture (DITA) Language Specification
 v1.0" href="#dita10" shape="rect">[DITA 1.0]</a> format can use its translate attribute to apply to “transcluded” content, going beyond the ITS 2.0 local selection - mechanism, but not contradicting it.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-associating-its-with-existing-markup-1" id="EX-associating-its-with-existing-markup-1" shape="rect"/>Example 23: Association of the ITS data categories <a href="#trans-datacat" shape="rect"> + mechanism, but not contradicting it.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-associating-its-with-existing-markup-1" id="EX-associating-its-with-existing-markup-1" shape="rect"/>Example 24: Association of the ITS data categories <a href="#trans-datacat" shape="rect"> Translate</a> and <a href="#terminology" shape="rect">Terminology</a> with DITA 1.0 markup</div><p>In this example, there is an existing <code>translate</code> attribute in DITA, and it is associated with the ITS semantics using the its:rules section. Similarly, the @@ -1110,7 +1116,7 @@ <strong class="hl-tag" style="color: #000096"><p></strong><strong class="hl-tag" style="color: #000096"><ph</strong> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"no"</span> <span class="hl-attribute" style="color: #F5844C">xml:lang</span>=<span class="hl-value" style="color: #993300">"fr"</span><strong class="hl-tag" style="color: #000096">></strong>Et voilà !<strong class="hl-tag" style="color: #000096"></ph></strong>.<strong class="hl-tag" style="color: #000096"></p></strong> <strong class="hl-tag" style="color: #000096"></body></strong> <strong class="hl-tag" style="color: #000096"></topic></strong> -</pre></div><p>[Source file: <a href="examples/xml/EX-associating-its-with-existing-markup-1.xml" shape="rect">examples/xml/EX-associating-its-with-existing-markup-1.xml</a>]</p></div><p>Global rules can be associated with a given XML document using different means:</p><ul><li><p>By using an <code class="its-elem-markup">rules</code> element in the document itself:</p><ul><li><p>with the rules directly inside the document, as shown in <a href="#EX-associating-its-with-existing-markup-1" shape="rect">Example 23</a></p></li><li><p>with a link to an external rules file using the XLink <code class="its-attr-markup">href</code> +</pre></div><p>[Source file: <a href="examples/xml/EX-associating-its-with-existing-markup-1.xml" shape="rect">examples/xml/EX-associating-its-with-existing-markup-1.xml</a>]</p></div><p>Global rules can be associated with a given XML document using different means:</p><ul><li><p>By using an <code class="its-elem-markup">rules</code> element in the document itself:</p><ul><li><p>with the rules directly inside the document, as shown in <a href="#EX-associating-its-with-existing-markup-1" shape="rect">Example 24</a></p></li><li><p>with a link to an external rules file using the XLink <code class="its-attr-markup">href</code> attribute, as shown in <a href="#EX-link-external-rules-1" shape="rect">Example 19</a></p></li></ul></li><li><p>By associating the rules and the document through a tool-specific mechanism. For example, for a command-line tool: providing the paths of both the XML document to process and its corresponding external rules file.</p></li></ul></div><div class="div2"> @@ -1123,7 +1129,7 @@ predicates. A normalized example is given below. The whitespace normalization algorithm itself is format dependent, e.g. it differs for HTML compared to general XML. Hence no normative algorithm for whitespace normalization is given as part of - this specification.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-HTML-whitespace-normalization" id="EX-HTML-whitespace-normalization" shape="rect"/>Example 24: Example of an HTML document with whitespace normalized as preparation for + this specification.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-HTML-whitespace-normalization" id="EX-HTML-whitespace-normalization" shape="rect"/>Example 25: Example of an HTML document with whitespace normalized as preparation for conversion to NIF</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><html></strong><strong class="hl-tag" style="color: #000096"><body></strong><strong class="hl-tag" style="color: #000096"><h2</strong> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"yes"</span><strong class="hl-tag" style="color: #000096">></strong>Welcome to <strong class="hl-tag" style="color: #000096"><span</strong> <span class="hl-attribute" style="color: #F5844C">its-disambig-ident-ref</span>=<span class="hl-value" style="color: #993300">"http://dbpedia.org/resource/Dublin"</span> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">></strong>Dublin<strong class="hl-tag" style="color: #000096"></span></strong> in <strong class="hl-tag" style="color: #000096"><b</strong> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">></strong>Ireland<strong class="hl-tag" style="color: #000096"></b></strong>!<strong class="hl-tag" style="color: #000096"></h2></strong><strong class="hl-tag" style="color: #000096"></body></strong><strong class="hl-tag" style="color: #000096"></html></strong></pre></div></div><p id="its2nif-algorithm">The conversion algorithm to generate NIF consists of seven @@ -1201,12 +1207,12 @@ rdf:type str:OffsetBasedString ; itsrdf:translate "no"^^<strong class="hl-tag" style="color: #000096"><http:</strong>//www.w3.org/TR/its-2.0/its.xsd#yesOrNo> ; str:referenceContext <strong class="hl-tag" style="color: #000096"><http:</strong>//example.com/exampledoc.html#offset_0_29> . -</pre></div></div><p>A complete sample output in RDF/XML format after step 7, given the input document <a href="#EX-HTML-whitespace-normalization" shape="rect">Example 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) +</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 25</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 class="div2"> <h3><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="its-tool-annotation" id="its-tool-annotation" shape="rect"/>5.8 ITS Tools Annotation</h3><p>In some cases, it may be important for instances of data categories to be associated with information about the processor that generated them. For example, the score of the <a href="#mtconfidence" shape="rect">MT Confidence</a> data category (provided via the <code class="its-attr-markup">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 informaton via the <code class="its-attr-markup">disambigConfidence</code> attribute, or the <a href="#terminology" shape="rect">Terminology</a> data category, providing confidence information via the <code class="its-attr-markup">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 class="its-attr-markup">toolsRef</code> provides a way to associate 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 class="its-attr-markup">toolsRef</code> is a space-separated list of references where each reference is composed of two parts: a data category identifier and an IRI. These two parts are separated by a character <code>|</code> VERTICAL LINE (U+007C).</p><ul><li><p>The data category identifier <a href="#rfc219" shape="rect">MUST</a> be one of the identifiers specified in the <a href="#datacategories-overview" shape="rect">data category overview table</a>.</p></li><li><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></li></ul><p>In HTML5 documents, the mechanism is implemented with the <code class="its-attr-markup">its-tools-ref</code> attribute.</p><p>The attribute applies to the content of the element where it is declared (including its children elements) and to the attributes of that element.</p><p>On any given node, the information provided by this mechanism is a space-separated list of the accuulated references found it the <code class="its-attr-markup">toolsRef</code> attributes - declared in the enclosing elements and sorted by data category identifiers. For each data category, the IRI part is the one of the inner-most declarartion.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-tool-annotation-1" id="EX-its-tool-annotation-1" shape="rect"/>Example 25: Accumulation and Overriding of the <code class="its-attr-markup">toolsRef</code> Values</div><p>In this example, the text shows the computed tools reference information for the given node. Note that the references are ordered alphabetically and + declared in the enclosing elements and sorted by data category identifiers. For each data category, the IRI part is the one of the inner-most declarartion.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-tool-annotation-1" id="EX-its-tool-annotation-1" shape="rect"/>Example 26: Accumulation and Overriding of the <code class="its-attr-markup">toolsRef</code> Values</div><p>In this example, the text shows the computed tools reference information for the given node. Note that the references are ordered alphabetically and that the IRI values are always the ones of the inner-most declaration.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><doc</strong> <span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">its:toolsRef</span>=<span class="hl-value" style="color: #993300">"mt-confidence|MT1"</span><strong class="hl-tag" style="color: #000096"> ></strong>doc node: "mt-confidence|MT1" @@ -1220,7 +1226,7 @@ <strong class="hl-tag" style="color: #000096"><p</strong> <span class="hl-attribute" style="color: #F5844C">its:toolsRef</span>=<span class="hl-value" style="color: #993300">"disambiguation|XYZ"</span><strong class="hl-tag" style="color: #000096"> ></strong>This p node: "disambiguation|XYZ mt-confidence|MT1"<strong class="hl-tag" style="color: #000096"></p></strong> <strong class="hl-tag" style="color: #000096"></doc></strong> -</pre></div><p>[Source file: <a href="examples/xml/EX-its-tool-annotation-1.xml" shape="rect">examples/xml/EX-its-tool-annotation-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-tool-annotation-2" id="EX-its-tool-annotation-2" shape="rect"/>Example 26: Example of ITS Tool Annotation</div><p>The <code class="its-attr-markup">toolsRef</code> attribute is used in this XML document to indicate that information about the processor that generated the <code class="its-attr-markup">mtConfidence</code> values +</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 27: Example of ITS Tool Annotation</div><p>The <code class="its-attr-markup">toolsRef</code> attribute is used in this XML document to indicate that information about the processor that generated the <code class="its-attr-markup">mtConfidence</code> values for the first two <code>p</code> elements are found in element with <code>id="T1"</code> in the external document tools.xml, while that information for the third <code>p</code> element is found in the element with <code>id="T2"</code> in the same document. In addition, <code class="its-attr-markup">toolsRef</code> is used to identify a Web resource with information about the QA tool used to generate the <a href="#lqissue" shape="rect">Localization Quality Issue</a> annotation in the document.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><doc</strong> <span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> @@ -1233,7 +1239,7 @@ <strong class="hl-tag" style="color: #000096"><p</strong> <span class="hl-attribute" style="color: #F5844C">its:mtConfidence</span>=<span class="hl-value" style="color: #993300">"0.34"</span> <span class="hl-attribute" style="color: #F5844C">its:toolsRef</span>=<span class="hl-value" style="color: #993300">"mt-confidence|file:///tools.xml#T2"</span><strong class="hl-tag" style="color: #000096">></strong> Text translated with tool T2<strong class="hl-tag" style="color: #000096"></p></strong> <strong class="hl-tag" style="color: #000096"></doc></strong> -</pre></div><p>[Source file: <a href="examples/xml/EX-its-tool-annotation-2.xml" shape="rect">examples/xml/EX-its-tool-annotation-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-tool-annotation-html5-1" id="EX-its-tool-annotation-html5-1" shape="rect"/>Example 27: Example of ITS Tool Annotation</div><p>The <code class="its-attr-markup">its-tools-ref</code> attributes are used in this HTML document to indicate that the <a href="#mtconfidence" shape="rect">MT Confidence</a> annotation on the first two <code>span</code> elements come from one MT (French to English) engine, while the annotation on the third comes from another (Italian to English) engine. Both <code class="its-attr-markup">its-tools-ref</code> attributes refer to a Web resource for information about the engine generating the <a href="#mtconfidence" shape="rect">MT Confidence</a> annotation.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><html</strng> <span class="hl-attribute" style="color: #F5844C">lang</span>=<span class="hl-value" style="color: #993300">en</span><strong class="hl-tag" style="color: #000096">></strong> +</pre></div><p>[Source file: <a href="examples/xml/EX-its-tool-annotation-2.xml" shape="rect">examples/xml/EX-its-tool-annotation-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-tool-annotation-html5-1" id="EX-its-tool-annotation-html5-1" shape="rect"/>Example 28: Example of ITS Tool Annotation</div><p>The <code class="its-attr-markup">its-tools-ref</code> attributes are used in this HTML document to indicate that the <a href="#mtconfidence" shape="rect">MT Confidence</a> annotation on the first two <code>span</code> elements come from one MT (French to English) engine, while the annotation on the third comes from another (Italian to English) engine. Both <code class="its-attr-markup">its-tools-ref</code> attributes refer to a Web resource for information about the engine generating the <a href="#mtconfidence" shape="rect">MT Confidence</a> annotation.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><html</strng> <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 @@ -1286,7 +1292,7 @@ attributes described in <a class="section-ref" href="#html5-local-attributes" shape="rect">Section 6.1: Mapping of Local Data Categories to HTML5</a> and <a href="#rfc2119" shape="rect">SHOULD NOT</a> use <a href="#html5-inline-global-rules" shape="rect">inline global rules</a> in order to adhere to <a href="http://www.w3.org/TR/html-design-principles/#dom-consistency" shape="rect">DOM - Consistency HTML Design Principle</a>.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-xhtml5-markup-1" id="EX-xhtml5-markup-1" shape="rect"/>Example 28: Using ITS 2.0 markup in XHTML5</div><p>This examples illustrates the use of ITS 2.0 local markup and global rules in XHTML5.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: blue"><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"></strong> + Consistency HTML Design Principle</a>.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-xhtml5-markup-1" id="EX-xhtml5-markup-1" shape="rect"/>Example 29: Using ITS 2.0 markup in XHTML5</div><p>This examples illustrates the use of ITS 2.0 local markup and global rules in XHTML5.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: blue"><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"></strong> <strong class="hl-tag" style="color: #000096"><html</strong> <span class="hl-attribute" style="color: #F5844C">xmlns</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/1999/xhtml"</span> <span class="hl-attribute" style="color: #F5844C">xml:lang</span>=<span class="hl-value" style="color: #993300">"en"</span><strong class="hl-tag" style="color: #000096">></strong> <strong class="hl-tag" style="color: #000096"><head></strong> <strong class="hl-tag" style="color: #000096"><title></strong>XHTML and ITS2.0<strong class="hl-tag" style="color: #000096"></title></strong> @@ -1335,7 +1341,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 69</a>. This information does not + available in a <code>target</code> element; see <a href="#EX-target-pointer-global-1" shape="rect">Example 70</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 @@ -1444,7 +1450,7 @@ <a href="#storagesize" shape="rect">Storage Size</a> (<code>storage-size</code>) </td><td rowspan="1" colspan="1">Yes</td><td rowspan="1" colspan="1">Yes</td><td rowspan="1" colspan="1">Yes</td><td rowspan="1" colspan="1">Yes</td><td rowspan="1" colspan="1">None</td><td rowspan="1" colspan="1">None</td><td rowspan="1" colspan="1"> <a href="#EX-storageSize-local-1" shape="rect">local</a>, <a href="#EX-storageSize-global-1" shape="rect">global</a> - </td></tr></tbody></table><div class="exampleOuter"><div class="exampleHeader"><a name="EX-datacat-behavior-1" id="EX-datacat-behavior-1" shape="rect"/>Example 29: 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></tr></tbody></table><div class="exampleOuter"><div class="exampleHeader"><a name="EX-datacat-behavior-1" id="EX-datacat-behavior-1" shape="rect"/>Example 30: 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 class="its-elem-markup">locNote</code> is not translatable because the default is overridden by the local @@ -1492,7 +1498,7 @@ attributes. The default is that elements are translatable and attributes are not.</p><p id="translate-global">GLOBAL: The <code class="its-elem-markup">translateRule</code> element contains the following:</p><ul><li><p>A required <code class="its-attr-markup">selector</code> attribute. It contains an <a href="#selectors" shape="rect">absolute selector</a> which selects the nodes to which this rule applies.</p></li><li><p>A required <code class="its-attr-markup">translate</code> attribute with the value - "yes" or "no".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-translate-selector-1" id="EX-translate-selector-1" shape="rect"/>Example 30: 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 31: The <a href="#trans-datacat" shape="rect">Translate</a> data category expressed globally</div><p>The <code class="its-elem-markup">translateRule</code> element specifies that the elements <code>code</code> must not be translated.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">></strong> <strong class="hl-tag" style="color: #000096"><its:translateRule</strong> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"no"</span> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//code"</span><strong class="hl-tag" style="color: #000096">/></strong> @@ -1502,13 +1508,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 31: 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 32: 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 32: 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 33: 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> @@ -1545,7 +1551,7 @@ rule applies.</p></li><li><p>A required <code class="its-attr-markup">locNoteType</code> attribute with the value "description" or "alert".</p></li><li><p>Exactly one of the following:</p><ul><li><p>A <code class="its-elem-markup">locNote</code> element that contains the note itself and allows for <a href="#selection-local" shape="rect">local ITS markup</a>.</p></li><li><p>A <code class="its-attr-markup">locNotePointer</code> attribute that contains a <a href="#selectors" shape="rect">relative selector</a> pointing to a node that holds the localization note.</p></li><li><p>A <code class="its-attr-markup">locNoteRef</code> attribute that contains an IRI referring to the location of the localization note.</p></li><li><p>A <code class="its-attr-markup">locNoteRefPointer</code> attribute that contains a <a href="#selectors" shape="rect">relative selector</a> pointing to a node that holds the - IRI referring to the location of the localization note.</p></li></ul></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locNote-element-1" id="EX-locNote-element-1" shape="rect"/>Example 33: The <code class="its-elem-markup">locNote</code> element</div><p>The <code class="its-elem-markup">locNoteRule</code> element associates the content of the <code class="its-elem-markup">locNote</code> + IRI referring to the location of the localization note.</p></li></ul></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locNote-element-1" id="EX-locNote-element-1" shape="rect"/>Example 34: The <code class="its-elem-markup">locNote</code> element</div><p>The <code class="its-elem-markup">locNoteRule</code> element associates the content of the <code class="its-elem-markup">locNote</code> element with the message with the identifier 'DisableInfo' and flags it as important. This would also work if the rule 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> @@ -1560,7 +1566,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 34: The <code class="its-attr-markup">locNotePointer</code> attribute</div><p>The <code class="its-attr-markup">locNotePointer</code> attribute is a <a href="#selectors" shape="rect">relative +<strong class="hl-tag" style="color: #000096"></myRes></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locNote-element-1.xml" shape="rect">examples/xml/EX-locNote-element-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locNotePointer-attribute-1" id="EX-locNotePointer-attribute-1" shape="rect"/>Example 35: The <code class="its-attr-markup">locNotePointer</code> attribute</div><p>The <code class="its-attr-markup">locNotePointer</code> attribute is a <a href="#selectors" shape="rect">relative selector</a> pointing to a node that holds the note.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><Res></strong> <strong class="hl-tag" style="color: #000096"><prolog></strong> <strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong> @@ -1578,7 +1584,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 35: The <code class="its-attr-markup">locNoteRef</code> attribute</div><p>The <code class="its-elem-markup">locNoteRule</code> element specifies that the message with the identifier +<strong class="hl-tag" style="color: #000096"></Res></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locNotePointer-attribute-1.xml" shape="rect">examples/xml/EX-locNotePointer-attribute-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locNoteRef-attribute-1" id="EX-locNoteRef-attribute-1" shape="rect"/>Example 36: The <code class="its-attr-markup">locNoteRef</code> attribute</div><p>The <code class="its-elem-markup">locNoteRule</code> element specifies that the message with the identifier 'NotFound' has a corresponding explanation note in an external file. The IRI for the exact location of the note is stored in the <code class="its-attr-markup">locNoteRef</code> attribute.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><myRes></strong> @@ -1591,7 +1597,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="EX-locNoteRefPointer-attribute-1" id="EX-locNoteRefPointer-attribute-1" shape="rect"/>Example 36: The <code class="its-attr-markup">locNoteRefPointer</code> attribute</div><p>The <code class="its-attr-markup">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="EX-locNoteRefPointer-attribute-1" id="EX-locNoteRefPointer-attribute-1" shape="rect"/>Example 37: The <code class="its-attr-markup">locNoteRefPointer</code> attribute</div><p>The <code class="its-attr-markup">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> @@ -1612,7 +1618,7 @@ itself.</p></li><li><p>A <code class="its-attr-markup">locNoteRef</code> attribute that contains an IRI referring to the location of the localization note.</p></li></ul></li><li><p>An optional <code class="its-attr-markup">locNoteType</code> attribute with the value"description" or "alert". If the <code class="its-attr-markup">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="EX-locNote-selector-2" id="EX-locNote-selector-2" shape="rect"/>Example 37: 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="EX-locNote-selector-2" id="EX-locNote-selector-2" shape="rect"/>Example 38: 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> @@ -1620,7 +1626,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="EX-locNote-html5" id="EX-locNote-html5" shape="rect"/>Example 38: 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="EX-locNote-html5" id="EX-locNote-html5" shape="rect"/>Example 39: 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> @@ -1649,14 +1655,14 @@ "yes" or "no".</p></li><li><p>None or exactly one of the following:</p><ul><li><p>A <code class="its-attr-markup">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 class="its-attr-markup">termInfoRef</code> attribute that contains an IRI referring to the resource providing information about the term.</p></li><li><p>A <code class="its-attr-markup">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="EX-terms-selector-1" id="EX-terms-selector-1" shape="rect"/>Example 39: Usage of the <code class="its-attr-markup">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="EX-terms-selector-1" id="EX-terms-selector-1" shape="rect"/>Example 40: Usage of the <code class="its-attr-markup">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="EX-terms-selector-2" id="EX-terms-selector-2" shape="rect"/>Example 40: Usage of the <code class="its-attr-markup">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="EX-terms-selector-2" id="EX-terms-selector-2" shape="rect"/>Example 41: Usage of the <code class="its-attr-markup">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> @@ -1666,7 +1672,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="EX-terms-selector-3" id="EX-terms-selector-3" shape="rect"/>Example 41: Usage of the <code class="its-attr-markup">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="EX-terms-selector-3" id="EX-terms-selector-3" shape="rect"/>Example 42: Usage of the <code class="its-attr-markup">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> @@ -1679,7 +1685,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 class="its-attr-markup">term</code> attribute with the value "yes" or "no".</p></li><li><p>An optional <code class="its-attr-markup">termInfoRef</code> attribute that contains an IRI - referring to the resource providing information about the term.</p></li><li><p>An optional <code class="its-attr-markup">termConfidence</code> attribute with the value of a rational number in the interval 0 to 1 (inclusive). The value follows the <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#decimal" shape="rect">XML Schema decimal data type</a> with the constraining facets <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#rf-minInclusive" shape="rect">minInclusive</a> set to 0 and <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#rf-maxInclusive" shape="rect">maxInclusive</a> set to 1. <code class="its-attr-markup">termConfidence</code> represents the confidence of the agents producing the annotation that the values of the term and, where provided, <code class="its-attr-markup">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 class="its-attr-arkup">termConfidence</code> attribute specified <a href="#rfc2119" shape="rect">MUST</a> be contained in an element with the <code class="its-attr-markup">toolsRef</code> (or in HTML5 <code class="its-attr-markup">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 42: 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 class="its-attr-markup">termConfidence</code> attribute with the value of a rational number in the interval 0 to 1 (inclusive). The value follows the <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#decimal" shape="rect">XML Schema decimal data type</a> with the constraining facets <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#rf-minInclusive" shape="rect">minInclusive</a> set to 0 and <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#rf-maxInclusive" shape="rect">maxInclusive</a> set to 1. <code class="its-attr-markup">termConfidence</code> represents the confidence of the agents producing the annotation that the values of the term and, where provided, <code class="its-attr-markup">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 class="its-attr-arkup">termConfidence</code> attribute specified <a href="#rfc2119" shape="rect">MUST</a> be contained in an element with the <code class="its-attr-markup">toolsRef</code> (or in HTML5 <code class="its-attr-markup">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 43: The <a href="#terminology" shape="rect">Terminology</a> data category expressed locally, including term information reference and confidence score.</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><book</strong> <span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">its:toolsRef</span>=<span class="hl-value" style="color: #993300">"terminology|http://example.com/term-tool"</span><strong class="hl-tag" style="color: #000096">></strong> <strong class="hl-tag" style="color: #000096"><head></strong>...<strong class="hl-tag" style="color: #000096"></head></strong> <strong class="hl-tag" style="color: #000096"><body></strong> @@ -1690,7 +1696,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 43: 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 44: 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> @@ -1735,7 +1741,8 @@ default is that both elements and attributes have the directionality of left-to-right.</p><p id="directionality-global">GLOBAL: The <code class="its-elem-markup">dirRule</code> element contains the following:</p><ul><li><p>A required <code class="its-attr-markup">selector</code> attribute. It contains an <a href="#selectors" shape="rect">absolute selector</a> which selects the nodes to which this - rule applies.</p></li><li><p>A required <code class="its-attr-markup">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" id="EX-dir-selector-1" shape="rect"/>Example 44: Document which needs global rules for directionality</div><p>In this document the right-to-left directionality is marked using a + rule applies.</p></li><li><p>A required <code class="its-attr-markup">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" id="EX-dir-selector-1" shape="rect"/>Example 45: 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>פעילות @@ -1743,14 +1750,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" id="EX-dir-selector-2" 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-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" id="EX-dir-selector-2" shape="rect"/>Example 46: The <a href="#directionality" shape="rect">Directionality</a> data category expressed with global rules</div><p>The <code class="its-elem-markup">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 class="its-attr-markup">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-3" id="EX-dir-selector-3" shape="rect"/>Example 46: 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="EX-dir-selector-3" id="EX-dir-selector-3" shape="rect"/>Example 47: 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> @@ -1759,7 +1766,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="EX-dir-html5-local-1" id="EX-dir-html5-local-1" shape="rect"/>Example 47: 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="EX-dir-html5-local-1" id="EX-dir-html5-local-1" shape="rect"/>Example 48: 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> @@ -1790,7 +1797,7 @@ the ruby parenthesis.</p></li><li><p>An optional <code class="its-elem-markup">rubyText</code> element that contains the ruby text.</p></li><li><p>An optional <code class="its-attr-markup">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 class="its-elem-markup">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 48: Adding ruby text with a <code class="its-elem-markup">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 class="its-elem-markup">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 49: Adding ruby text with a <code class="its-elem-markup">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> @@ -1809,7 +1816,7 @@ allows for <a href="#selection-local" shape="rect">local ITS markup</a>.</p></li><li><p>An <code class="its-elem-markup">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 class="its-elem-markup">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 class="its-elem-markup">span</code> element. </p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-ruby-implementation-1" id="EX-ruby-implementation-1" shape="rect"/>Example 49: The <a href="#ruby-annotation" shape="rect">Ruby</a> data category expressed + the base text.</p></li><li><p>An <code class="its-elem-markup">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 class="its-elem-markup">span</code> element. </p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-ruby-implementation-1" id="EX-ruby-implementation-1" shape="rect"/>Example 50: 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> @@ -1828,7 +1835,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 class="its-elem-markup">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 50: Pointing to language information via <code class="its-elem-markup">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 51: Pointing to language information via <code class="its-elem-markup">langRule</code> </div><p>The following <code class="its-elem-markup">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 @@ -1839,7 +1846,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 <code>lang</code> in HTML, or an attribute specific to the - format in question (as in <a href="#EX-lang-definition-1" shape="rect">Example 50</a>).</p><p>In XML <code>xml:lang</code> is the preferable means of language identification. To ease the + format in question (as in <a href="#EX-lang-definition-1" shape="rect">Example 51</a>).</p><p>In XML <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 no declaration of <code>xml:lang</code> in the non-normative RELAX NG document for @@ -1883,16 +1890,16 @@ inheritance. The default is that elements are not within text.</p><p id="withintext-global">GLOBAL: The <code class="its-elem-markup">withinTextRule</code> element contains the following:</p><ul><li><p>A required <code class="its-attr-markup">selector</code> attribute. It contains an <a href="#selectors" shape="rect">absolute selector</a> which selects the nodes to which this rule applies.</p></li><li><p>A required <code class="its-attr-markup">withinText</code> attribute with the value "yes", - "no" or "nested".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-within-text-implementation-1" id="EX-within-text-implementation-1" shape="rect"/>Example 51: Specifying elements within text with a <code class="its-elem-markup">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="EX-within-text-implementation-1" id="EX-within-text-implementation-1" shape="rect"/>Example 52: Specifying elements within text with a <code class="its-elem-markup">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 class="its-attr-markup">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 52: 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 53: 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 53: 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 54: 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> @@ -1950,14 +1957,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 class="its-attr-markup">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 54: The <code class="its-elem-markup">domainRule</code> element</div><p>The <code class="its-elem-markup">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 55: The <code class="its-elem-markup">domainRule</code> element</div><p>The <code class="its-elem-markup">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 class="its-attr-markup">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 55: The <code class="its-elem-markup">domainRule</code> element</div><p>The <code class="its-elem-markup">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 56: The <code class="its-elem-markup">domainRule</code> element</div><p>The <code class="its-elem-markup">domainRule</code> element expresses that the content of the HTML <code>body</code> element is in the domain expressed by associated values. The <code class="its-attr-markup">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> @@ -1974,7 +1981,7 @@ element with the <code>name</code> attribute set to "keywords", 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 "dcterms.subject" can be used. The usage of both "keywords" - and "dcterms.subject" is shown in example <a href="#EX-domain-2" shape="rect">Example 55</a>.</p><p>In the area of machine translation (e.g. machine translation systems or systems + and "dcterms.subject" is shown in example <a href="#EX-domain-2" shape="rect">Example 56</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 @@ -2051,7 +2058,7 @@ selector.</p></li></ul></li><li><p>To specify the target identity, exactly one of the following: </p><ul><li><p>A <code class="its-attr-markup">disambigIdentPointer</code> attribute that contains a <a href="#selectors" shape="rect">relative selector</a> pointing to a node that represents a unique identifier for the disambiguation target.</p></li><li><p>A <code class="its-attr-markup">disambigIdentRefPointer</code> attribute that contains a <a href="#selectors" shape="rect">relative selector</a> pointing to a node that holds an IRI that represents a unique identifier for the disambiguation - target.</p></li></ul></li></ul></li></ul><p>For an example, see <a href="#EX-disambiguation-html5-rdfa-companion-document" shape="rect">Example 58</a>.</p><p id="disambiguation-local">LOCAL: The following local markup is available for the + target.</p></li></ul></li></ul></li></ul><p>For an example, see <a href="#EX-disambiguation-html5-rdfa-companion-document" shape="rect">Example 59</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 class="its-attr-markup">disambigConfidence</code> attribute with the value of a rational number in the interval 0 to 1 (inclusive). The value follows the <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#decimal" shape="rect">XML Schema decimal data type</a> with the constraining facets <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#rf-minInclusive" shape="rect">minInclusive</a> set to 0 and <a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#rf-maxInclusive" shape="rect">maxInclusive</a> set to 1. <code class="its-attr-markup">disambigConfidence</code> represents the confidence of the agents producing the annotation that the union of the values for the other disambiguation attributes in this instance are accurate. 1 represents the highest level of confidence.</p></li><li><p>An optional <code class="its-attr-markup">disambigGranularity</code> attribute tat 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: "lexicalConcept", "ontologyConcept", or "entity". @@ -2060,7 +2067,7 @@ representing the disambiguation identifier collection source.</p></li><li><p>A <code class="its-attr-markup">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 class="its-attr-markup">disambigIdentRef</code> attribute that contains an IRI that - represents a unique identifier for the disambiguation target.</p></li></ul></li></ul></li></ul></li></ul><p>Any node selected by the <a href="#Disambiguation" shape="rect">disambiguation</a> data category with the <code class="its-attr-markup">disambigConfidence</code> attribute specified <a href="#rfc2119" shape="rect">MUST</a> be contained in an element with the <code class="its-attr-markup">toolsRef</code> (or in HTML5 <code class="its-attr-markup">its-tools-ref</code>) attribute specified for the <a href="#Disambiguation" shape="rect">disambiguation</a> data category. For more information, see <a class="section-ref" href="#its-tool-annotation" shape="rect">Section 5.8: ITS Tools Annotation</a>.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-disambiguation-html5-local-1" id="EX-disambiguation-html5-local-1" shape="rect"/>Example 56: Local mixed usage of Usage of <code class="its-attr-markup">disambigClassRef</code>, + represents a unique identifier for the disambiguation target.</p></li></ul></li></ul></li></ul></li></ul><p>Any node selected by the <a href="#Disambiguation" shape="rect">disambiguation</a> data category with the <code class="its-attr-markup">disambigConfidence</code> attribute specified <a href="#rfc2119" shape="rect">MUST</a> be contained in an element with the <code class="its-attr-markup">toolsRef</code> (or in HTML5 <code class="its-attr-markup">its-tools-ref</code>) attribute specified for the <a href="#Disambiguation" shape="rect">disambiguation</a> data category. For more information, see <a class="section-ref" href="#its-tool-annotation" shape="rect">Section 5.8: ITS Tools Annotation</a>.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-disambiguation-html5-local-1" id="EX-disambiguation-html5-local-1" shape="rect"/>Example 57: Local mixed usage of Usage of <code class="its-attr-markup">disambigClassRef</code>, <code class="its-attr-markup">disambigGranularity</code>, and <code class="its-attr-markup">disambigIdentRef</code> in HTML.</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: blue"><!DOCTYPE html></strong> <strong class="hl-tag" style="color: #000096"><html</strong> <span class="hl-attribute" style="color: #F5844C">lang</span>=<span class="hl-value" style="color: #993300">"en"</span> <span class="hl-attribute" style="color: #F5844C">its-tools-ref</span>=<span class="hl-value" style="color: #993300">"disambiguation|http://enrycher.ijs.si"</span><strong class="hl-tag" style="color: #000096">></strong> <strong class="hl-tag" style="color: #000096"><head></strong> @@ -2087,8 +2094,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 57: Local mixed usage of <code class="its-attr-markup">disambigClassRefPointer</code>, <code class="its-attr-markup">disambigIdentRefPointer</code>, - <code class="its-attr-markup">disambigGranularity</code> in HTML+RDFa Lite.</div><p>See <a href="#EX-disambiguation-html5-rdfa-companion-document" shape="rect">Example 58</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 58: Local mixed usage of <code class="its-attr-markup">disambigClassRefPointer</code>, <code class="its-attr-markup">disambigIdentRefPointer</code>, + <code class="its-attr-markup">disambigGranularity</code> in HTML+RDFa Lite.</div><p>See <a href="#EX-disambiguation-html5-rdfa-companion-document" shape="rect">Example 59</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> @@ -2102,7 +2109,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 58: Companion document, having the mapping data for <a href="#EX-disambiguation-html5-rdfa" shape="rect">Example 57</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 59: Companion document, having the mapping data for <a href="#EX-disambiguation-html5-rdfa" shape="rect">Example 58</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">disambigClassRefPointer</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> @@ -2124,7 +2131,7 @@ ranges from multiple rules or local attributes.</p><p id="localefilter-global">GLOBAL: The <code class="its-elem-markup">localeFilterRule</code> element contains the following:</p><ul><li><p>A required <code class="its-attr-markup">selector</code> attribute. It contains an <a href="#selectors" shape="rect">absolute selector</a> which selects the nodes to which this rule applies.</p></li><li><p>A required <code class="its-attr-markup">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 59: 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 60: The <a href="#LocaleFilter" shape="rect">Locale Filter</a> data category expressed globally</div><p>The <code class="its-elem-markup">localeFilterRule</code> element specifies that certain legal notice elements should only be shown in the specified locales. Note that using the extended language [384 lines skipped] --- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2012/11/29 10:53:07 1.273 +++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2012/11/29 11:40:26 1.274 @@ -1472,7 +1472,12 @@ <egXML xmlns="http://www.tei-c.org/ns/Examples" target="examples/xml/EX-link-external-rules-3.xml"/> </exemplum> - + <exemplum xml:id="EX-link-external-rules-4"> + <head>External rules file with the <gi>rules</gi> element as the root element</head> + <p>Like <ptr target="#EX-link-external-rules-1" type="exref"/>, these rules can be applied e.g. to <ptr type="exref" target="#EX-link-external-rules-2"/>. The only difference is that in <ptr target="#EX-link-external-rules-4" type="exref"/>, the <gi>rules</gi> element is the root element of the external file.</p> + <egXML xmlns="http://www.tei-c.org/ns/Examples" + target="examples/xml/EX-link-external-rules-4.xml"/> + </exemplum> <p>Applications processing global ITS markup <ref target="#rfc-keywords">MUST</ref> recognize the XLink <att>href</att> attribute in the <gi>rules</gi> element; they <ref target="#rfc-keywords">MUST</ref> load the corresponding referenced document and @@ -5435,6 +5440,7 @@ <item>Re-structered <ptr type="specref" target="#html5-global-rules"/> and added XHTML5 example.</item> <item>Made <ptr target="#its-schemas" type="specref"/> a normative section.</item> <item>Moved list of data category identifiers from <ptr target="#its-tool-annotation" type="specref"/> to <ref target="#datacategories-overview">data category overview table</ref>, see <ref target="https://www.w3.org/International/multilingualweb/lt/track/actions/330">action-330</ref>.</item> + <item>Added <ptr target="#EX-link-external-rules-4" type="exref"/>: external rules with <gi>rules</gi> as the root element. See <ref target="https://www.w3.org/International/multilingualweb/lt/track/actions/328">action-328</ref>.</item> </list> <p xml:id="changelog-since-20120829">The following log records major changes that have been made to this document since the <ref target="http://www.w3.org/TR/2012/WD-its20-20120829/"
Received on Thursday, 29 November 2012 11:40:36 UTC