- From: CVS User ysavoure <cvsmail@w3.org>
- Date: Tue, 20 Nov 2012 19:19:06 +0000
- To: public-multilingualweb-lt-commits@w3.org
Update of /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20 In directory gil:/tmp/cvs-serv20488 Modified Files: its20.html its20.odd Log Message: Finished LQI update. --- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2012/11/20 17:36:55 1.244 +++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html 2012/11/20 19:19:06 1.245 @@ -2685,26 +2685,37 @@ <strong class="hl-tag" style="color: #000096"></header></strong>
 <strong class="hl-tag" style="color: #000096"><para></strong>Click the button <strong class="hl-tag" style="color: #000096"><image</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"i1"</span> <span class="hl-attribute" style="color: #F5844C">src</span>=<span class="hl-value" style="color: #993300">"button.png"</span>
 <span class="hl-attribute" style="color: #F5844C">text</span>=<span class="hl-value" style="color: #993300">"start button"</span><strong class="hl-tag" style="color: #000096">/></strong>.<strong class="hl-tag" style="color: #000096"></para></strong>
 -<strong class="hl-tag" style="color: #000096"></doc></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locQualityIssue-global-1.xml" shape="rect">examples/xml/EX-locQualityIssue-global-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityIssue-global-2" id="EX-locQualityIssue-global-2" shape="rect"/>Example 75: Using <code>locQualityIssueRule</code> to map equivalent markup</div><p>The <code>locQualityIssueRule</code> element defines the <code>ref</code> attribute of the <code>mrk</code> element - as the equivalent of the native ITS attribute <code>locQualityIssuesRef</code> which allows to point to a standoff element.</p><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon"><?xml version="1.0"?></span>
 -<strong class="hl-tag" style="color: #000096"><xliff</strong> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span> <span class="hl-attribute" style="color: #F5844C">srclang</span>=<span class="hl-value" style="color: #993300">"fr"</span> <span class="hl-attribute" style="color: #F5844C">xmlns</span>=<span class="hl-value" style="color: #993300">"urn:oasis:names:tc:xliff:document: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">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"><file></strong>
 - <strong class="hl-tag" style="color: #000096"><unit</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">'1'</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><segment></strong>
 - <strong class="hl-tag" style="color: #000096"><source></strong><strong class="hl-tag" style="color: #000096"><mrk</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">'m1'</span> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">'its:lqi'</span> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">'#lqi1'</span><strong class="hl-tag" style="color: #000096">></strong>c'es<strong class="hl-tag" style="color: #000096"></mrk></strong> un exemple<strong class="hl-tag" style="color: #000096"></source></strong>
 - <strong class="hl-tag" style="color: #000096"></segment></strong>
 - <strong class="hl-tag" style="color: #000096"><its:locQualityIssues</strong> <span class="hl-attribute" style="color: #F5844C">xml:id</span>=<span class="hl-value" style="color: #993300">'lqi1'</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><its:locQualityIssue</strong> <span class="hl-attribute" style="color: #F5844C">locQualityIssueComment</span>=<span class="hl-value" style="color: #993300">"Missing capital inital letter"</span><strong class="hl-tag" style="color: #000096">/></strong>
 - <strong class="hl-tag" style="color: #000096"><its:locQualityIssue</strong> <span class="hl-attribute" style="color: #F5844C">locQualityIssueComment</span>=<span class="hl-value" style="color: #993300">"Bad spelling"</span><strong class="hl-tag" style="color: #000096">/></strong>
 - <strong class="hl-tag" style="color: #000096"></its:locQualityIssues></strong>
 - <strong class="hl-tag" style="color: #000096"></unit></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>
 - <strong class="hl-tag" style="color: #000096"><its:locQualityIssueRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//mrk[@type='its:lqi]'"</span>
 - <span class="hl-attribute" style="color: #F5844C">locQualityIssuesRefPointer</span>=<span class="hl-value" style="color: #993300">"@ref"</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"></file></strong>
 -<strong class="hl-tag" style="color: #000096"></xliff></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locQualityIssue-global-2.xml" shape="rect">examples/xml/EX-locQualityIssue-global-2.xml</a>]</p></div><p id="lqissue-local">LOCAL: Using the inline markup to represent the data category +<strong class="hl-tag" style="color: #000096"></doc></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locQualityIssue-global-1.xml" shape="rect">examples/xml/EX-locQualityIssue-global-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityIssue-global-2" id="EX-locQualityIssue-global-2" shape="rect"/>Example 75: Annotating an issue in XML with local standoff markup and a global rule</div><p>The following example shows a document using local standoff markup to encode + several issues. But because, in this case, the <code>mrk</code> element does not + allow attributes from another namespace we cannot use <code>locQualityIssuesRef</code> + directly. Instead, a global rule is used to map the function of + <code>locQualityIssuesRef</code> to a non-ITS construct, here the <code>ref</code> + attribute of any <code>mrk</code> elements that has its attribute <code>type</code> + set to "x-itslq".</p><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon"><?xml version="1.0"?></span>
 +<strong class="hl-tag" style="color: #000096"><doc</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"><file></strong>
 + <strong class="hl-tag" style="color: #000096"><header></strong>
 + <strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong>
 + <strong class="hl-tag" style="color: #000096"><its:locQualityIssueRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//mrk[@type='x-itslq']"</span>
 + <span class="hl-attribute" style="color: #F5844C">locQualityIssuesRefPointer</span>=<span class="hl-value" style="color: #993300">"@ref"</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"></header></strong>
 + <strong class="hl-tag" style="color: #000096"><unit</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"1"</span><strong class="hl-tag" style="color: #000096">></strong>
 + <strong class="hl-tag" style="color: #000096"><segment></strong>
 + <strong class="hl-tag" style="color: #000096"><source></strong>This is the content<strong class="hl-tag" style="color: #000096"></source></strong>
 + <strong class="hl-tag" style="color: #000096"><target></strong><strong class="hl-tag" style="color: #000096"><mrk</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"x-itslq"</span> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"#lq1"</span><strong class="hl-tag" style="color: #000096">></strong>c'es<strong class="hl-tag" style="color: #000096"></mrk></strong> le contenu<strong class="hl-tag" style="color: #000096"></target></strong>
 + <strong class="hl-tag" style="color: #000096"></segment></strong>
 + <strong class="hl-tag" style="color: #000096"><its:locQualityIssues</strong> <span class="hl-attribute" style="color: #F5844C">xml:id</span>=<span class="hl-value" style="color: #993300">"lq1"</span><strong class="hl-tag" style="color: #000096">></strong>
 + <strong class="hl-tag" style="color: #000096"><its:locQualityIssue</strong> <span class="hl-attribute" style="color: #F5844C">locQualityIssueType</span>=<span class="hl-value" style="color: #993300">"misspelling"</span>
 + <span class="hl-attribute" style="color: #F5844C">locQualityIssueComment</span>=<span class="hl-value" style="color: #993300">"'c'es' is unknown. Could be 'c'est'"</span>
 + <span class="hl-attribute" style="color: #F5844C">locQualityIssueSeverity</span>=<span class="hl-value" style="color: #993300">"50"</span><strong class="hl-tag" style="color: #000096">/></strong>
 + <strong class="hl-tag" style="color: #000096"><its:locQualityIssue</strong> <span class="hl-attribute" style="color: #F5844C">locQualityIssueType</span>=<span class="hl-value" style="color: #993300">"typographical"</span>
 + <span class="hl-attribute" style="color: #F5844C">locQualityIssueComment</span>=<span class="hl-value" style="color: #993300">"Sentence without capitalization"</span>
 + <span class="hl-attribute" style="color: #F5844C">locQualityIssueSeverity</span>=<span class="hl-value" style="color: #993300">"30"</span><strong class="hl-tag" style="color: #000096">/></strong>
 + <strong class="hl-tag" style="color: #000096"></its:locQualityIssues></strong>
 + <strong class="hl-tag" style="color: #000096"></unit></strong>
 + <strong class="hl-tag" style="color: #000096"></file></strong>
 +<strong class="hl-tag" style="color: #000096"></doc></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locQualityIssue-global-2.xml" shape="rect">examples/xml/EX-locQualityIssue-global-2.xml</a>]</p></div><p id="lqissue-local">LOCAL: Using the inline markup to represent the data category locally is limited to a single occurrence for a given content (e.g. one cannot have different <code>locQualityIssueType</code> attributes applied to the same span of text because the inner-most one would override the others). A local <em>standoff @@ -2716,9 +2727,9 @@ information</a>.</p></li><li><p>An optional <code>locQualityIssueEnabled</code> attribute that implements the <a href="#lqissueDefs" shape="rect">enabled information</a>.</p></li></ul></li><li><p>Or (standoff markup):</p><ul><li><p>A <code>locQualityIssuesRef</code> attribute. Its value is an IRI pointing to the <code>locQualityIssues</code> element containing the list of issues related - to this content.</p></li><li><p>An element <code>locQualityIssues</code> (or <code><span - loc-quality-issues></code> in HTML) which contains:</p><span class="editor-note">[Ed. note: Add an example using standoff on an attribute.]</span><ul><li><p>One or more elements <code>locQualityIssue</code> (or <code><span - its-loc-quality-issue></code> in HTML), each of which contains:</p><ul><li><p>At least one of the following attributes:</p><ul><li><p>A <code>locQualityIssueType</code> attribute that implements + to this content.</p></li><li><p>An element <code>locQualityIssues</code> with a <code>xml:id</code> attribute set to + the identifier specified in the <code>locQualityIssuesRef</code> attribute. + The <code>locQualityIssues</code> element contains:</p><ul><li><p>One or more elements <code>locQualityIssue</code>, each of which contains:</p><ul><li><p>At least one of the following attributes:</p><ul><li><p>A <code>locQualityIssueType</code> attribute that implements the <a href="#lqissueDefs" shape="rect">type information</a>.</p></li><li><p>A <code>locQualityIssueComment</code> attribute that implements the <a href="#lqissueDefs" shape="rect">comment information</a>.</p></li></ul></li><li><p>An optional <code>locQualityIssueSeverity</code> attribute that @@ -2727,13 +2738,14 @@ implements the <a href="#lqissueDefs" shape="rect">profile reference information</a>.</p></li><li><p>An optional <code>locQualityIssueEnabled</code> attribute that implements the <a href="#lqissueDefs" shape="rect">enabled - information</a>.</p></li></ul></li></ul></li></ul></li></ul><p>Important: When the attributes <code>locQualityIssueType</code>, - <code>locQualityIssueComment</code>, <code>locQualityIssueSeverity</code> and - <code>locQualityIssueProfileRef</code> (or their equivalent representations) are used - in in a standoff manner, the information they carry pertains to the content of the - element that refers to the standoff annotation, not to the content of the element - <code>locQualityIssue</code> (or <code><span loc-quality-issue></code>in HTML) where - they are declared.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityIssue-local-1" id="EX-locQualityIssue-local-1" shape="rect"/>Example 76: Annotating an issue in XML with local inline markup</div><p>The attributes <code>locQualityIssueType</code>, <code>locQualityIssueComment</code> + information</a>.</p></li></ul></li></ul></li></ul><div class="note"><p class="prefix"><b>Note:</b></p><p>When the attributes <code>locQualityIssueType</code>, + <code>locQualityIssueComment</code>, <code>locQualityIssueSeverity</code>, + <code>locQualityIssueProfileRef</code> and <code>locQualityIssueEnabled</code> are used + in in a standoff manner, the information they carry pertains to the content of the + element that refers to the standoff annotation, not to the content of the element + <code>locQualityIssue</code> where they are declared.</p></div><div class="note"><p class="prefix"><b>Note:</b></p><p>In HTML5 the standoff markup <a href="#rfc-keywords" shape="rect">MUST</a> be stored inside a <code>script</code> element with + its <code>id</code> attribute that <a href="#rfc-keywords" shape="rect">MUST</a> be set to the same value as the <code>xml:id</code> + attribute of the <code>locQualityIssues</code> element it contains.</p></div></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityIssue-local-1" id="EX-locQualityIssue-local-1" shape="rect"/>Example 76: Annotating an issue in XML with local inline markup</div><p>The attributes <code>locQualityIssueType</code>, <code>locQualityIssueComment</code> and <code>locQualityIssueSeverity</code> are used to associate the issue information directly with a selected span of content.</p><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon"><?xml version="1.0"?></span>
 <strong class="hl-tag" style="color: #000096"><doc</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>
 @@ -2797,37 +2809,7 @@ <strong class="hl-tag" style="color: #000096"></trans-unit></strong>
 <strong class="hl-tag" style="color: #000096"></body></strong>
 <strong class="hl-tag" style="color: #000096"></file></strong>
 -<strong class="hl-tag" style="color: #000096"></xliff></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locQualityIssue-local-2.xml" shape="rect">examples/xml/EX-locQualityIssue-local-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityIssue-local-3" id="EX-locQualityIssue-local-3" shape="rect"/>Example 79: Annotating an issue in XML with local standoff markup and a global rule</div><p>The following example shows a document using local standoff markup to encode - several issues. But because, in this case, the <code>mrk</code> element does not - allow attributes from another namespace we cannot use <code>locQualityIssuesRef</code> - directly. Instead, a global rule is used to map the function of - <code>locQualityIssuesRef</code> to a non-ITS construct, here the <code>ref</code> - attribute of any <code>mrk</code> elements that has its attribute <code>type</code> - set to "x-itslq".</p><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon"><?xml version="1.0"?></span>
 -<strong class="hl-tag" style="color: #000096"><doc</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"><file></strong>
 - <strong class="hl-tag" style="color: #000096"><header></strong>
 - <strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><its:locQualityIssueRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//mrk[@type='x-itslq']"</span>
 - <span class="hl-attribute" style="color: #F5844C">locQualityIssuesRefPointer</span>=<span class="hl-value" style="color: #993300">"@ref"</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"></header></strong>
 - <strong class="hl-tag" style="color: #000096"><unit</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"1"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><segment></strong>
 - <strong class="hl-tag" style="color: #000096"><source></strong>This is the content<strong class="hl-tag" style="color: #000096"></source></strong>
 - <strong class="hl-tag" style="color: #000096"><target></strong><strong class="hl-tag" style="color: #000096"><mrk</strong> <span class="hl-attribute" style="color: #F5844C">type</span>=<span class="hl-value" style="color: #993300">"x-itslq"</span> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"#lq1"</span><strong class="hl-tag" style="color: #000096">></strong>c'es<strong class="hl-tag" style="color: #000096"></mrk></strong> le contenu<strong class="hl-tag" style="color: #000096"></target></strong>
 - <strong class="hl-tag" style="color: #000096"></segment></strong>
 - <strong class="hl-tag" style="color: #000096"><its:locQualityIssues</strong> <span class="hl-attribute" style="color: #F5844C">xml:id</span>=<span class="hl-value" style="color: #993300">"lq1"</span><strong class="hl-tag" style="color: #000096">></strong>
 - <strong class="hl-tag" style="color: #000096"><its:locQualityIssue</strong> <span class="hl-attribute" style="color: #F5844C">locQualityIssueType</span>=<span class="hl-value" style="color: #993300">"misspelling"</span>
 - <span class="hl-attribute" style="color: #F5844C">locQualityIssueComment</span>=<span class="hl-value" style="color: #993300">"'c'es' is unknown. Could be 'c'est'"</span>
 - <span class="hl-attribute" style="color: #F5844C">locQualityIssueSeverity</span>=<span class="hl-value" style="color: #993300">"50"</span><strong class="hl-tag" style="color: #000096">/></strong>
 - <strong class="hl-tag" style="color: #000096"><its:locQualityIssue</strong> <span class="hl-attribute" style="color: #F5844C">locQualityIssueType</span>=<span class="hl-value" style="color: #993300">"typographical"</span>
 - <span class="hl-attribute" style="color: #F5844C">locQualityIssueComment</span>=<span class="hl-value" style="color: #993300">"Sentence without capitalization"</span>
 - <span class="hl-attribute" style="color: #F5844C">locQualityIssueSeverity</span>=<span class="hl-value" style="color: #993300">"30"</span><strong class="hl-tag" style="color: #000096">/></strong>
 - <strong class="hl-tag" style="color: #000096"></its:locQualityIssues></strong>
 - <strong class="hl-tag" style="color: #000096"></unit></strong>
 - <strong class="hl-tag" style="color: #000096"></file></strong>
 -<strong class="hl-tag" style="color: #000096"></doc></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locQualityIssue-local-3.xml" shape="rect">examples/xml/EX-locQualityIssue-local-3.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityIssue-html5-local-2" id="EX-locQualityIssue-html5-local-2" shape="rect"/>Example 80: Annotating an issue in HTML with local standoff markup</div><p>The following example shows a document using local standoff markup to encode +<strong class="hl-tag" style="color: #000096"></xliff></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locQualityIssue-local-2.xml" shape="rect">examples/xml/EX-locQualityIssue-local-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityIssue-html5-local-2" id="EX-locQualityIssue-html5-local-2" shape="rect"/>Example 79: Annotating an issue in HTML with local standoff markup</div><p>The following example shows a document using local standoff markup to encode several issues. The <code>span</code> element delimits the content to markup and holds a <code>loc-quality-issues-ref</code> attribute that points to a special <code>span</code> element where the issues are listed within a set of other @@ -2855,8 +2837,7 @@ <strong class="hl-tag" style="color: #000096"><p></strong>
 <strong class="hl-tag" style="color: #000096"><span</strong> <span class="hl-attribute" style="color: #F5844C">its-loc-quality-issues-ref</span>=<span class="hl-value" style="color: #993300">#lq1</span><strong class="hl-tag" style="color: #000096">></strong>c'es<strong class="hl-tag" style="color: #000096"></span></strong> le contenu<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-locQualityIssue-html5-local-2.html" shape="rect">examples/html5/EX-locQualityIssue-html5-local-2.html</a>]</p></div><span class="editor-note">[Ed. note: TODO for in general: make sure standoff examples in HTML5 use the - 'script' notation.]</span></div></div><div class="div2"> +<strong class="hl-tag" style="color: #000096"></html></strong></pre></div><p>[Source file: <a href="examples/html5/EX-locQualityIssue-html5-local-2.html" shape="rect">examples/html5/EX-locQualityIssue-html5-local-2.html</a>]</p></div></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="lqprecis" id="lqprecis" shape="rect"/>6.19 Localization Quality Précis</h3><div class="div3"> <h4><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="lqprecis-definition" id="lqprecis-definition" shape="rect"/>6.19.1 Definition</h4><p>The <a href="#lqprecis" shape="rect">Localization Quality Précis</a> data category is used to express an overall measurement of the localization quality of a document or an item @@ -2888,7 +2869,7 @@ exact same semantics as <code>locQualityPrecisProfileRef</code>.</p></li></ul></li></ul><div class="note"><p class="prefix"><b>Note:</b></p><p>The attributes <code>locQualityPrecisScorePointer</code>, <code>locQualityPrecisThresholdPointer</code>, and <code>locQualityPrecisProfileRefPointer</code> do not apply to HTML as local markup - is provided for direct annotation in HTML.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityPrecis-global-1" id="EX-locQualityPrecis-global-1" shape="rect"/>Example 81: The <a href="#lqprecis" shape="rect">Localization Quality Précis</a> data category + is provided for direct annotation in HTML.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityPrecis-global-1" id="EX-locQualityPrecis-global-1" shape="rect"/>Example 80: The <a href="#lqprecis" shape="rect">Localization Quality Précis</a> data category expressed globally in XML</div><p>The following example shows how to use the <code>locQualityPrecisRule</code> element to specify the score, threshold and profile for a document.</p><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon"><?xml version="1.0"?></span>
 <strong class="hl-tag" style="color: #000096"><doc></strong>
 @@ -2901,7 +2882,7 @@ <strong class="hl-tag" style="color: #000096"></its:rules></strong>
 <strong class="hl-tag" style="color: #000096"></header></strong>
 <strong class="hl-tag" style="color: #000096"><para></strong>This is an example<strong class="hl-tag" style="color: #000096"></para></strong>
 -<strong class="hl-tag" style="color: #000096"></doc></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locQualityPrecis-global-1.xml" shape="rect">examples/xml/EX-locQualityPrecis-global-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityPrecis-global-2" id="EX-locQualityPrecis-global-2" shape="rect"/>Example 82: Using pointers to map the <a href="#lqprecis" shape="rect">Localization Quality +<strong class="hl-tag" style="color: #000096"></doc></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locQualityPrecis-global-1.xml" shape="rect">examples/xml/EX-locQualityPrecis-global-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityPrecis-global-2" id="EX-locQualityPrecis-global-2" shape="rect"/>Example 81: Using pointers to map the <a href="#lqprecis" shape="rect">Localization Quality Précis</a> data category in XML</div><p>The following example shows how the <code>locQualityPrecisVotePointer</code>, <code>locQualityPrecisThresholdPointer</code> and <code>locQualityPrecisProfileRefPointer</code> can be used to map the data category @@ -2917,7 +2898,7 @@ <strong class="hl-tag" style="color: #000096"></its:rules></strong>
 <strong class="hl-tag" style="color: #000096"></header></strong>
 <strong class="hl-tag" style="color: #000096"><para></strong>This is not popular<strong class="hl-tag" style="color: #000096"></para></strong>
 -<strong class="hl-tag" style="color: #000096"></doc></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locQualityPrecis-global-2.xml" shape="rect">examples/xml/EX-locQualityPrecis-global-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityPrecis-html5-global" id="EX-locQualityPrecis-html5-global" shape="rect"/>Example 83: The <a href="#lqprecis" shape="rect">Localization Quality Précis</a> data category +<strong class="hl-tag" style="color: #000096"></doc></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locQualityPrecis-global-2.xml" shape="rect">examples/xml/EX-locQualityPrecis-global-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityPrecis-html5-global" id="EX-locQualityPrecis-html5-global" shape="rect"/>Example 82: The <a href="#lqprecis" shape="rect">Localization Quality Précis</a> data category expressed globally in HTML</div><p>The following example shows how to use the <code>locQualityPrecisRule</code> element to specify the score, threshold and profile for an HTML document.</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>
 @@ -2929,7 +2910,7 @@ <strong class="hl-tag" style="color: #000096"><body></strong>
 <strong class="hl-tag" style="color: #000096"><p></strong>This is an example.<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-locQualityPrecis-html5-global.html" shape="rect">examples/html5/EX-locQualityPrecis-html5-global.html</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityPrecisRule-html5-global" id="EX-locQualityPrecisRule-html5-global" shape="rect"/>Example 84: External rule document associated with an HTML5 document</div><p>This document is used in <a href="#EX-locQualityPrecis-html5-global" shape="rect">Example 83</a>:</p><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon"><?xml version="1.0"?></span>
 +<strong class="hl-tag" style="color: #000096"></html></strong></pre></div><p>[Source file: <a href="examples/html5/EX-locQualityPrecis-html5-global.html" shape="rect">examples/html5/EX-locQualityPrecis-html5-global.html</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityPrecisRule-html5-global" id="EX-locQualityPrecisRule-html5-global" shape="rect"/>Example 83: External rule document associated with an HTML5 document</div><p>This document is used in <a href="#EX-locQualityPrecis-html5-global" shape="rect">Example 82</a>:</p><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon"><?xml version="1.0"?></span>
 <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:locQualityPrecisRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"/html"</span>
 <span class="hl-attribute" style="color: #F5844C">locQualityPrecisScore</span>=<span class="hl-value" style="color: #993300">"100"</span>
 @@ -2942,7 +2923,7 @@ signed integer which indicates the lowest score or vote that constitutes a passing score or a passing vote in the profile used.</p></li><li><p>An optional <code>locQualityPrecisProfileRef</code> attribute. Its value is a IRI pointing to the reference document describing the quality assessment model - used for the scoring.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityPrecis-local-1" id="EX-locQualityPrecis-local-1" shape="rect"/>Example 85: The <a href="#lqprecis" shape="rect">Localization Quality Précis</a> data category + used for the scoring.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityPrecis-local-1" id="EX-locQualityPrecis-local-1" shape="rect"/>Example 84: The <a href="#lqprecis" shape="rect">Localization Quality Précis</a> data category expressed locally in XML</div><p>The <code>locQualityPrecisScore</code>, <code>locQualityPrecisThreshold</code> and <code>locQualityPrecisProfileRef</code> are used to score the quality of the document.</p><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon"><?xml version="1.0"?></span>
 @@ -2956,7 +2937,7 @@ she saw the state his clothes were in her resolution to turn his Saturday
 holiday into captivity at hard labor became adamantine in its
 firmness.<strong class="hl-tag" style="color: #000096"></para></strong>
 -<strong class="hl-tag" style="color: #000096"></doc></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locQualityPrecis-local-1.xml" shape="rect">examples/xml/EX-locQualityPrecis-local-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityPrecis-html5-local" id="EX-locQualityPrecis-html5-local" shape="rect"/>Example 86: The <a href="#lqprecis" shape="rect">Localization Quality Précis</a> data category +<strong class="hl-tag" style="color: #000096"></doc></strong></pre></div><p>[Source file: <a href="examples/xml/EX-locQualityPrecis-local-1.xml" shape="rect">examples/xml/EX-locQualityPrecis-local-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityPrecis-html5-local" id="EX-locQualityPrecis-html5-local" shape="rect"/>Example 85: The <a href="#lqprecis" shape="rect">Localization Quality Précis</a> data category expressed locally in HTML</div><p>The <code>its-loc-quality-precis-score</code>, <code>its-loc-quality-precis-threshold</code> and <code>its-loc-quality-precis-profile-ref</code> are used to score the quality of the @@ -3004,7 +2985,7 @@ the following:</p><ul><li><p>A required <code>selector</code> attribute. It contains an <a href="#selectors" shape="rect">absolute selector</a> which selects the nodes to which this rule applies.</p></li><li><p>A required <code>mtConfidence</code> attribute with a value that represents the translation confidence score as a rational number in the interval 0 to - 1 inclusive.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-xmConfidence-global-html5-1" id="EX-xmConfidence-global-html5-1" shape="rect"/>Example 87: Global usage of <code>mtConfidenceRule</code> in a HTML document to specify the + 1 inclusive.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-xmConfidence-global-html5-1" id="EX-xmConfidence-global-html5-1" shape="rect"/>Example 86: Global usage of <code>mtConfidenceRule</code> in a HTML document to specify the confidence scores for the translation into English of the <code>title</code> attributes of two <code>img</code> elements.</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>
 @@ -3022,7 +3003,7 @@ <span class="hl-attribute" style="color: #F5844C">title</span>=<span class="hl-value" style="color: #993300">"A tart with a cart"</span><strong class="hl-tag" style="color: #000096">/></strong>
 <strong class="hl-tag" style="color: #000096"></p></strong> 
 <strong class="hl-tag" style="color: #000096"></body></strong>
 -<strong class="hl-tag" style="color: #000096"></html></strong></pre></div><p>[Source file: <a href="examples/html5/EX-mtConfidence-global-html5-1.html" shape="rect">examples/html5/EX-mtConfidence-global-html5-1.html</a>]</p></div><p>Where the external ITS rules file is as shown:</p><div class="exampleOuter"><div class="exampleHeader"><a name="d0e8049" id="d0e8049" shape="rect"/>Example 88: XML file with external rules references from an HTML5 file.</div><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon"><?xml version="1.0" encoding="UTF-8"?></span>
 +<strong class="hl-tag" style="color: #000096"></html></strong></pre></div><p>[Source file: <a href="examples/html5/EX-mtConfidence-global-html5-1.html" shape="rect">examples/html5/EX-mtConfidence-global-html5-1.html</a>]</p></div><p>Where the external ITS rules file is as shown:</p><div class="exampleOuter"><div class="exampleHeader"><a name="d0e8041" id="d0e8041" shape="rect"/>Example 87: XML file with external rules references from an HTML5 file.</div><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon"><?xml version="1.0" encoding="UTF-8"?></span>
 <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:mtConfidenceRule</strong> <span class="hl-attribute" style="color: #F5844C">mtConfidence</span>=<span class="hl-value" style="color: #993300">"0.785"</span> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//h:img[@title='Front gate of Trinity College Dublin']/@title"</span><strong class="hl-tag" style="color: #000096">/></strong> 
 @@ -3031,7 +3012,7 @@ 
 </pre></div><p>[Source file: <a href="examples/html5/EX-mtconfidence-global-html5-1-external-rules.xml" shape="rect">examples/html5/EX-mtconfidence-global-html5-1-external-rules.xml</a>]</p></div><p id="mtconfidence-local">LOCAL: the following local markup is available for the <a href="#mtconfidence" shape="rect">MT Confidence</a> data category:</p><ul><li><p>A <code>mtConfidence</code> attribute with a value that represents the translation - confidence score as a rational number in the interval 0 to 1 inclusive.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-mtConfidence-local-1" id="EX-mtConfidence-local-1" shape="rect"/>Example 89: The <a href="#mtconfidence" shape="rect">MT Confidence</a> data category expressed + confidence score as a rational number in the interval 0 to 1 inclusive.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-mtConfidence-local-1" id="EX-mtConfidence-local-1" shape="rect"/>Example 88: The <a href="#mtconfidence" shape="rect">MT Confidence</a> data category expressed locally for the content of a span in an XML document.</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> <span class="hl-attribute" style="color: #F5844C">its:toolsRef</span>=<span class="hl-value" style="color: #993300">"MTConfidence|file:///tools.xml#T1"</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"><p></strong>
 @@ -3039,7 +3020,7 @@ Ireland.<strong class="hl-tag" style="color: #000096"></span></strong>
 <strong class="hl-tag" style="color: #000096"></p></strong>
 <strong class="hl-tag" style="color: #000096"></body></strong>
 -<strong class="hl-tag" style="color: #000096"></text></strong></pre></div><p>[Source file: <a href="examples/xml/EX-mtConfidence-local-1.xml" shape="rect">examples/xml/EX-mtConfidence-local-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-mtConfidence-html5-local-1" id="EX-mtConfidence-html5-local-1" shape="rect"/>Example 90: The <a href="#mtconfidence" shape="rect">MT Confidence</a> data category expressed +<strong class="hl-tag" style="color: #000096"></text></strong></pre></div><p>[Source file: <a href="examples/xml/EX-mtConfidence-local-1.xml" shape="rect">examples/xml/EX-mtConfidence-local-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-mtConfidence-html5-local-1" id="EX-mtConfidence-html5-local-1" shape="rect"/>Example 89: The <a href="#mtconfidence" shape="rect">MT Confidence</a> data category expressed locally for the content of two separate spans in a HTML5 document.</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>
 @@ -3086,7 +3067,7 @@ contains the following:</p><ul><li><p>A required <code>selector</code> attribute. It contains an <a href="#selectors" shape="rect">absolute selector</a> which selects the nodes to which this rule applies.</p></li><li><p>Exactly one of the following:</p><ul><li><p>A <code>allowedCharacters</code> attribute that contains the regular expression indicating the allowed characters.</p></li><li><p>A <code>allowedCharactersPointer</code> attribute that contains a <a href="#selectors" shape="rect">relative selector</a> pointing to a node with the - exact same semantics as <code>allowedCharacters</code>.</p></li></ul></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-allowedCharacters-global-1" id="EX-allowedCharacters-global-1" shape="rect"/>Example 91: The <a href="#allowedchars" shape="rect">Allowed Characters</a> data category expressed + exact same semantics as <code>allowedCharacters</code>.</p></li></ul></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-allowedCharacters-global-1" id="EX-allowedCharacters-global-1" shape="rect"/>Example 90: The <a href="#allowedchars" shape="rect">Allowed Characters</a> data category expressed globally in XML</div><p>The <code>allowedCharactersRule</code> element states that the translated content of elements <code>content</code> must not contain the characters <code>*</code> and <code>+</code>.</p><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon"><?xml version="1.0"?></span>
 @@ -3101,7 +3082,7 @@ nonumy eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed
 diam voluptua.<strong class="hl-tag" style="color: #000096"></content></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-allowedCharacters-global-1.xml" shape="rect">examples/xml/EX-allowedCharacters-global-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-allowedCharacters-global-2" id="EX-allowedCharacters-global-2" shape="rect"/>Example 92: Mapping the <a href="#allowedchars" shape="rect">Allowed Characters</a> data category +<strong class="hl-tag" style="color: #000096"></myRes></strong></pre></div><p>[Source file: <a href="examples/xml/EX-allowedCharacters-global-1.xml" shape="rect">examples/xml/EX-allowedCharacters-global-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-allowedCharacters-global-2" id="EX-allowedCharacters-global-2" shape="rect"/>Example 91: Mapping the <a href="#allowedchars" shape="rect">Allowed Characters</a> data category in XML</div><p>The attribute <code>allowedCharactersPointer</code> is used to map the data category to the non-ITS attribute <code>set</code> in this document. The attribute has the same semantics as <code>allowedCharacters</code>.</p><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon"><?xml version="1.0"?></span>
 @@ -3114,14 +3095,14 @@ <strong class="hl-tag" style="color: #000096"><record</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"a1"</span> <span class="hl-attribute" style="color: #F5844C">set</span>=<span class="hl-value" style="color: #993300">"[ &#xFF01;–&#xFF5E;]"</span><strong class="hl-tag" style="color: #000096">></strong>FULL WIDTH ONLY<strong class="hl-tag" style="color: #000096"></record></strong>
 <strong class="hl-tag" style="color: #000096"></res></strong></pre></div><p>[Source file: <a href="examples/xml/EX-allowedCharacters-global-2.xml" shape="rect">examples/xml/EX-allowedCharacters-global-2.xml</a>]</p></div><p id="allowedchars-local">LOCAL: the following local markup is available for the <a href="#allowedchars" shape="rect">Allowed Characters</a> data category:</p><ul><li><p>A <code>allowedCharacters</code> attribute that contains the regular expression - indicating the allowed characters.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-allowedCharacters-local-1" id="EX-allowedCharacters-local-1" shape="rect"/>Example 93: The <a href="#allowedchars" shape="rect">Allowed Characters</a> data category expressed + indicating the allowed characters.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-allowedCharacters-local-1" id="EX-allowedCharacters-local-1" shape="rect"/>Example 92: The <a href="#allowedchars" shape="rect">Allowed Characters</a> data category expressed locally in XML</div><p>The local <code>allowedCharacters</code> attribute specifies that the translated content of element <code>panelmsg</code> must contain only Unicode characters between U+0020 and U+00FE.</p><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon"><?xml version="1.0"?></span>
 <strong class="hl-tag" style="color: #000096"><messages</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"><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 the <strong class="hl-tag" style="color: #000096"><panelmsg</strong> <span class="hl-attribute" style="color: #F5844C">its:allowedCharacters</span>=<span class="hl-value" style="color: #993300">"[&#x0020;-&#x00FE;]"</span><strong class="hl-tag" style="color: #000096">
 ></strong>CONTINUE<strong class="hl-tag" style="color: #000096"></panelmsg></strong> Button on the 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-allowedCharacters-local-1.xml" shape="rect">examples/xml/EX-allowedCharacters-local-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-allowedCharacters-html5-local-1" id="EX-allowedCharacters-html5-local-1" shape="rect"/>Example 94: The <a href="#allowedchars" shape="rect">Allowed Characters</a> data category expressed +<strong class="hl-tag" style="color: #000096"></messages></strong></pre></div><p>[Source file: <a href="examples/xml/EX-allowedCharacters-local-1.xml" shape="rect">examples/xml/EX-allowedCharacters-local-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-allowedCharacters-html5-local-1" id="EX-allowedCharacters-html5-local-1" shape="rect"/>Example 93: The <a href="#allowedchars" shape="rect">Allowed Characters</a> data category expressed locally in HTML</div><p>The local <code>its-allowed-characters</code> attribute specifies that the translated content of element <code>code</code> must not contain the characters other than 'a' to 'z' in any case and the characters underscore and minus.</p><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: blue"><!DOCTYPE html></strong>
 @@ -3160,7 +3141,7 @@ breaks the storage uses. The possible values are: <code>cr</code> for CARRIAGE RETURN (U+000D), <code>lf</code> for LINE FEED (U+000A), <code>crlf</code> for CARRIAGE RETURN (U+000D) followed by LINE FEED (U+000A), or <code>nel</code> for - NEXT LINE (U+0085). The default value is <code>lf</code>.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-storageSize-global-1" id="EX-storageSize-global-1" shape="rect"/>Example 95: The <a href="#storagesize" shape="rect">Storage Size</a> data category expressed + NEXT LINE (U+0085). The default value is <code>lf</code>.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-storageSize-global-1" id="EX-storageSize-global-1" shape="rect"/>Example 94: The <a href="#storagesize" shape="rect">Storage Size</a> data category expressed globally in XML</div><p>The <code>storageSizeRule</code> element is used to specify that, when encoded in ISO-8859-1, the content of the <code>country</code> element must not be more than 25 bytes. The name "Papouasie-Nouvelle-Guinée" is 25 character long and fits because @@ -3174,7 +3155,7 @@ <strong class="hl-tag" style="color: #000096"><country</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"123"</span><strong class="hl-tag" style="color: #000096">></strong>Papouasie-Nouvelle-Guinée<strong class="hl-tag" style="color: #000096"></country></strong>
 <strong class="hl-tag" style="color: #000096"><country</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"139"</span><strong class="hl-tag" style="color: #000096">></strong>République Dominicaine<strong class="hl-tag" style="color: #000096"></country></strong>
 <strong class="hl-tag" style="color: #000096"></data></strong>
 -<strong class="hl-tag" style="color: #000096"></db></strong></pre></div><p>[Source file: <a href="examples/xml/EX-storageSize-global-1.xml" shape="rect">examples/xml/EX-storageSize-global-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-storageSize-global-2" id="EX-storageSize-global-2" shape="rect"/>Example 96: Mapping the <a href="#storagesize" shape="rect">Storage Size</a> data category in +<strong class="hl-tag" style="color: #000096"></db></strong></pre></div><p>[Source file: <a href="examples/xml/EX-storageSize-global-1.xml" shape="rect">examples/xml/EX-storageSize-global-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-storageSize-global-2" id="EX-storageSize-global-2" shape="rect"/>Example 95: Mapping the <a href="#storagesize" shape="rect">Storage Size</a> data category in XML</div><p>The <code>storageSizePointer</code> attribute is used to map the non-ITS attribute <code>max</code> to the same functionality as <code>storageSize</code>. There is no character set encoding specified, so the default UTF-8 is assumed. Note that, while @@ -3199,14 +3180,14 @@ breaks the storage uses. The possible values are: <code>cr</code> for CARRIAGE RETURN (U+000D), <code>lf</code> for LINE FEED (U+000A), <code>crlf</code> for CARRIAGE RETURN (U+000D) followed by LINE FEED (U+000A), or <code>nel</code> for - NEXT LINE (U+0085). The default value is <code>lf</code>.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-storageSize-local-1" id="EX-storageSize-local-1" shape="rect"/>Example 97: The <a href="#storagesize" shape="rect">Storage Size</a> data category expressed + NEXT LINE (U+0085). The default value is <code>lf</code>.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-storageSize-local-1" id="EX-storageSize-local-1" shape="rect"/>Example 96: The <a href="#storagesize" shape="rect">Storage Size</a> data category expressed locally in XML</div><p>The <code>storageSize</code> attribute allows to specify different the maximum storage sizes throughout the document.</p><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon"><?xml version="1.0"?></span>
 <strong class="hl-tag" style="color: #000096"><messages</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"><var</strong> <span class="hl-attribute" style="color: #F5844C">num</span>=<span class="hl-value" style="color: #993300">"panelA1_Continue"</span> <span class="hl-attribute" style="color: #F5844C">its:storageSize</span>=<span class="hl-value" style="color: #993300">"8"</span> <span class="hl-attribute" style="color: #F5844C">its:storageEncoding</span>=<span class="hl-value" style="color: #993300">"UTF-16"</span><strong class="hl-tag" style="color: #000096">></strong>CONTINUE<strong class="hl-tag" style="color: #000096"></var></strong>
 <strong class="hl-tag" style="color: #000096"><var</strong> <span class="hl-attribute" style="color: #F5844C">num</span>=<span class="hl-value" style="color: #993300">"panelA1_Stop"</span> <span class="hl-attribute" style="color: #F5844C">its:storageSize</span>=<span class="hl-value" style="color: #993300">"8"</span> <span class="hl-attribute" style="color: #F5844C">its:storageEncoding</span>=<span class="hl-value" style="color: #993300">"UTF-16"</span><strong class="hl-tag" style="color: #000096">></strong>STOP<strong class="hl-tag" style="color: #000096"></var></strong>
 <strong class="hl-tag" style="color: #000096"><var</strong> <span class="hl-attribute" style="color: #F5844C">num</span>=<span class="hl-value" style="color: #993300">"panelB5_Cancel"</span> <span class="hl-attribute" style="color: #F5844C">its:storageSize</span>=<span class="hl-value" style="color: #993300">"12"</span> <span class="hl-attribute" style="color: #F5844C">its:storageEncoding</span>=<span class="hl-value" style="color: #993300">"UTF-16"</span><strong class="hl-tag" style="color: #000096">></strong>CANCEL<strong class="hl-tag" style="color: #000096"></var></strong>
 -<strong class="hl-tag" style="color: #000096"></messages></strong></pre></div><p>[Source file: <a href="examples/xml/EX-storageSize-local-1.xml" shape="rect">examples/xml/EX-storageSize-local-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-storageSize-html5-local-1" id="EX-storageSize-html5-local-1" shape="rect"/>Example 98: The <a href="#storagesize" shape="rect">Storage Size</a> data category expressed +<strong class="hl-tag" style="color: #000096"></messages></strong></pre></div><p>[Source file: <a href="examples/xml/EX-storageSize-local-1.xml" shape="rect">examples/xml/EX-storageSize-local-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-storageSize-html5-local-1" id="EX-storageSize-html5-local-1" shape="rect"/>Example 97: The <a href="#storagesize" shape="rect">Storage Size</a> data category expressed locally in HTML</div><p>The <code>its-storage-size</code> is used here to specify the maximum number of bytes the two editable strings can have in UTF-8.</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>
 @@ -3588,7 +3569,7 @@ <em>This section is informative.</em> </p><p>Several constraints of ITS markup cannot be validated with ITS schemas. The following <a title="Rule-based validation --
 Schematron" href="#schematron" shape="rect">[Schematron]</a> document allows for validating some of these - constraints.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d0e9862" id="d0e9862" shape="rect"/>Example 99: Testing constraints in ITS markup</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><schema</strong> <span class="hl-attribute" style="color: #F5844C">xmlns</span>=<span class="hl-value" style="color: #993300">"http://www.ascc.net/xml/schematron"</span><strong class="hl-tag" style="color: #000096">></strong>
 + constraints.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d0e9854" id="d0e9854" shape="rect"/>Example 98: Testing constraints in ITS markup</div><div class="exampleInner"><pre xml:space="preserve"><strong class="hl-tag" style="color: #000096"><schema</strong> <span class="hl-attribute" style="color: #F5844C">xmlns</span>=<span class="hl-value" style="color: #993300">"http://www.ascc.net/xml/schematron"</span><strong class="hl-tag" style="color: #000096">></strong>
 <em class="hl-comment" style="color: silver"><!-- Schematron document to test constraints for global and local ITS markup.
 For ITS markup definitions, see http://www.w3.org/TR/its/ . --></em>
 <strong class="hl-tag" style="color: #000096"><ns</strong> <span class="hl-attribute" style="color: #F5844C">prefix</span>=<span class="hl-value" style="color: #993300">"its"</span> <span class="hl-attribute" style="color: #F5844C">uri</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">/></strong>
 @@ -3635,7 +3616,7 @@ </p><p>The following <a title="Namespace-based Validation Dispatching Language
 (NVDL)" href="#nvdl" shape="rect">[NVDL]</a> document allows validation of ITS markup which has been added to a host vocabulary. Only ITS elements and attributes are checked. Elements and attributes of host language are ignored during validation against - this NVDL document/schema.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d0e9884" id="d0e9884" shape="rect"/>Example 100: NVDL schema for ITS</div><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon"><?xml version="1.0" encoding="UTF-8"?></span>
 + this NVDL document/schema.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d0e9876" id="d0e9876" shape="rect"/>Example 99: NVDL schema for ITS</div><div class="exampleInner"><pre xml:space="preserve"><span class="hl-directive" style="color: maroon"><?xml version="1.0" encoding="UTF-8"?></span>
 <strong class="hl-tag" style="color: #000096"><rules</strong> <span class="hl-attribute" style="color: #F5844C">xmlns</span>=<span class="hl-value" style="color: #993300">"http://purl.oclc.org/dsdl/nvdl/ns/structure/1.0"</span><strong class="hl-tag" style="color: #000096">></strong>
 <strong class="hl-tag" style="color: #000096"><namespace</strong> <span class="hl-attribute" style="color: #F5844C">ns</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">></strong>
 <strong class="hl-tag" style="color: #000096"><validate</strong> <span class="hl-attribute" style="color: #F5844C">schema</span>=<span class="hl-value" style="color: #993300">"its20-elements.rng"</span><strong class="hl-tag" style="color: #000096">/></strong> 
 @@ -3709,7 +3690,7 @@ the same parent.</p></div><div class="div1"> <h2><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="revisionlog" id="revisionlog" shape="rect"/>I Revision Log (Non-Normative)</h2><p id="changelog-since-20121023">The following log records major changes that have been made to this document since the <a href="http://www.w3.org/TR/2012/WD-its20-20121023/" shape="rect">ITS 2.0 Working Draft 23 October 2012</a>.</p><ol class="depth1"><li><p>Clarified usage of <a href="#domain" shape="rect">Domain</a> data category in HTML5 in - response to <a href="https://www.w3.org/International/multilingualweb/lt/track/issues/56" shape="rect">issue-56</a>.</p></li><li><p>Added the <a href="#lqissueDefs" shape="rect">enabled information</a> in <a class="section-ref" href="#lqissue" shape="rect">Section 6.18: Localization Quality Issue</a>.</p></li><li><p>Updated the <a href="#Disambiguation" shape="rect">Disambiguation</a> data category.</p></li><li><p>Fine tuned the algorithm to compute the result values of the <a href="#domain" shape="rect">Domain</a> data category.</p></li><li><p>Fix on <a href="#EX-locQualityIssue-html5-local-2" shape="rect">Example 80</a>: + response to <a href="https://www.w3.org/International/multilingualweb/lt/track/issues/56" shape="rect">issue-56</a>.</p></li><li><p>Added the <a href="#lqissueDefs" shape="rect">enabled information</a> in <a class="section-ref" href="#lqissue" shape="rect">Section 6.18: Localization Quality Issue</a>.</p></li><li><p>Updated the <a href="#Disambiguation" shape="rect">Disambiguation</a> data category.</p></li><li><p>Fine tuned the algorithm to compute the result values of the <a href="#domain" shape="rect">Domain</a> data category.</p></li><li><p>Fix on <a href="#EX-locQualityIssue-html5-local-2" shape="rect">Example 79</a>: <code>id</code> attribute of <code>script</code> element now the same as of containing XML.</p></li><li><p>NIF example fix - see <a href="https://www.w3.org/International/multilingualweb/lt/track/actions/284" shape="rect">action-284</a>.</p></li><li><p>Added <a href="#css-selectors-feature-at-risk" shape="rect">a note</a> to mark CSS selectors as feature at risk, see <a href="https://www.w3.org/International/multilingualweb/lt/track/actions/272" shape="rect">action-272</a>.</p></li><li><p>Defined in <a class="section-ref" href="#xpath-relative-selector" shape="rect">Section 5.3.2.2: Relative selector</a> that an XPath --- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2012/11/20 17:36:55 1.242 +++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd 2012/11/20 19:19:06 1.243 @@ -4017,13 +4017,18 @@ target="examples/xml/EX-locQualityIssue-global-1.xml"/> </exemplum> <exemplum xml:id="EX-locQualityIssue-global-2"> - <head>Using <gi>locQualityIssueRule</gi> to map equivalent markup</head> - <p>The <gi>locQualityIssueRule</gi> element defines the <att>ref</att> attribute of the <gi>mrk</gi> element - as the equivalent of the native ITS attribute <att>locQualityIssuesRef</att> which allows to point to a standoff element.</p> + <head>Annotating an issue in XML with local standoff markup and a global rule</head> + <p>The following example shows a document using local standoff markup to encode + several issues. But because, in this case, the <code>mrk</code> element does not + allow attributes from another namespace we cannot use <att>locQualityIssuesRef</att> + directly. Instead, a global rule is used to map the function of + <att>locQualityIssuesRef</att> to a non-ITS construct, here the <code>ref</code> + attribute of any <code>mrk</code> elements that has its attribute <code>type</code> + set to "x-itslq".</p> <egXML xmlns="http://www.tei-c.org/ns/Examples" target="examples/xml/EX-locQualityIssue-global-2.xml"/> </exemplum> - + <p xml:id="lqissue-local">LOCAL: Using the inline markup to represent the data category locally is limited to a single occurrence for a given content (e.g. one cannot have different <att>locQualityIssueType</att> attributes applied to the same span of text @@ -4056,12 +4061,11 @@ <item><p>A <att>locQualityIssuesRef</att> attribute. Its value is an IRI pointing to the <gi>locQualityIssues</gi> element containing the list of issues related to this content.</p></item> - <item><p>An element <gi>locQualityIssues</gi> (or <code><span - loc-quality-issues></code> in HTML) which contains:</p> - <note type="ed">Add an example using standoff on an attribute.</note> + <item><p>An element <gi>locQualityIssues</gi> with a <att>xml:id</att> attribute set to + the identifier specified in the <att>locQualityIssuesRef</att> attribute. + The <gi>locQualityIssues</gi> element contains:</p> <list type="unordered"> - <item><p>One or more elements <gi>locQualityIssue</gi> (or <code><span - its-loc-quality-issue></code> in HTML), each of which contains:</p> + <item><p>One or more elements <gi>locQualityIssue</gi>, each of which contains:</p> <list type="unordered"> <item><p>At least one of the following attributes:</p> <list type="unordered"> @@ -4086,16 +4090,17 @@ </list> </item> </list> + <note><p>When the attributes <att>locQualityIssueType</att>, + <att>locQualityIssueComment</att>, <att>locQualityIssueSeverity</att>, + <att>locQualityIssueProfileRef</att> and <att>locQualityIssueEnabled</att> are used + in in a standoff manner, the information they carry pertains to the content of the + element that refers to the standoff annotation, not to the content of the element + <gi>locQualityIssue</gi> where they are declared.</p></note> + <note><p>In HTML5 the standoff markup <ref target="#rfc-keywords">MUST</ref> be stored inside a <gi>script</gi> element with + its <att>id</att> attribute that <ref target="#rfc-keywords">MUST</ref> be set to the same value as the <att>xml:id</att> + attribute of the <gi>locQualityIssues</gi> element it contains.</p></note> </item> </list> - <p>Important: When the attributes <att>locQualityIssueType</att>, - <att>locQualityIssueComment</att>, <att>locQualityIssueSeverity</att> and - <att>locQualityIssueProfileRef</att> (or their equivalent representations) are used - in in a standoff manner, the information they carry pertains to the content of the - element that refers to the standoff annotation, not to the content of the element - <gi>locQualityIssue</gi> (or <code><span loc-quality-issue></code>in HTML) where - they are declared.</p> - <exemplum xml:id="EX-locQualityIssue-local-1"> <head>Annotating an issue in XML with local inline markup</head> <p>The attributes <att>locQualityIssueType</att>, <att>locQualityIssueComment</att> @@ -4119,18 +4124,6 @@ <egXML xmlns="http://www.tei-c.org/ns/Examples" target="examples/xml/EX-locQualityIssue-local-2.xml"/> </exemplum> - <exemplum xml:id="EX-locQualityIssue-local-3"> - <head>Annotating an issue in XML with local standoff markup and a global rule</head> - <p>The following example shows a document using local standoff markup to encode - several issues. But because, in this case, the <code>mrk</code> element does not - allow attributes from another namespace we cannot use <att>locQualityIssuesRef</att> - directly. Instead, a global rule is used to map the function of - <att>locQualityIssuesRef</att> to a non-ITS construct, here the <code>ref</code> - attribute of any <code>mrk</code> elements that has its attribute <code>type</code> - set to "x-itslq".</p> - <egXML xmlns="http://www.tei-c.org/ns/Examples" - target="examples/xml/EX-locQualityIssue-local-3.xml"/> - </exemplum> <exemplum xml:id="EX-locQualityIssue-html5-local-2"> <head>Annotating an issue in HTML with local standoff markup</head> <p>The following example shows a document using local standoff markup to encode @@ -4141,8 +4134,6 @@ <egXML xmlns="http://www.tei-c.org/ns/Examples" target="examples/html5/EX-locQualityIssue-html5-local-2.html" type="html5"/> </exemplum> - <note type="ed">TODO for in general: make sure standoff examples in HTML5 use the - 'script' notation.</note> </div> </div>
Received on Tuesday, 20 November 2012 19:19:16 UTC