- From: Yves Savourel via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 21 Aug 2012 19:57:56 +0000
- To: public-multilingualweb-lt-commits@w3.org
Update of /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20
In directory hutz:/tmp/cvs-serv10540
Modified Files:
its20.html its20.odd
Log Message:
Added loc quality issue data category
Index: its20.odd
===================================================================
RCS file: /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd,v
retrieving revision 1.118
retrieving revision 1.119
diff -u -d -r1.118 -r1.119
--- its20.odd 20 Aug 2012 11:12:26 -0000 1.118
+++ its20.odd 21 Aug 2012 19:57:53 -0000 1.119
@@ -4195,7 +4195,6 @@
</div>
</div>
-
<div xml:id="preservespace">
<head>Preserve Space</head>
<div xml:id="preservespace-definition">
@@ -4273,6 +4272,294 @@
</div>
</div>
+ <div xml:id="lqnote">
+ <head>Localization Quality Issue</head>
+ <note type="ed">This data category is not completely stable yet.</note>
+ <div xml:id="lqnote-definition">
+ <head>Definition</head>
+ <p>The <ref target="#idvalue">Localization Quality Issue</ref> data category is used to express information
+ related to localization quality assessment tasks.</p>
+ <p>This data category can be used in a number of ways, including the following example scenarios:</p>
+ <list type="unordered">
+ <item><p>An automatic quality checking tool flags a number of potential quality issues in an XML or HTML
+ file and marks them up using ITS 2.0 markup. Other tools in the workflow then examine this markup and
+ decide whether the file needs to be reviewed manually or passed on for further processing without a
+ manual review stage.</p></item>
+ <item><p>A quality assessment process identifies a number of issues and adds the ITS markup to a rendered
+ HTML preview of an XML file along with CSS styling that highlights these issues. The resulting HTML
+ file is then sent back to the translator to assist his or her revision efforts.</p></item>
+ <item><p>A human reviewer working with a web-based tool adds quality markup, including comments and
+ suggestions, to a localized text as part of the review process. A subsequent process examines this
+ markup to ensure that changes were made.</p></item>
+ </list>
+ <p>The data category defines four pieces of information:</p>
+ <note type="ed">TODO: Table</note>
+ <table border="1" xml:id="lqnoteDefs">
+ <row role="head">
+ <cell>Information</cell>
+ <cell>Description</cell>
+ <cell>Value</cell>
+ <cell>Notes</cell>
+ </row>
+ <row>
+ <cell>Type</cell>
+ <cell>A set of broad types of issues into which tool-specific issues can be categorized.</cell>
+ <cell>One of the values defined in list of type values.</cell>
+ <cell>ITS 2.0-compliant tools that use these categories <ref target="#rfc-keywords">MUST</ref>
+ map their internal values to these types.</cell>
+ </row>
+ <row>
+ <cell>Comment</cell>
+ <cell>A human-readable description of the quality issue.</cell>
+ <cell>Text</cell>
+ <cell></cell>
+ </row>
+ <row>
+ <cell>Severity</cell>
+ <cell>An decimal value representing the severity of the issue, as defined by the model generating the metadata.</cell>
+ <cell>A decimal between 0.0 to 100.0 (included), with higher values indicating greater severity.</cell>
+ <cell>It is up to tools to map the values of this to their own system to this scale. If needed, the
+ original value can be passed along using a custom namespace for XML, or a <code>data-</code> attribute for HTML.</cell>
+ </row>
+ <row>
+ <cell>Profile Reference</cell>
+ <cell>A reference to a document describing the quality assessment model used for the issue.</cell>
+ <cell>A URI pointing to the reference document.</cell>
+ <cell>The use of resolvable URI is strongly recommended as it provides a way for human evaluators
+ to learn more about the quality issues in use.</cell>
+ </row>
+ </table>
+ </div>
+ <div xml:id="lqnote-implementation">
+ <head>Implementation</head>
+ <p>The <ref target="#lqnote">Localization Quality Issue</ref> data category can be expressed with global rules,
+ or locally on individual elements. The information applies to the textual content of the element,
+ <emph>including</emph> child elements, but excluding attributes.</p>
+ <p xml:id="lqnote-global">GLOBAL: The <gi>locQualityIssueRule</gi> element contains the following:</p>
+ <list type="unordered">
+ <item><p>A required <att>selector</att> attribute. It contains an <ref target="#selectors"
+ >absolute selector</ref> which selects the nodes to which this rule applies.</p></item>
+ <item><p>At least one of the following:</p>
+ <list type="unordered">
+ <item><p>Exactly one of the following:</p>
+ <list type="unordered">
+ <item><p>A <att>locQualityIssuesRef</att> attribute. Its value is a URI pointing to the
+ <gi>locQualityIssues</gi> element containing the list of issues related to this content.</p></item>
+ <item><p>A <att>locQualityIssuesRefPointer</att> attribute that contains a relative selector
+ pointing to a node with the exact same semantics as <att>locQualityIssuesRef</att>.</p></item>
+ </list>
+ </item>
+ <item><p>Exactly one of the following:</p>
+ <list type="unordered">
+ <item><p>A <att>locQualityIssueType</att> attribute that implements the <ref target="#lqnoteDefs">type information</ref>.</p></item>
+ <item><p>A <att>locQualityIssueTypePointer</att> attribute that contains a relative selector
+ pointing to a node with the exact same semantics as <att>locQualityIssueType</att>.</p></item>
+ </list>
+ </item>
+ <item><p>Exactly one of the following:</p>
+ <list type="unordered">
+ <item><p>A <att>locQualityIssueComment</att> attribute that implements the <ref target="#lqnoteDefs">comment information</ref>.</p></item>
+ <item><p>A <att>locQualityIssueCommentPointer</att> attribute that contains a relative selector
+ pointing to a node with the exact same semantics as <att>locQualityIssueComment</att>.</p></item>
+ </list>
+ </item>
+ </list>
+ </item>
+ <item><p>None or exactly one of the following:</p>
+ <list type="unordered">
+ <item><p>A <att>locQualityIssueSeverity</att> attribute that implements the <ref target="#lqnoteDefs">severity information</ref>.</p></item>
+ <item><p>A <att>locQualityIssueSeverityPointer</att> attribute that contains a relative selector
+ pointing to a node with the exact same semantics as <att>locQualityIssueSeverity</att>.</p></item>
+ </list>
+ </item>
+ <item><p>None or exactly one of the following:</p>
+ <list type="unordered">
+ <item><p>A <att>locQualityIssueProfileRef</att> attribute that implements the <ref target="#lqnoteDefs">profile reference information</ref>.</p></item>
+ <item><p>A <att>locQualityIssueProfileRefPointer</att> attribute that contains a relative selector
+ pointing to a node with the exact same semantics as <att>locQualityIssueProfileRef</att>.</p></item>
+ </list>
+ </item>
+ </list>
+ <exemplum xml:id="EX-locQualityNote-global-1">
+ <head>TODO</head>
+ <p>TODO</p>
+ </exemplum>
+
+ <p xml:id="lqnote-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 because the inner-most one would override the others). Because there may be several
+ instances of a localization quality issue for a given ontent, a local <emph>standoff markup</emph> allowing
+ such cases is also provided.</p>
+ <p>The following local markup is available for the Localization Quality Issue data category:</p>
+ <list type="unordered">
+ <item><p>Either (inline markup):</p>
+ <list type="unordered">
+ <item><p>At least one of the following attributes:</p>
+ <list type="unordered">
+ <item><p>A <att>locQualityIssueType</att> attribute that implements the
+ <ref target="#lqnoteDefs">type information</ref>.</p></item>
+ <item><p>A <att>locQualityIssueComment</att> attribute that implements the
+ <ref target="#lqnoteDefs">comment information</ref>.</p></item>
+ </list>
+ </item>
+ <item><p>An optional <att>locQualityIssueSeverity</att> attribute that implements the
+ <ref target="#lqnoteDefs">severity information</ref>.</p></item>
+ <item><p>An optional <att>locQualityIssueProfileRef</att> attribute that implements the
+ <ref target="#lqnoteDefs">profile reference information</ref>.</p></item>
+ </list>
+ </item>
+ <item><p>Or (standoff markup):</p>
+ <list type="unordered">
+ <item><p>A <att>locQualityIssuesRef</att> attribute. Its value is a URI 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>
+ <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>
+ <list type="unordered">
+ <item><p>At least one of the following attributes:</p>
+ <list type="unordered">
+ <item><p>A <att>locQualityIssueType</att> attribute that implements the
+ <ref target="#lqnoteDefs">type information</ref>.</p></item>
+ <item><p>A <att>locQualityIssueComment</att> attribute that implements the
+ <ref target="#lqnoteDefs">comment information</ref>.</p></item>
+ </list>
+ </item>
+ <item><p>An optional <att>locQualityIssueSeverity</att> attribute that implements the
+ <ref target="#lqnoteDefs">severity information</ref>.</p></item>
+ <item><p>An optional <att>locQualityIssueProfileRef</att> attribute that implements the
+ <ref target="#lqnoteDefs">profile reference information</ref>.</p></item>
+ </list>
+ </item>
+ </list>
+ </item>
+ </list>
+ </item>
+ </list>
+ </div>
+ <div xml:id="lqnote-markup">
+ <head>Markup Declarations for <ref target="#lqnote">Localization Quality Issue</ref></head>
+ <specGrp xml:id="spec-its-locqualitynote">
+ <elementSpec ident="locQualityIssueRule" ns="http://www.w3.org/2005/11/its">
+ <desc>Rule about the <ref target="#lqnote">Localization Quality Issue</ref> data category.</desc>
+ <classes>
+ <memberOf key="att.selector" />
+ </classes>
+ <content>
+ <rng:empty />
+ </content>
+ <attList>
+ <attDef ident="locQualityIssuesRef" usage="opt">
+ <desc>TODO</desc>
+ <datatype>
+ <rng:data type="anyURI" />
+ </datatype>
+ </attDef>
+ <attDef ident="locQualityIssuesRefPointer" usage="opt">
+ <desc>TODO</desc>
+ <datatype>
+ <rng:data type="string" />
+ </datatype>
+ </attDef>
+ <attDef ident="locQualityIssueType" usage="opt">
+ <desc>TODO</desc>
+ <datatype>
+ <rng:data type="string" />
+ </datatype>
+ </attDef>
+ <attDef ident="locQualityIssueTypePointer" usage="opt">
+ <desc>TODO</desc>
+ <datatype>
+ <rng:data type="string" />
+ </datatype>
+ </attDef>
+ <attDef ident="locQualityIssueComment" usage="opt">
+ <desc>TODO</desc>
+ <datatype>
+ <rng:data type="string" />
+ </datatype>
+ </attDef>
+ <attDef ident="locQualityIssueCommentPointer" usage="opt">
+ <desc>TODO</desc>
+ <datatype>
+ <rng:data type="string" />
+ </datatype>
+ </attDef>
+ <attDef ident="locQualityIssueSeverity" usage="opt">
+ <desc>TODO</desc>
+ <datatype>
+ <rng:data type="string" />
+ </datatype>
+ </attDef>
+ <attDef ident="locQualityIssueSeverityPointer" usage="opt">
+ <desc>TODO</desc>
+ <datatype>
+ <rng:data type="string" />
+ </datatype>
+ </attDef>
+ <attDef ident="locQualityIssueProfileRef" usage="opt">
+ <desc>TODO</desc>
+ <datatype>
+ <rng:data type="anyURI" />
+ </datatype>
+ </attDef>
+ <attDef ident="locQualityIssueProfileRefPointer" usage="opt">
+ <desc>TODO</desc>
+ <datatype>
+ <rng:data type="string" />
+ </datatype>
+ </attDef>
+ </attList>
+ </elementSpec>
+ <elementSpec ident="locQualityIssues" ns="http://www.w3.org/2005/11/its">
+ <desc>List of <gi>locQualityIssue</gi> elements.</desc>
+ <content>
+ <rng:oneOrMore>
+ <rng:ref name="locQualityIssue"/>
+ </rng:oneOrMore>
+ </content>
+ </elementSpec>
+ <elementSpec ident="locQualityIssue" ns="http://www.w3.org/2005/11/its">
+ <desc>A holder for loaclization quality information.</desc>
+ <content>
+ <rng:empty/>
+ </content>
+ <attList>
+ <attDef ident="locQualityIssueType" usage="opt">
+ <desc>TODO</desc>
+ <datatype>
+ <rng:data type="string" />
+ </datatype>
+ </attDef>
+ <attDef ident="locQualityIssueComment" usage="opt">
+ <desc>TODO</desc>
+ <datatype>
+ <rng:data type="string" />
+ </datatype>
+ </attDef>
+ <attDef ident="locQualityIssueSeverity" usage="opt">
+ <desc>TODO</desc>
+ <datatype>
+ <rng:data type="string" />
+ </datatype>
+ </attDef>
+ <attDef ident="locQualityIssueProfileRef" usage="opt">
+ <desc>TODO</desc>
+ <datatype>
+ <rng:data type="anyURI" />
+ </datatype>
+ </attDef>
+ </attList>
+ </elementSpec>
+ </specGrp>
+ </div>
+ </div>
+
+<!-- <div xml:id="lqprecis">
+ <head>Localization Quality Precis</head>
+ </div>
+-->
+
</div>
<!-- <div xml:id="catalogues">
<head>Catalogues</head>
@@ -4768,6 +5055,8 @@
/>.</item>
<item>Added <ptr target="#target-pointer" type="specref" />.</item>
<item>Original Ruby markup model changed to HTML5 Ruby model.</item>
+ <item>Added <ptr target="#preservespace" type="specref" />.</item>
+ <item>Added <ptr target="#lqnote" type="specref" />.</item>
</list>
<p xml:id="changelog-since-20120626">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-20120626/">ITS 2.0 Working Draft
Index: its20.html
===================================================================
RCS file: /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html,v
retrieving revision 1.118
retrieving revision 1.119
diff -u -d -r1.118 -r1.119
--- its20.html 20 Aug 2012 11:12:26 -0000 1.118
+++ its20.html 21 Aug 2012 19:57:53 -0000 1.119
@@ -117,6 +117,11 @@
<div class="toc3">6.17.2 <a href="#preservespace-implementation" shape="rect">Implementation</a></div>
<div class="toc3">6.17.3 <a href="#preservespace-markup" shape="rect">Markup Declarations for Preserve Space</a></div>
</div>
+<div class="toc2">6.18 <a href="#lqnote" shape="rect">Localization Quality Issue</a><div class="toc3">6.18.1 <a href="#lqnote-definition" shape="rect">Definition</a></div>
+<div class="toc3">6.18.2 <a href="#lqnote-implementation" shape="rect">Implementation</a></div>
+<div class="toc3">6.18.3 <a href="#lqnote-markup" shape="rect">Markup Declarations for Localization Quality Issue
+ </a></div>
+</div>
</div>
</div>
<h3><a name="appendices" id="appendices" shape="rect"/>Appendices</h3><div class="toc1">A <a href="#normative-references" shape="rect">References</a></div>
@@ -2295,7 +2300,72 @@
}</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="preserveSpaceRule.content" id="preserveSpaceRule.content" shape="rect"/>[137] </td><td rowspan="1" colspan="1"><code>preserveSpaceRule.content</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code> empty</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="preserveSpaceRule.attributes" id="preserveSpaceRule.attributes" shape="rect"/>[138] </td><td rowspan="1" colspan="1"><code>preserveSpaceRule.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
<a href="#att.selector.attributes" shape="rect">att.selector.attributes</a>,
- attribute space { "default" | "preserve" }</code></td></tr></tbody></table></dd></dl></div></div></div></div><div class="back"><div class="div1">
+ attribute space { "default" | "preserve" }</code></td></tr></tbody></table></dd></dl></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="lqnote" id="lqnote" shape="rect"/>6.18 Localization Quality Issue</h3><span class="editor-note">[Ed. note: This data category is not completely stable yet.]</span><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="lqnote-definition" id="lqnote-definition" shape="rect"/>6.18.1 Definition</h4><p>The <a href="#idvalue" shape="rect">Localization Quality Issue</a> data category is used to express information
+ related to localization quality assessment tasks.</p><p>This data category can be used in a number of ways, including the following example scenarios:</p><ul><li><p>An automatic quality checking tool flags a number of potential quality issues in an XML or HTML
+ file and marks them up using ITS 2.0 markup. Other tools in the workflow then examine this markup and
+ decide whether the file needs to be reviewed manually or passed on for further processing without a
+ manual review stage.</p></li><li><p>A quality assessment process identifies a number of issues and adds the ITS markup to a rendered
+ HTML preview of an XML file along with CSS styling that highlights these issues. The resulting HTML
+ file is then sent back to the translator to assist his or her revision efforts.</p></li><li><p>A human reviewer working with a web-based tool adds quality markup, including comments and
+ suggestions, to a localized text as part of the review process. A subsequent process examines this
+ markup to ensure that changes were made.</p></li></ul><p>The data category defines four pieces of information:</p><span class="editor-note">[Ed. note: TODO: Table]</span><a name="lqnoteDefs" id="lqnoteDefs" shape="rect"/><table border="1"><thead><tr><td rowspan="1" colspan="1">Information</td><td rowspan="1" colspan="1">Description</td><td rowspan="1" colspan="1">Value</td><td rowspan="1" colspan="1">Notes</td></tr></thead><tbody><tr><td rowspan="1" colspan="1">Type</td><td rowspan="1" colspan="1">A set of broad types of issues into which tool-specific issues can be categorized.</td><td rowspan="1" colspan="1">One of the values defined in list of type values.</td><td rowspan="1" colspan="1">ITS 2.0-compliant tools that use these categories <a href="#rfc-keywords" shape="rect">MUST</a>
+ map their internal values to these types.</td></tr><tr><td rowspan="1" colspan="1">Comment</td><td rowspan="1" colspan="1">A human-readable description of the quality issue.</td><td rowspan="1" colspan="1">Text</td><td rowspan="1" colspan="1"/></tr><tr><td rowspan="1" colspan="1">Severity</td><td rowspan="1" colspan="1">An decimal value representing the severity of the issue, as defined by the model generating the metadata.</td><td rowspan="1" colspan="1">A decimal between 0.0 to 100.0 (included), with higher values indicating greater severity.</td><td rowspan="1" colspan="1">It is up to tools to map the values of this to their own system to this scale. If needed, the
+ original value can be passed along using a custom namespace for XML, or a <code>data-</code> attribute for HTML.</td></tr><tr><td rowspan="1" colspan="1">Profile Reference</td><td rowspan="1" colspan="1">A reference to a document describing the quality assessment model used for the issue.</td><td rowspan="1" colspan="1">A URI pointing to the reference document.</td><td rowspan="1" colspan="1">The use of resolvable URI is strongly recommended as it provides a way for human evaluators
+ to learn more about the quality issues in use.</td></tr></tbody></table></div><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="lqnote-implementation" id="lqnote-implementation" shape="rect"/>6.18.2 Implementation</h4><p>The <a href="#lqnote" shape="rect">Localization Quality Issue</a> data category can be expressed with global rules,
+ or locally on individual elements. The information applies to the textual content of the element,
+ <em>including</em> child elements, but excluding attributes.</p><p id="lqnote-global">GLOBAL: The <a class="itsmarkup" href="#locQualityIssueRule" shape="rect">locQualityIssueRule</a> element contains the following:</p><ul><li><p>A required <a class="itsmarkup" href="#att.selector.attribute.selector" shape="rect">selector</a> 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>At least one of the following:</p><ul><li><p>Exactly one of the following:</p><ul><li><p>A <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssuesRef</a> attribute. Its value is a URI pointing to the
+ <a class="itsmarkup" href="#locQualityIssues" shape="rect">locQualityIssues</a> element containing the list of issues related to this content.</p></li><li><p>A <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssuesRefPointer</a> attribute that contains a relative selector
+ pointing to a node with the exact same semantics as <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssuesRef</a>.</p></li></ul></li><li><p>Exactly one of the following:</p><ul><li><p>A <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueType</a> attribute that implements the <a href="#lqnoteDefs" shape="rect">type information</a>.</p></li><li><p>A <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueTypePointer</a> attribute that contains a relative selector
+ pointing to a node with the exact same semantics as <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueType</a>.</p></li></ul></li><li><p>Exactly one of the following:</p><ul><li><p>A <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueComment</a> attribute that implements the <a href="#lqnoteDefs" shape="rect">comment information</a>.</p></li><li><p>A <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueCommentPointer</a> attribute that contains a relative selector
+ pointing to a node with the exact same semantics as <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueComment</a>.</p></li></ul></li></ul></li><li><p>None or exactly one of the following:</p><ul><li><p>A <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueSeverity</a> attribute that implements the <a href="#lqnoteDefs" shape="rect">severity information</a>.</p></li><li><p>A <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueSeverityPointer</a> attribute that contains a relative selector
+ pointing to a node with the exact same semantics as <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueSeverity</a>.</p></li></ul></li><li><p>None or exactly one of the following:</p><ul><li><p>A <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueProfileRef</a> attribute that implements the <a href="#lqnoteDefs" shape="rect">profile reference information</a>.</p></li><li><p>A <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueProfileRefPointer</a> attribute that contains a relative selector
+ pointing to a node with the exact same semantics as <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueProfileRef</a>.</p></li></ul></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityNote-global-1" id="EX-locQualityNote-global-1" shape="rect"/>Example 67: TODO</div><p>TODO</p></div><p id="lqnote-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 <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueType</a> attributes applied
+ to the same span of text because the inner-most one would override the others). Because there may be several
+ instances of a localization quality issue for a given ontent, a local <em>standoff markup</em> allowing
+ such cases is also provided.</p><p>The following local markup is available for the Localization Quality Issue data category:</p><ul><li><p>Either (inline markup):</p><ul><li><p>At least one of the following attributes:</p><ul><li><p>A <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueType</a> attribute that implements the
+ <a href="#lqnoteDefs" shape="rect">type information</a>.</p></li><li><p>A <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueComment</a> attribute that implements the
+ <a href="#lqnoteDefs" shape="rect">comment information</a>.</p></li></ul></li><li><p>An optional <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueSeverity</a> attribute that implements the
+ <a href="#lqnoteDefs" shape="rect">severity information</a>.</p></li><li><p>An optional <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueProfileRef</a> attribute that implements the
+ <a href="#lqnoteDefs" shape="rect">profile reference information</a>.</p></li></ul></li><li><p>Or (standoff markup):</p><ul><li><p>A <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssuesRef</a> attribute. Its value is a URI pointing to the <a class="itsmarkup" href="#locQualityIssues" shape="rect">locQualityIssues</a> element
+ containing the list of issues related to this content.</p></li><li><p>An element <a class="itsmarkup" href="#locQualityIssues" shape="rect">locQualityIssues</a> (or <code><span loc-quality-issues></code> in HTML) which contains:</p><ul><li><p>One or more elements <a class="itsmarkup" href="#locQualityIssue" shape="rect">locQualityIssue</a> (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 <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueType</a> attribute that implements the
+ <a href="#lqnoteDefs" shape="rect">type information</a>.</p></li><li><p>A <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueComment</a> attribute that implements the
+ <a href="#lqnoteDefs" shape="rect">comment information</a>.</p></li></ul></li><li><p>An optional <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueSeverity</a> attribute that implements the
+ <a href="#lqnoteDefs" shape="rect">severity information</a>.</p></li><li><p>An optional <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueProfileRef</a> attribute that implements the
+ <a href="#lqnoteDefs" shape="rect">profile reference information</a>.</p></li></ul></li></ul></li></ul></li></ul></div><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="lqnote-markup" id="lqnote-markup" shape="rect"/>6.18.3 Markup Declarations for <a href="#lqnote" shape="rect">Localization Quality Issue</a>
+ </h4><dl><dt class="label">locQualityIssueRule</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="locQualityIssueRule" id="locQualityIssueRule" shape="rect"/>[139] </td><td rowspan="1" colspan="1"><code>locQualityIssueRule</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ element its:locQualityIssueRule
+ {
+ locQualityIssueRule.content,
+ <a href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueRule.attributes</a>
+ }</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="locQualityIssueRule.content" id="locQualityIssueRule.content" shape="rect"/>[140] </td><td rowspan="1" colspan="1"><code>locQualityIssueRule.content</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code> empty</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="locQualityIssueRule.attributes" id="locQualityIssueRule.attributes" shape="rect"/>[141] </td><td rowspan="1" colspan="1"><code>locQualityIssueRule.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+
+ <a href="#att.selector.attributes" shape="rect">att.selector.attributes</a>,
+ attribute locQualityIssuesRef { xsd:anyURI }?,
+ attribute locQualityIssuesRefPointer { string }?,
+ attribute locQualityIssueType { string }?,
+ attribute locQualityIssueTypePointer { string }?,
+ attribute locQualityIssueComment { string }?,
+ attribute locQualityIssueCommentPointer { string }?,
+ attribute locQualityIssueSeverity { string }?,
+ attribute locQualityIssueSeverityPointer { string }?,
+ attribute locQualityIssueProfileRef { xsd:anyURI }?,
+ attribute locQualityIssueProfileRefPointer { string }?</code></td></tr></tbody></table></dd><dt class="label">locQualityIssues</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="locQualityIssues" id="locQualityIssues" shape="rect"/>[142] </td><td rowspan="1" colspan="1"><code>locQualityIssues</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code> element its:locQualityIssues { locQualityIssues.content }</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="locQualityIssues.content" id="locQualityIssues.content" shape="rect"/>[143] </td><td rowspan="1" colspan="1"><code>locQualityIssues.content</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ <a href="#locQualityIssue" shape="rect">locQualityIssue</a>+</code></td></tr></tbody></table></dd><dt class="label">locQualityIssue</dt><dd><table class="scrap" summary="Scrap"><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="locQualityIssue" id="locQualityIssue" shape="rect"/>[144] </td><td rowspan="1" colspan="1"><code>locQualityIssue</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ element its:locQualityIssue
+ {
+ locQualityIssue.content,
+ <a href="#locQualityIssue.attributes" shape="rect">locQualityIssue.attributes</a>
+ }</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="locQualityIssue.content" id="locQualityIssue.content" shape="rect"/>[145] </td><td rowspan="1" colspan="1"><code>locQualityIssue.content</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code> empty</code></td></tr></tbody><tbody><tr valign="baseline"><td rowspan="1" colspan="1"><a name="locQualityIssue.attributes" id="locQualityIssue.attributes" shape="rect"/>[146] </td><td rowspan="1" colspan="1"><code>locQualityIssue.attributes</code></td><td rowspan="1" colspan="1"> ::= </td><td rowspan="1" colspan="1"><code>
+ attribute locQualityIssueType { string }?,
+ attribute locQualityIssueComment { string }?,
+ attribute locQualityIssueSeverity { string }?,
+ attribute locQualityIssueProfileRef { xsd:anyURI }?</code></td></tr></tbody></table></dd></dl></div></div></div></div><div class="back"><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="normative-references" id="normative-references" shape="rect"/>A References</h2><dl><dt class="label"><a name="bcp47" id="bcp47" shape="rect"/>BCP47</dt><dd>Addison Phillips, Mark Davis. <a href="http://www.rfc-editor.org/rfc/bcp/bcp47.txt" shape="rect"><cite>Tags for Identifying
Languages</cite></a>, September 2009. Available at <a href="http://www.rfc-editor.org/rfc/bcp/bcp47.txt" shape="rect"> http://www.rfc-editor.org/rfc/bcp/bcp47.txt</a>.</dd><dt class="label"><a name="qa-framework" id="qa-framework" shape="rect"/>QAFRAMEWORK</dt><dd>Karl Dubost, Lynne Rosental, Dominique Hazaël-Massieux,
Lofton Henderson. <a href="http://www.w3.org/TR/2005/REC-qaframe-spec-20050817/" shape="rect"><cite>QA Framework:
@@ -2559,7 +2629,7 @@
<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="its-schematron-constraints" id="its-schematron-constraints" shape="rect"/>E Checking ITS Markup Constraints With Schematron (Non-Normative)</h2><p>
<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="d3e7813" id="d3e7813" shape="rect"/>Example 67: Testing constraints in ITS markup</div><div class="exampleInner"><pre xml:space="preserve">
+ constraints.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d3e8250" id="d3e8250" shape="rect"/>Example 68: Testing constraints in ITS markup</div><div class="exampleInner"><pre xml:space="preserve">
<sch:schema
xmlns:sch="http://www.ascc.net/xml/schematron" >
<!-- Schematron document to test constraints for global and local ITS markup.
@@ -2626,7 +2696,7 @@
<em>This section is informative.</em>
</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="d3e7835" id="d3e7835" shape="rect"/>Example 68: NVDL schema for ITS</div><div class="exampleInner"><pre xml:space="preserve"><rules xmlns="http://purl.oclc.org/dsdl/nvdl/ns/structure/1.0"> <namespace
+ attributes of host language are ignored during validation against this NVDL document/schema.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d3e8272" id="d3e8272" shape="rect"/>Example 69: NVDL schema for ITS</div><div class="exampleInner"><pre xml:space="preserve"><rules xmlns="http://purl.oclc.org/dsdl/nvdl/ns/structure/1.0"> <namespace
ns="http://www.w3.org/2005/11/its"> <validate schema="its-elements.rng"/>
</namespace> <namespace ns="http://www.w3.org/2005/11/its" match="attributes">
<validate schema="its-attributes.rng"/> </namespace> <anyNamespace>
@@ -2634,7 +2704,7 @@
<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"/>G Revision Log (Non-Normative)</h2><p id="changelog-since-20120731">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-20120731/" shape="rect">ITS 2.0 Working Draft
31 July 2012</a>.</p><ol class="depth1"><li><p>Added <a class="section-ref" href="#Disambiguation" shape="rect">Section 6.10: Disambiguation</a>.</p></li><li><p>Added <a class="section-ref" href="#preservespace" shape="rect">Section 6.17: Preserve Space</a>.</p></li><li><p>Added <a class="section-ref" href="#idvalue" shape="rect">Section 6.16: Id Value</a>.</p></li><li><p>Added support for different query language and reworked whole XPath and CSS Selectors
- integration.</p></li><li><p>Added a note about HTML5 and the attributes <a class="itsmarkup" href="#att.local.no-ns.attribute.dir" shape="rect">dir</a> and <a class="itsmarkup" href="#att.local.no-ns.attribute.translate" shape="rect">translate</a> to <a class="section-ref" href="#selection-local" shape="rect">Section 5.2.3: Local Selection in an XML Document</a>.</p></li><li><p>Added definition of <a class="itsmarkup" href="#param" shape="rect">param</a> element to <a class="section-ref" href="#selection-global" shape="rect">Section 5.2.1: Global, Rule-based Selection</a>.</p></li><li><p>Added <a class="section-ref" href="#target-pointer" shape="rect">Section 6.15: Target Pointer</a>.</p></li><li><p>Original Ruby markup model changed to HTML5 Ruby model.</p></li></ol><p id="changelog-since-20120626">The following log records major changes that have been made to this
+ integration.</p></li><li><p>Added a note about HTML5 and the attributes <a class="itsmarkup" href="#att.local.no-ns.attribute.dir" shape="rect">dir</a> and <a class="itsmarkup" href="#att.local.no-ns.attribute.translate" shape="rect">translate</a> to <a class="section-ref" href="#selection-local" shape="rect">Section 5.2.3: Local Selection in an XML Document</a>.</p></li><li><p>Added definition of <a class="itsmarkup" href="#param" shape="rect">param</a> element to <a class="section-ref" href="#selection-global" shape="rect">Section 5.2.1: Global, Rule-based Selection</a>.</p></li><li><p>Added <a class="section-ref" href="#target-pointer" shape="rect">Section 6.15: Target Pointer</a>.</p></li><li><p>Original Ruby markup model changed to HTML5 Ruby model.</p></li><li><p>Added <a class="section-ref" href="#preservespace" shape="rect">Section 6.17: Preserve Space</a>.</p></li><li><p>Added <a class="section-ref" href="#lqnote" shape="rect">Section 6.18: Localization Quality Issue</a>.</p></li></ol>< id="changelog-since-20120626">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-20120626/" shape="rect">ITS 2.0 Working Draft
26 June 2012</a>.</p><ol class="depth1"><li><p>Various editorial changes (non-normative references update, style & grammar fixes).</p></li><li><p>Made clarifications to <a class="section-ref" href="#out-of-scope" shape="rect">Section 1.5: Out of Scope</a>, <a class="section-ref" href="#design-decisions" shape="rect">Section 1.6: Important Design Principles</a>.</p></li><li><p>Added explanatory note on precedence and overriding in <a class="section-ref" href="#selection-precedence" shape="rect">Section 5.5: Precedence between Selections</a>.</p></li><li><p>Reordered some components in <a class="section-ref" href="#introduction" shape="rect">Section 1: Introduction</a>.</p></li><li><p>Restructured <a class="section-ref" href="#relation-to-its10-and-new-principles" shape="rect">Section 1.1: Relation to ITS 1.0 and New Principles</a>.</p></li><li><p>Added <a class="section-ref" href="#queryLanguage" shape="rect">Section 5.3.1: Choosing Query Language</a> as a stub.</p></li><li><p>Added <a class"section-ref" href="#LocaleFilter" shape="rect">Section 6.11: Locale Filter</a>.</p></li><li><p>Added <a class="section-ref" href="#domain" shape="rect">Section 6.9: Domain</a>.</p></li><li><p>Added <a class="section-ref" href="#usage-in-legacy-html" shape="rect">Section 1.4.1: Support for legacy HTML content</a>.</p></li><li><p>Added local markup in <a class="section-ref" href="#elements-within-text" shape="rect">Section 6.8: Elements Within Text</a>.</p></li><li><p>Added <a class="section-ref" href="#externalresource" shape="rect">Section 6.14: External Resource</a>.</p></li><li><p>Updated examples to use the <a class="itsmarkup" href="#att.version.attribute.version" shape="rect">version</a> attribute with the value
<code>2.0</code>.</p></li></ol><p id="changelog-since-20070403">The following log records major changes that have been made to this
Received on Tuesday, 21 August 2012 19:57:58 UTC