- From: Yves Savourel via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 21 Aug 2012 20:28:25 +0000
- To: public-multilingualweb-lt-commits@w3.org
Update of /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20
In directory hutz:/tmp/cvs-serv20788
Modified Files:
its20.html its20.odd
Log Message:
Continued implementing locQuality.
Index: its20.odd
===================================================================
RCS file: /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd,v
retrieving revision 1.119
retrieving revision 1.120
diff -u -d -r1.119 -r1.120
--- its20.odd 21 Aug 2012 19:57:53 -0000 1.119
+++ its20.odd 21 Aug 2012 20:28:22 -0000 1.120
@@ -1644,7 +1644,9 @@
attribute. The following attributes point to existing information:
<att>locNotePointer</att>, <att>locNoteRefPointer</att>, <att>termInfoPointer</att>,
<att>termInfoRefPointer</att>, <att>rubyPointer</att>, <att>rtPointer</att>,
- <att>rpPointer</att>, <att>langPointer</att>.</p>
+ <att>rpPointer</att>, <att>langPointer</att>, <att>locQualityIssuesRefPointer</att>,
+ <att>locQualityIssueTypePointer</att>, <att>locQualityIssueCommentPointer</att>, <att>locQualityIssueSeverityPointer</att>,
+ <att>locQualityIssueProfileRefPointer</att>.</p>
<note type="ed">Make sure that previous list of ..Pointer attributes is complete once spec
is stable.</note>
<p>Context for evaluatiation of the XPath expression is same as for absolute selector with
@@ -4272,10 +4274,10 @@
</div>
</div>
- <div xml:id="lqnote">
+ <div xml:id="lqissue">
<head>Localization Quality Issue</head>
<note type="ed">This data category is not completely stable yet.</note>
- <div xml:id="lqnote-definition">
+ <div xml:id="lqissue-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>
@@ -4294,7 +4296,7 @@
</list>
<p>The data category defines four pieces of information:</p>
<note type="ed">TODO: Table</note>
- <table border="1" xml:id="lqnoteDefs">
+ <table border="1" xml:id="lqissueDefs">
<row role="head">
<cell>Information</cell>
<cell>Description</cell>
@@ -4306,7 +4308,9 @@
<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>
+ map their internal values to these types.
+ If the type of the issue is set to <code>uncategorized</code>, a comment <ref target="#rfc-keywords">MUST</ref>
+ be specified as well.</cell>
</row>
<row>
<cell>Comment</cell>
@@ -4330,12 +4334,12 @@
</row>
</table>
</div>
- <div xml:id="lqnote-implementation">
+ <div xml:id="lqissue-implementation">
<head>Implementation</head>
- <p>The <ref target="#lqnote">Localization Quality Issue</ref> data category can be expressed with global rules,
+ <p>The <ref target="#lqissue">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>
+ <p xml:id="lqissue-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>
@@ -4345,21 +4349,21 @@
<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
+ <item><p>A <att>locQualityIssuesRefPointer</att> attribute that contains a <ref target="#selectors">relative selector</ref>
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
+ <item><p>A <att>locQualityIssueType</att> attribute that implements the <ref target="#lqissueDefs">type information</ref>.</p></item>
+ <item><p>A <att>locQualityIssueTypePointer</att> attribute that contains a <ref target="#selectors">relative selector</ref>
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
+ <item><p>A <att>locQualityIssueComment</att> attribute that implements the <ref target="#lqissueDefs">comment information</ref>.</p></item>
+ <item><p>A <att>locQualityIssueCommentPointer</att> attribute that contains a <ref target="#selectors">relative selector</ref>
pointing to a node with the exact same semantics as <att>locQualityIssueComment</att>.</p></item>
</list>
</item>
@@ -4367,15 +4371,15 @@
</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
+ <item><p>A <att>locQualityIssueSeverity</att> attribute that implements the <ref target="#lqissueDefs">severity information</ref>.</p></item>
+ <item><p>A <att>locQualityIssueSeverityPointer</att> attribute that contains a <ref target="#selectors">relative selector</ref>
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
+ <item><p>A <att>locQualityIssueProfileRef</att> attribute that implements the <ref target="#lqissueDefs">profile reference information</ref>.</p></item>
+ <item><p>A <att>locQualityIssueProfileRefPointer</att> attribute that contains a <ref target="#selectors">relative selector</ref>
pointing to a node with the exact same semantics as <att>locQualityIssueProfileRef</att>.</p></item>
</list>
</item>
@@ -4385,7 +4389,7 @@
<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
+ <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 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
@@ -4397,15 +4401,15 @@
<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>
+ <ref target="#lqissueDefs">type information</ref>.</p></item>
<item><p>A <att>locQualityIssueComment</att> attribute that implements the
- <ref target="#lqnoteDefs">comment information</ref>.</p></item>
+ <ref target="#lqissueDefs">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>
+ <ref target="#lqissueDefs">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>
+ <ref target="#lqissueDefs">profile reference information</ref>.</p></item>
</list>
</item>
<item><p>Or (standoff markup):</p>
@@ -4420,15 +4424,15 @@
<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>
+ <ref target="#lqissueDefs">type information</ref>.</p></item>
<item><p>A <att>locQualityIssueComment</att> attribute that implements the
- <ref target="#lqnoteDefs">comment information</ref>.</p></item>
+ <ref target="#lqissueDefs">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>
+ <ref target="#lqissueDefs">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>
+ <ref target="#lqissueDefs">profile reference information</ref>.</p></item>
</list>
</item>
</list>
@@ -4436,12 +4440,21 @@
</list>
</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-locQualityNote-local-1">
+ <head>TODO</head>
+ <p>TODO</p>
+ </exemplum>
</div>
- <div xml:id="lqnote-markup">
- <head>Markup Declarations for <ref target="#lqnote">Localization Quality Issue</ref></head>
+ <div xml:id="lqissue-markup">
+ <head>Markup Declarations for Localization Quality Issue</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>
+ <desc>Rule about the <ref target="#lqissue">Localization Quality Issue</ref> data category.</desc>
<classes>
<memberOf key="att.selector" />
</classes>
@@ -4552,13 +4565,15 @@
</attList>
</elementSpec>
</specGrp>
+
</div>
</div>
-<!-- <div xml:id="lqprecis">
- <head>Localization Quality Precis</head>
+ <div xml:id="lqprecis">
+ <head>Localization Quality Précis</head>
+ <p>The Localization Quality Précis data category will be defined in an updated version of this document.</p>
</div>
--->
+
</div>
<!-- <div xml:id="catalogues">
@@ -5056,7 +5071,7 @@
<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>
+ <item>Added <ptr target="#lqissue" 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.119
retrieving revision 1.120
diff -u -d -r1.119 -r1.120
--- its20.html 21 Aug 2012 19:57:53 -0000 1.119
+++ its20.html 21 Aug 2012 20:28:22 -0000 1.120
@@ -49,8 +49,8 @@
</div>
<div class="toc2">5.3 <a href="#selectors" shape="rect">Query Language of Selectors</a><div class="toc3">5.3.1 <a href="#queryLanguage" shape="rect">Choosing Query Language</a></div>
<div class="toc3">5.3.2 <a href="#d3e2350" shape="rect">XPath 1.0</a></div>
-<div class="toc3">5.3.3 <a href="#d3e2514" shape="rect">CSS Selectors</a></div>
-<div class="toc3">5.3.4 <a href="#d3e2550" shape="rect">Additional query languages</a></div>
+<div class="toc3">5.3.3 <a href="#d3e2530" shape="rect">CSS Selectors</a></div>
+<div class="toc3">5.3.4 <a href="#d3e2566" shape="rect">Additional query languages</a></div>
<div class="toc3">5.3.5 <a href="#its-param" shape="rect">Variables in selectors</a></div>
</div>
<div class="toc2">5.4 <a href="#link-external-rules" shape="rect">Link to External Rules</a></div>
@@ -117,11 +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 class="toc2">6.18 <a href="#lqissue" shape="rect">Localization Quality Issue</a><div class="toc3">6.18.1 <a href="#lqissue-definition" shape="rect">Definition</a></div>
+<div class="toc3">6.18.2 <a href="#lqissue-implementation" shape="rect">Implementation</a></div>
+<div class="toc3">6.18.3 <a href="#lqissue-markup" shape="rect">Markup Declarations for Localization Quality Issue</a></div>
</div>
+<div class="toc2">6.19 <a href="#lqprecis" shape="rect">Localization Quality Précis</a></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>
@@ -916,21 +916,23 @@
attribute. The following attributes point to existing information:
<a class="itsmarkup" href="#locNoteRule.attributes" shape="rect">locNotePointer</a>, <a class="itsmarkup" href="#locNoteRule.attributes" shape="rect">locNoteRefPointer</a>, <a class="itsmarkup" href="#termRule.attributes" shape="rect">termInfoPointer</a>,
<a class="itsmarkup" href="#termRule.attributes" shape="rect">termInfoRefPointer</a>, <a class="itsmarkup" href="#rubyRule.attributes" shape="rect">rubyPointer</a>, <a class="itsmarkup" href="#rubyRule.attributes" shape="rect">rtPointer</a>,
- <a class="itsmarkup" href="#rubyRule.attributes" shape="rect">rpPointer</a>, <a class="itsmarkup" href="#langRule.attributes" shape="rect">langPointer</a>.</p><span class="editor-note">[Ed. note: Make sure that previous list of ..Pointer attributes is complete once spec
+ <a class="itsmarkup" href="#rubyRule.attributes" shape="rect">rpPointer</a>, <a class="itsmarkup" href="#langRule.attributes" shape="rect">langPointer</a>, <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssuesRefPointer</a>,
+ <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueTypePointer</a>, <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueCommentPointer</a>, <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueSeverityPointer</a>,
+ <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueProfileRefPointer</a>.</p><span class="editor-note">[Ed. note: Make sure that previous list of ..Pointer attributes is complete once spec
is stable.]</span><p>Context for evaluatiation of the XPath expression is same as for absolute selector with
the following changes:</p><ul><li><p>Nodes selected by the expression in the <a class="itsmarkup" href="#att.selector.attribute.selector" shape="rect">selector</a> attribute form the
current node list.</p></li><li><p>Context node comes from the current node list.</p></li><li><p>The context position comes from the position of the current node in the current
node list; the first position is 1.</p></li><li><p>The context size comes from the size of the current node list.</p></li></ul></div></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="d3e2514" id="d3e2514" shape="rect"/>5.3.3 CSS Selectors</h4><p>CSS Selectors are identified by <code>css</code> value in <a class="itsmarkup" href="#rules.attributes" shape="rect">queryLanguage</a>
+<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="d3e2530" id="d3e2530" shape="rect"/>5.3.3 CSS Selectors</h4><p>CSS Selectors are identified by <code>css</code> value in <a class="itsmarkup" href="#rules.attributes" shape="rect">queryLanguage</a>
attribute.</p><div class="div4">
-<h5><a name="d3e2525" id="d3e2525" shape="rect"/>5.3.3.1Absolute selector</h5><p>Absolute selector <a href="#rfc-keywords" shape="rect">MUST</a> be interpreted as selector as
+<h5><a name="d3e2541" id="d3e2541" shape="rect"/>5.3.3.1Absolute selector</h5><p>Absolute selector <a href="#rfc-keywords" shape="rect">MUST</a> be interpreted as selector as
defined in <a href="#css3-selectors" shape="rect">Selectors Level 3</a>. Both simple selectors
and groups of selectors can be used.</p></div><div class="div4">
-<h5><a name="d3e2536" id="d3e2536" shape="rect"/>5.3.3.2Relative selector</h5><p>Relative selector <a href="#rfc-keywords" shape="rect">MUST</a> be interpreted as selector as
+<h5><a name="d3e2552" id="d3e2552" shape="rect"/>5.3.3.2Relative selector</h5><p>Relative selector <a href="#rfc-keywords" shape="rect">MUST</a> be interpreted as selector as
defined in <a href="#css3-selectors" shape="rect">Selectors Level 3</a>. Selector is not
evaluated against the complete document tree but only against subtrees rooted at nodes
selected by selector in the <a class="itsmarkup" href="#att.selector.attribute.selector" shape="rect">selector</a> attribute.</p></div></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="d3e2550" id="d3e2550" shape="rect"/>5.3.4 Additional query languages</h4><p>ITS processors <a href="#rfc-keywords" shape="rect">MAY</a> support additional query languages. For
+<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="d3e2566" id="d3e2566" shape="rect"/>5.3.4 Additional query languages</h4><p>ITS processors <a href="#rfc-keywords" shape="rect">MAY</a> support additional query languages. For
each additional query language processor <a href="#rfc-keywords" shape="rect">MUST</a> define:<ul><li><p>identifier of query language used in <a class="itsmarkup" href="#rules.attributes" shape="rect">queryLanguage</a>;</p></li><li><p>rules for evaluating absolute selector to collection of nodes;</p></li><li><p>rules for evaluating relative selector to collection of nodes.</p></li></ul>
</p><p>Future versions of this specification <a href="#rfc-keywords" shape="rect">MAY</a> define additional
query languages. The following query language identifiers are reserved: <code>xpath</code>,
@@ -984,7 +986,7 @@
<its:termRule selector="//term" term="yes"/>
<its:withinTextRule withinText="yes" selector="//term | //b"/>
</its:rules>
-</myFormatInfo></pre></div><p>[Source file: <a href="examples/xml/EX-link-external-rules-1.xml" shape="rect">examples/xml/EX-link-external-rules-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d3e2718" id="d3e2718" shape="rect"/>Example 20: Document with a link to EX-link-external-rules-1.xml</div><div class="exampleInner"><pre xml:space="preserve">
+</myFormatInfo></pre></div><p>[Source file: <a href="examples/xml/EX-link-external-rules-1.xml" shape="rect">examples/xml/EX-link-external-rules-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d3e2734" id="d3e2734" shape="rect"/>Example 20: Document with a link to EX-link-external-rules-1.xml</div><div class="exampleInner"><pre xml:space="preserve">
<myDoc
xmlns:its="http://www.w3.org/2005/11/its"
xmlns:xlink="http://www.w3.org/1999/xlink" >
@@ -999,7 +1001,7 @@
<p>A <term>Palouse horse</term> has a spotted coat.</p>
</body>
</myDoc></pre></div><p>[Source file: <a href="examples/xml/EX-link-external-rules-2.xml" shape="rect">examples/xml/EX-link-external-rules-2.xml</a>]</p></div><p>The result of processing the two documents above is the same as processing the following
- document.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d3e2730" id="d3e2730" shape="rect"/>Example 21: Document with identical rules as in the case of included rules</div><div class="exampleInner"><pre xml:space="preserve">
+ document.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d3e2746" id="d3e2746" shape="rect"/>Example 21: Document with identical rules as in the case of included rules</div><div class="exampleInner"><pre xml:space="preserve">
<myDoc
xmlns:its="http://www.w3.org/2005/11/its" >
<header>
@@ -1027,7 +1029,7 @@
</p><div class="note"><p class="prefix"><b>Note:</b></p><p>If identical selections are defined in different rules elements within one
document, the selection defined by the last takes precedence.</p></div><div class="note"><p class="prefix"><b>Note:</b></p><p>ITS does not define precedence related to rules defined or linked based on non-ITS
mechanisms (such as processing instructions for linking rules).</p></div></li><li><p>Selections via defaults for data categories, see <a class="section-ref" href="#datacategories-defaults-etc" shape="rect">Section 6.1: Position, Defaults, Inheritance and Overriding of Data Categories</a></p></li></ol><p>In case of conflicts between global selections via multiple <a href="#selection-global" shape="rect">rules</a> elements, the last rule has higher precedence.</p><div class="note"><p class="prefix"><b>Note:</b></p><p>The precedence order fulfills the same purpose as the built-in template rules of <a title="XSL Transformations (XSLT) Version
								1.0" href="#xslt10" shape="rect">[XSLT 1.0]</a>. Override semantics are always complete, that is all
- information that is specified in one rule element is overridden by the next one.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d3e2822" id="d3e2822" shape="rect"/>Example 22: Conflicts between selections of ITS information which are resolved using the precedence
+ information that is specified in one rule element is overridden by the next one.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d3e2838" id="d3e2838" shape="rect"/>Example 22: Conflicts between selections of ITS information which are resolved using the precedence
order</div><p>The two elements <code>title</code> and <code>author</code> of this document should be treated as
separate content when inside a <code>prolog</code> element, but as part of the content of their
parent element otherwise. In order to make this distinction two <a class="itsmarkup" href="#withinTextRule" shape="rect">withinTextRule</a>
@@ -1154,7 +1156,7 @@
</td><td rowspan="1" colspan="1">Yes</td><td rowspan="1" colspan="1">Yes</td><td rowspan="1" colspan="1">Yes</td><td rowspan="1" colspan="1">No</td><td rowspan="1" colspan="1">
<code>default</code>
</td><td rowspan="1" colspan="1">Textual content of element, <em>including</em> attributes and child
- elements</td><td rowspan="1" colspan="1">Yes</td></tr></tbody></table><div class="exampleOuter"><div class="exampleHeader"><a name="d3e3316" id="d3e3316" shape="rect"/>Example 24: Defaults, inheritance and overriding behavior of data categories</div><p>In this example, the content of all the <code>data</code> elements is translatable because the
+ elements</td><td rowspan="1" colspan="1">Yes</td></tr></tbody></table><div class="exampleOuter"><div class="exampleHeader"><a name="d3e3332" id="d3e3332" shape="rect"/>Example 24: Defaults, inheritance and overriding behavior of data categories</div><p>In this example, the content of all the <code>data</code> elements is translatable because the
default for the <a href="#trans-datacat" shape="rect">Translate</a> data category in elements is
"yes". The content of <code>revision</code> and <a class="itsmarkup" href="#locNote" shape="rect">locNote</a> is not
translatable because the default is overridden by the local <code>its:translate="no"</code>
@@ -1322,7 +1324,7 @@
<body>
<msg id="NotFound">Cannot find {0} on {1}.</msg>
</body>
-</myRes></pre></div><p>[Source file: <a href="examples/xml/EX-locNoteRef-attribute-1.xml" shape="rect">examples/xml/EX-locNoteRef-attribute-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d3e3801" id="d3e3801" shape="rect"/>Example 31: The <a class="itsmarkup" href="#locNoteRule.attributes" shape="rect">locNoteRefPointer</a> attribute</div><p>The <a class="itsmarkup" href="#locNoteRule.attributes" shape="rect">locNoteRefPointer</a> attribute contains a <a href="#selectors" shape="rect">relative
+</myRes></pre></div><p>[Source file: <a href="examples/xml/EX-locNoteRef-attribute-1.xml" shape="rect">examples/xml/EX-locNoteRef-attribute-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d3e3817" id="d3e3817" shape="rect"/>Example 31: The <a class="itsmarkup" href="#locNoteRule.attributes" shape="rect">locNoteRefPointer</a> attribute</div><p>The <a class="itsmarkup" href="#locNoteRule.attributes" shape="rect">locNoteRefPointer</a> attribute contains a <a href="#selectors" shape="rect">relative
selector</a> pointing to a node that holds the URI referring to the location of
the note.</p><div class="exampleInner"><pre xml:space="preserve">
<dataFile
@@ -1344,7 +1346,7 @@
itself.</p></li><li><p>A <a class="itsmarkup" href="#att.local.no-ns.attribute.locNoteRef" shape="rect">locNoteRef</a> attribute that contains a URI referring
to the location of the localization note.</p></li></ul></li><li><p>An optional <a class="itsmarkup" href="#att.local.no-ns.attribute.locNoteType" shape="rect">locNoteType</a> attribute with the value
"description" or "alert". If the <a class="itsmarkup" href="#att.local.no-ns.attribute.locNoteType" shape="rect">locNoteType</a> attribute is not present, the type of localization note will be
- assumed to be "description". </p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d3e3863" id="d3e3863" shape="rect"/>Example 32: The <a href="#locNote-datacat" shape="rect">Localization Note</a> data category expressed
+ assumed to be "description". </p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d3e3879" id="d3e3879" shape="rect"/>Example 32: The <a href="#locNote-datacat" shape="rect">Localization Note</a> data category expressed
locally</div><div class="exampleInner"><pre xml:space="preserve">
<msgList
xmlns:its="http://www.w3.org/2005/11/its" xml:space="preserve"
@@ -1358,7 +1360,7 @@
its:locNote="%1\$s is the original text's date in the format YYYY-MM-DD HH:MM always in GMT">
<value>Translated from English content dated <span id="version-info">%1\$s</span> GMT.</value>
</data>
-</msgList></pre></div><p>[Source file: <a href="examples/xml/EX-locNote-selector-2.xml" shape="rect">examples/xml/EX-locNote-selector-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d3e3876" id="d3e3876" shape="rect"/>Example 33: The <a href="#locNote-datacat" shape="rect">Localization Note</a> data category expressed
+</msgList></pre></div><p>[Source file: <a href="examples/xml/EX-locNote-selector-2.xml" shape="rect">examples/xml/EX-locNote-selector-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d3e3892" id="d3e3892" shape="rect"/>Example 33: The <a href="#locNote-datacat" shape="rect">Localization Note</a> data category expressed
locally in HTML5</div><div class="exampleInner"><pre xml:space="preserve"><!DOCTYPE html>
<html lang="en">
<head>
@@ -1408,7 +1410,7 @@
"no".</p></li><li><p>Exactly one of the following:</p><ul><li><p>A <a class="itsmarkup" href="#termRule.attributes" shape="rect">termInfoPointer</a> attribute that contains a <a href="#selectors" shape="rect">relative selector</a> pointing to a node that holds
the terminology information.</p></li><li><p>A <a class="itsmarkup" href="#att.local.no-ns.attribute.termInfoRef" shape="rect">termInfoRef</a> attribute that contains a URI referring to the
resource providing information about the term.</p></li><li><p>A <a class="itsmarkup" href="#termRule.attributes" shape="rect">termInfoRefPointer</a> attribute that contains a <a href="#selectors" shape="rect">relative selector</a> pointing to a node that holds
- the URI referring to the location of the terminology information.</p></li></ul></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d3e4115" id="d3e4115" shape="rect"/>Example 34: Usage of the <a class="itsmarkup" href="#termRule.attributes" shape="rect">termInfoPointer</a> attribute</div><div class="exampleInner"><pre xml:space="preserve">
+ the URI referring to the location of the terminology information.</p></li></ul></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d3e4131" id="d3e4131" shape="rect"/>Example 34: Usage of the <a class="itsmarkup" href="#termRule.attributes" shape="rect">termInfoPointer</a> attribute</div><div class="exampleInner"><pre xml:space="preserve">
<text
xmlns:its="http://www.w3.org/2005/11/its" >
<its:rules version="2.0">
@@ -1419,7 +1421,7 @@
structure, between the implied author or some other addresser,
and the fiction.</gloss>
</p>
-</text></pre></div><p>[Source file: <a href="examples/xml/EX-terms-selector-1.xml" shape="rect">examples/xml/EX-terms-selector-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d3e4128" id="d3e4128" shape="rect"/>Example 35: Usage of the <a class="itsmarkup" href="#att.local.no-ns.attribute.termInfoRef" shape="rect">termInfoRef</a> attribute</div><div class="exampleInner"><pre xml:space="preserve">
+</text></pre></div><p>[Source file: <a href="examples/xml/EX-terms-selector-1.xml" shape="rect">examples/xml/EX-terms-selector-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d3e4144" id="d3e4144" shape="rect"/>Example 35: Usage of the <a class="itsmarkup" href="#att.local.no-ns.attribute.termInfoRef" shape="rect">termInfoRef</a> attribute</div><div class="exampleInner"><pre xml:space="preserve">
<text
xmlns:its="http://www.w3.org/2005/11/its" >
<its:rules version="2.0">
@@ -1430,7 +1432,7 @@
structure, between the implied author or some other addresser,
and the fiction.</gloss>
</p>
-</text></pre></div><p>[Source file: <a href="examples/xml/EX-terms-selector-2.xml" shape="rect">examples/xml/EX-terms-selector-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d3e4141" id="d3e4141" shape="rect"/>Example 36: Usage of the <a class="itsmarkup" href="#termRule.attributes" shape="rect">termInfoRefPointer</a> attribute</div><div class="exampleInner"><pre xml:space="preserve">
+</text></pre></div><p>[Source file: <a href="examples/xml/EX-terms-selector-2.xml" shape="rect">examples/xml/EX-terms-selector-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d3e4157" id="d3e4157" shape="rect"/>Example 36: Usage of the <a class="itsmarkup" href="#termRule.attributes" shape="rect">termInfoRefPointer</a> attribute</div><div class="exampleInner"><pre xml:space="preserve">
<text
xmlns:its="http://www.w3.org/2005/11/its" >
<its:rules version="2.0">
@@ -1519,7 +1521,7 @@
xmlns:its="http://www.w3.org/2005/11/its" version="2.0">
<its:dirRule dir="rtl" selector="//*[@direction='rtlText']"/>
</its:rules></pre></div><p>[Source file: <a href="examples/xml/EX-dir-selector-2.xml" shape="rect">examples/xml/EX-dir-selector-2.xml</a>]</p></div><p id="directionality-local">LOCAL: The following local markup is available for the <a href="#directionality" shape="rect">Directionality</a> data category:</p><ul><li><p>A <a class="itsmarkup" href="#att.local.no-ns.attribute.dir" shape="rect">dir</a> attribute with the value "ltr", "rtl",
- "lro" or "rlo".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d3e4486" id="d3e4486" shape="rect"/>Example 41: The <a href="#directionality" shape="rect">Directionality</a> data category expressed
+ "lro" or "rlo".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d3e4502" id="d3e4502" shape="rect"/>Example 41: The <a href="#directionality" shape="rect">Directionality</a> data category expressed
locally</div><p>On the first <code>quote</code> element, the <code>its:dir="rtl"</code> attribute indicates a
right-to-left content.</p><div class="exampleInner"><pre xml:space="preserve">
<text
@@ -1530,7 +1532,7 @@
its:dir="rtl"><span dir="rtl">نشاط التدويل، W3C</span></quote>
means <quote>Internationalization Activity, W3C</quote>.</par>
</body>
-</text></pre></div><p>[Source file: <a href="examples/xml/EX-dir-selector-3.xml" shape="rect">examples/xml/EX-dir-selector-3.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d3e4510" id="d3e4510" shape="rect"/>Example 42: The <a href="#directionality" shape="rect">Directionality</a> data category expressed locally
+</text></pre></div><p>[Source file: <a href="examples/xml/EX-dir-selector-3.xml" shape="rect">examples/xml/EX-dir-selector-3.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="d3e4526" id="d3e4526" shape="rect"/>Example 42: The <a href="#directionality" shape="rect">Directionality</a> data category expressed locally
in HTML5</div><div class="exampleInner"><pre xml:space="preserve"><!DOCTYPE html>
<html lang="en">
<head>
@@ -1669,7 +1671,7 @@
<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="within-text-implementation" id="within-text-implementation" shape="rect"/>6.8.2 Implementation</h4><p>The <a href="#elements-within-text" shape="rect">Elements Within Text</a> data category can be
expressed with global rules, or locally on an individual element. There is no inheritance.
The default is that elements are not within text.</p><p id="withintext-global">GLOBAL: The <a class="itsmarkup" href="#withinTextRule" shape="rect">withinTextRule</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>A required <a class="itsmarkup" href="#att.local.no-ns.attribute.withinText" shape="rect">withinText</a> attribute with the value "yes",
- "no" or "nested".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d3e5191" id="d3e5191" shape="rect"/>Example 46: Specifying elements within text with a <a class="itsmarkup" href="#withinTextRule" shape="rect">withinTextRule</a> element</div><div class="exampleInner"><pre xml:space="preserve">
+ "no" or "nested".</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d3e5207" id="d3e5207" shape="rect"/>Example 46: Specifying elements within text with a <a class="itsmarkup" href="#withinTextRule" shape="rect">withinTextRule</a> element</div><div class="exampleInner"><pre xml:space="preserve">
<its:rules
xmlns:its="http://www.w3.org/2005/11/its" version="2.0">
<its:withinTextRule withinText="yes" selector="//b | //em | //i"/>
@@ -2301,8 +2303,8 @@
<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 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
+<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="lqissue" id="lqissue" 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="lqissue-definition" id="lqissue-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
@@ -2310,35 +2312,39 @@
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
+ 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="lqissueDefs" id="lqissueDefs" 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.
+ If the type of the issue is set to <code>uncategorized</code>, a comment <a href="#rfc-keywords" shape="rect">MUST</a>
+ be specified as well.</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,
+<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="lqissue-implementation" id="lqissue-implementation" shape="rect"/>6.18.2 Implementation</h4><p>The <a href="#lqissue" 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
+ <em>including</em> child elements, but excluding attributes.</p><p id="lqissue-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 <a href="#selectors" shape="rect">relative selector</a>
+ 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="#lqissueDefs" shape="rect">type information</a>.</p></li><li><p>A <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueTypePointer</a> attribute that contains a <a href="#selectors" shape="rect">relative selector</a>
+ 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="#lqissueDefs" shape="rect">comment information</a>.</p></li><li><p>A <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueCommentPointer</a> attribute that contains a <a href="#selectors" shape="rect">relative selector</a>
+ 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="#lqissueDefs" shape="rect">severity information</a>.</p></li><li><p>A <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueSeverityPointer</a> attribute that contains a <a href="#selectors" shape="rect">relative selector</a>
+ 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="#lqissueDefs" 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 <a href="#selectors" shape="rect">relative selector</a>
+ 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="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 <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
+ <a href="#lqissueDefs" 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="#lqissueDefs" 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="#lqissueDefs" 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="#lqissueDefs" 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>
+ <a href="#lqissueDefs" 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="#lqissueDefs" 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="#lqissueDefs" 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="#lqissueDefs" shape="rect">profile reference information</a>.</p></li></ul></li></ul></li></ul></li></ul><p>Important: When the attributes <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueType</a>, <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueComment</a>, <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueSeverity</a>
+ and <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueProfileRef</a> (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
+ <a class="itsmarkup" href="#locQualityIssue" shape="rect">locQualityIssue</a> (or <code><span loc-quality-issue></code>in HTML) where they are declared.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityNote-local-1" id="EX-locQualityNote-local-1" shape="rect"/>Example 68: TODO</div><p>TODO</p></div></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="lqissue-markup" id="lqissue-markup" shape="rect"/>6.18.3 Markup Declarations for Localization Quality Issue</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,
@@ -2365,7 +2371,8 @@
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">
+ attribute locQualityIssueProfileRef { xsd:anyURI }?</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="lqprecis" id="lqprecis" shape="rect"/>6.19 Localization Quality Précis</h3><p>The Localization Quality Précis data category will be defined in an updated version of this document.</p></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:
@@ -2629,7 +2636,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="d3e8250" id="d3e8250" shape="rect"/>Example 68: Testing constraints in ITS markup</div><div class="exampleInner"><pre xml:space="preserve">
+ constraints.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d3e8315" id="d3e8315" shape="rect"/>Example 69: 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.
@@ -2696,7 +2703,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="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
+ attributes of host language are ignored during validation against this NVDL document/schema.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d3e8337" id="d3e8337" shape="rect"/>Example 70: 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>
@@ -2704,7 +2711,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><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
+ 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="#lqissue" shape="rect">Section 6.18: Localization Quality Issue</a>.</p></li></ol>p 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 20:28:37 UTC