- From: CVS User fsasaki <cvsmail@w3.org>
- Date: Fri, 30 Nov 2012 10:15:27 +0000
- To: public-multilingualweb-lt-commits@w3.org
Update of /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/TR-version
In directory gil:/tmp/cvs-serv2425/TR-version
Modified Files:
Overview.html
Log Message:
status section, first version
--- /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/TR-version/Overview.html 2012/11/29 15:40:43 1.66
+++ /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/TR-version/Overview.html 2012/11/30 10:15:27 1.67
@@ -29,15 +29,14 @@
successor of <a href="http://www.w3.org/TR/2007/REC-its-20070403/">ITS 1.0</a>; it is
designed to foster the creation of multilingual Web content, focusing on HTML, XML based
formats in general, and to leverage localization workflows based on the XML Localization
- Interchange File Format (XLIFF).</p><p>This document is a Last Call Working Draft published by the <a href="http://www.w3.org/International/multilingualweb/lt/">MultilingualWeb-LT Working
- Group</a>, part of the <a href="https://www.w3.org/International/">W3C
- Internationalization Activity</a>. The Working Group expects to advance this Working
+ Interchange File Format (XLIFF).</p><p>This document was published by the <a href="http://www.w3.org/International/multilingualweb/lt/">MultilingualWeb-LT Working
+ Group</a> as a Last Call Working Draft. The Working Group expects to advance this Working
Draft to Recommendation status (see <a href="http://www.w3.org/2004/02/Process-20040205/tr.html#maturity-levels">W3C document
- maturity levels</a>).</p><p id="major-changes">A list of <a href="#changelog-since-20121023">major changes since
- the previous publication</a> is available.</p><p>Feedback about the content of this document is encouraged. See also <a href="https://www.w3.org/International/multilingualweb/lt/track/issues/">issues discussed
- within the Working Group</a>. Send your comments to <a href="mailto:public-multilingualweb-lt-comments@w3.org">public-multilingualweb-lt-comments@w3.org</a>. Use "Comment on ITS 2.0 specification
+ maturity levels</a>). The Last Call period ends 07 January 2013.</p><p>The normative sections of this document (from <a class="section-ref" href="#notation-terminology">Section 3: Notation and Terminology</a> to <a class="section-ref" href="#datacategory-description">Section 8: Description of Data Categories</a> and <a class="section-ref" href="#normative-references">Appendix A: References</a> to <a class="section-ref" href="#its-schemas">Appendix D: Schemas for ITS</a>) are stable. The other, non-normative sections contain only explanatory material and will be updated in a later working draft. Hence, the Working Group especially encourages feedback on the normative sections. The goal is to move out of last call without any substantive changes to these sections.</p><p>To give feedback send your comments to <a href="mailto:public-multilingualweb-lt-comments@w3.org">public-multilingualweb-lt-comments@w3.org</a>. Use "Comment on ITS 2.0 specification
WD" in the subject line of your email. The <a href="http://lists.w3.org/Archives/Public/public-multilingualweb-lt-comments/">archives
- for this list</a> are publicly available.</p><p>Publication as a Working Draft does not imply endorsement by the W3C Membership. This is a
+ for this list</a> are publicly available. See also <a href="https://www.w3.org/International/multilingualweb/lt/track/issues/">issues discussed
+ within the Working Group</a> and the <a href="#changelog-since-20121023">list of changes since
+ the previous publication</a>.</p><p>Publication as a Working Draft does not imply endorsement by the W3C Membership. This is a
draft document and may be updated, replaced or obsoleted by other documents at any time. It
is inappropriate to cite this document as other than work in progress.</p><p> This document was produced by a group operating under the <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/">5 February 2004 W3C Patent
Policy</a>. W3C maintains a <a href="http://www.w3.org/2004/01/pp-impl/53116/status">public list of any patent disclosures</a> made in connection with the deliverables of
@@ -82,9 +81,9 @@
<div class="toc3">5.2.2 <a href="#selection-local">Local Selection in an XML Document</a></div>
</div>
<div class="toc2">5.3 <a href="#selectors">Query Language of Selectors</a><div class="toc3">5.3.1 <a href="#queryLanguage">Choosing Query Language</a></div>
-<div class="toc3">5.3.2 <a href="#d0e2087">XPath 1.0</a></div>
-<div class="toc3">5.3.3 <a href="#d0e2278">CSS Selectors</a></div>
-<div class="toc3">5.3.4 <a href="#d0e2317">Additional query languages</a></div>
+<div class="toc3">5.3.2 <a href="#d0e2071">XPath 1.0</a></div>
+<div class="toc3">5.3.3 <a href="#d0e2262">CSS Selectors</a></div>
+<div class="toc3">5.3.4 <a href="#d0e2301">Additional query languages</a></div>
<div class="toc3">5.3.5 <a href="#its-param">Variables in selectors</a></div>
</div>
<div class="toc2">5.4 <a href="#link-external-rules">Link to External Rules</a></div>
@@ -168,11 +167,10 @@
<div class="toc1">D <a href="#its-schemas">Schemas for ITS</a></div>
<div class="toc1">E <a href="#informative-references">References</a> (Non-Normative)</div>
<div class="toc1">F <a href="#its-schematron-constraints">Checking ITS Markup Constraints With Schematron</a> (Non-Normative)</div>
-<div class="toc1">G <a href="#its-nvdl-schema">Checking ITS Markup with NVDL</a> (Non-Normative)</div>
-<div class="toc1">H <a href="#nif-backconversion">Conversion NIF2ITS</a> (Non-Normative)</div>
-<div class="toc1">I <a href="#list-of-elements-and-attributes">List of ITS 2.0 Elements and Attributes</a> (Non-Normative)</div>
-<div class="toc1">J <a href="#revisionlog">Revision Log</a> (Non-Normative)</div>
-<div class="toc1">K <a href="#acknowledgements">Acknowledgements</a> (Non-Normative)</div>
+<div class="toc1">G <a href="#nif-backconversion">Conversion NIF2ITS</a> (Non-Normative)</div>
+<div class="toc1">H <a href="#list-of-elements-and-attributes">List of ITS 2.0 Elements and Attributes</a> (Non-Normative)</div>
+<div class="toc1">I <a href="#revisionlog">Revision Log</a> (Non-Normative)</div>
+<div class="toc1">J <a href="#acknowledgements">Acknowledgements</a> (Non-Normative)</div>
</div><hr/><div class="body"><div class="div1">
<h2><a href="#contents"><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="introduction" id="introduction"></a>1 Introduction</h2><p>
<em>This section is informative.</em>
@@ -201,8 +199,7 @@
metadata.</p></li><li><p>A global implementation of ITS 2.0 requires at least the XPath version 1.0.
Other versions of XPath or other query languages (e.g., CSS selectors) can be
expressed via a dedicated <a href="#queryLanguage">queryLanguage</a>
- attribute.</p></li></ul><p>As of the time of this writing, the new data categories included in ITS 2.0 are:</p><span class="editor-note">[Ed. note: Below needs to be updated before each publication before last
- call.]</span><ul><li><p><a href="#domain">Domain</a></p></li><li><p><a href="#Disambiguation">Disambiguation</a></p></li><li><p><a href="#LocaleFilter">Locale Filter</a></p></li><li><p><a href="#provenance">Provenance</a></p></li><li><p><a href="#externalresource">External Resource</a></p></li><li><p><a href="#target-pointer">Target Pointer</a></p></li><li><p><a href="#idvalue">Id Value</a></p></li><li><p><a href="#preservespace">Preserve Space</a></p></li><li><p><a href="#lqissue">Localization Quality Issue</a></p></li><li><p><a href="#lqrating">Localization Quality Rating</a></p></li><li><p><a href="#mtconfidence">MT Confidence</a></p></li><li><p><a href="#allowedchars">Allowed Characters</a></p></li><li><p><a href="#storagesize">Storage Size</a></p></li></ul></div></div><div class="div2">
+ attribute.</p></li></ul><p id="its20-new-data-categories">The new data categories included in ITS 2.0 are:</p><ul><li><p><a href="#domain">Domain</a></p></li><li><p><a href="#Disambiguation">Disambiguation</a></p></li><li><p><a href="#LocaleFilter">Locale Filter</a></p></li><li><p><a href="#provenance">Provenance</a></p></li><li><p><a href="#externalresource">External Resource</a></p></li><li><p><a href="#target-pointer">Target Pointer</a></p></li><li><p><a href="#idvalue">Id Value</a></p></li><li><p><a href="#preservespace">Preserve Space</a></p></li><li><p><a href="#lqissue">Localization Quality Issue</a></p></li><li><p><a href="#lqrating">Localization Quality Rating</a></p></li><li><p><a href="#mtconfidence">MT Confidence</a></p></li><li><p><a href="#allowedchars">Allowed Characters</a></p></li><li><p><a href="#storagesize">Storage Size</a></p></li></ul></div></div><div class="div2">
<h3><a href="#contents"><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="motivation-its" id="motivation-its"></a>1.2 Motivation for ITS</h3><p>Content or software that is authored in one language (the <span class="new-term">source language</span>)
is often made available in additional languages or adapted with regard to other cultural
aspects. This is done through a process called <span class="new-term">localization</span>, where the
@@ -656,10 +653,7 @@
<code class="its-attr-markup">locNotePointer</code> attribute).</p><p>The functionality of adding information to the selected nodes is available for each
data category except <a href="#language-information">Language Information</a>.
Pointing to existing information is not possible for data categories that express
- <em>a closed set of values</em>; that is: <a href="#trans-datacat">Translate</a>, <a href="#directionality">Directionality</a>, <a href="#LocaleFilter">Locale Filter</a> and <a href="#elements-within-text">Elements Within Text</a>.</p><span class="editor-note">[Ed. note: The following statement is not correct anymore, e.g. <a href="#lqissue-global">Localization Quality Issue, applied globally</a> allows for
- something like <code class="its-attr-markup">locQualityIssuesRef</code> and <code class="its-attr-markup">locQualityIssuesRefPointer</code>
- at the same <code class="its-elem-markup">locQualityIssueRule</code> element. Should this be changed or should the
- statement be dropped?]</span><p>The functionalities of adding information and pointing to existing information are
+ <em>a closed set of values</em>; that is: <a href="#trans-datacat">Translate</a>, <a href="#directionality">Directionality</a>, <a href="#LocaleFilter">Locale Filter</a> and <a href="#elements-within-text">Elements Within Text</a>.</p><p>The functionalities of adding information and pointing to existing information are
<em>mutually exclusive</em>. That is to say, attributes for pointing and adding
must not appear at the same rule element.</p></div></div><div class="div1">
<h2><a href="#contents"><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="notation-terminology" id="notation-terminology"></a>3 Notation and Terminology</h2><p>
@@ -679,7 +673,7 @@
and localization of XML schemas and documents.] The concept of a data
category is independent of its implementation in an XML and HTML environment (e.g. using an
element or attribute).</p><p>For each data category, ITS distinguishes between the following:</p><ul><li><p>the prose description, see <a class="section-ref" href="#datacategory-description">Section 8: Description of Data Categories</a></p></li><li><p>schema language independent formalization, see the "implementation" subsections in
- <a class="section-ref" href="#datacategory-description">Section 8: Description of Data Categories</a></p></li><li><p>schema language specific implementations, see <a class="section-ref" href="#its-schemas">Appendix D: Schemas for ITS</a></p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d0e1190" id="d0e1190"></a>Example 13: A data category and its implementation</div><p>The <a href="#trans-datacat">Translate</a> data category conveys information as
+ <a class="section-ref" href="#datacategory-description">Section 8: Description of Data Categories</a></p></li><li><p>schema language specific implementations, see <a class="section-ref" href="#its-schemas">Appendix D: Schemas for ITS</a></p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="d0e1177" id="d0e1177"></a>Example 13: A data category and its implementation</div><p>The <a href="#trans-datacat">Translate</a> data category conveys information as
to whether a piece of content should be translated or not.</p><p>The simplest formalization of this prose description on a schema language independent
level is a <code class="its-attr-markup">translate</code> attribute with two possible values:
"yes" and "no". An implementation on a schema language specific
@@ -821,7 +815,7 @@
given for XML (clause 2-3). In addition, there are test cases for
conversion to NIF (clause 2-4). Implementors are encouraged to organize their
documentation in a similar way, so that users of ITS 2.0 easily can understand the
- processing capabilities available.</p></div><span class="editor-note">[Ed. note: Need to update link to test suite once the test suite is moved.]</span></div><div class="div2">
+ processing capabilities available.</p></div></div><div class="div2">
<h3><a href="#contents"><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="conformance-product-html-processing-expectations" id="conformance-product-html-processing-expectations"></a>4.3 Conformance Type 3: Processing Expectations for ITS Markup in HTML</h3><p>
<em>Description:</em> Processors need to compute the ITS information that pertains
to a node in a HTML document. The ITS processing expectations define how the
@@ -939,9 +933,9 @@
actual query language. The query language is set by <code class="its-attr-markup">queryLanguage</code> attribute
on <code class="its-elem-markup">rules</code> element. If <code class="its-attr-markup">queryLanguge</code> is not specified XPath 1.0 is
used as a default query language.</p></div><div class="div3">
-<h4><a href="#contents"><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="d0e2087" id="d0e2087"></a>5.3.2 XPath 1.0</h4><p>XPath 1.0 is identified by <code>xpath</code> value in <code class="its-attr-markup">queryLanguage</code>
+<h4><a href="#contents"><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="d0e2071" id="d0e2071"></a>5.3.2 XPath 1.0</h4><p>XPath 1.0 is identified by <code>xpath</code> value in <code class="its-attr-markup">queryLanguage</code>
attribute.</p><div class="div4">
-<h5><a name="d0e2098" id="d0e2098"></a>5.3.2.1Absolute selector</h5><p>The absolute selector <a href="#rfc-keywords">MUST</a> be an XPath expression
+<h5><a name="d0e2082" id="d0e2082"></a>5.3.2.1Absolute selector</h5><p>The absolute selector <a href="#rfc-keywords">MUST</a> be an XPath expression
which starts with "<code>/</code>". That is, it must be an <a href="http://www.w3.org/TR/xpath/#NT-AbsoluteLocationPath">
AbsoluteLocationPath</a> or union of <a href="http://www.w3.org/TR/xpath/#NT-AbsoluteLocationPath">
AbsoluteLocationPath</a>s as described in <a href="#xpath">XPath 1.0</a>.
@@ -973,18 +967,18 @@
with the following changes:</p><ul><li><p>Nodes selected by the expression in the <code class="its-attr-markup">selector</code> 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"><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="d0e2278" id="d0e2278"></a>5.3.3 CSS Selectors</h4><div class="note"><p class="prefix"><b>Note:</b></p><p id="css-selectors-feature-at-risk">As of writing the working group has no
+<h4><a href="#contents"><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="d0e2262" id="d0e2262"></a>5.3.3 CSS Selectors</h4><div class="note"><p class="prefix"><b>Note:</b></p><p id="css-selectors-feature-at-risk">As of writing the working group has no
implememtation commitment for CSS selectors. If this doesn't change CSS selectors
will be marked as feature at risk for the candidate recommendation draft.</p></div><p>CSS Selectors are identified by <code>css</code> value in <code class="its-attr-markup">queryLanguage</code>
attribute.</p><div class="div4">
-<h5><a name="d0e2292" id="d0e2292"></a>5.3.3.1Absolute selector</h5><p>Absolute selector <a href="#rfc-keywords">MUST</a> be interpreted as selector
+<h5><a name="d0e2276" id="d0e2276"></a>5.3.3.1Absolute selector</h5><p>Absolute selector <a href="#rfc-keywords">MUST</a> be interpreted as selector
as defined in <a href="#css3-selectors">Selectors Level 3</a>. Both simple
selectors and groups of selectors can be used.</p></div><div class="div4">
-<h5><a name="d0e2303" id="d0e2303"></a>5.3.3.2Relative selector</h5><p>Relative selector <a href="#rfc-keywords">MUST</a> be interpreted as selector
+<h5><a name="d0e2287" id="d0e2287"></a>5.3.3.2Relative selector</h5><p>Relative selector <a href="#rfc-keywords">MUST</a> be interpreted as selector
as defined in <a href="#css3-selectors">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 <code class="its-attr-markup">selector</code> attribute.</p></div></div><div class="div3">
-<h4><a href="#contents"><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="d0e2317" id="d0e2317"></a>5.3.4 Additional query languages</h4><p>ITS processors <a href="#rfc-keywords">MAY</a> support additional query
+<h4><a href="#contents"><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="d0e2301" id="d0e2301"></a>5.3.4 Additional query languages</h4><p>ITS processors <a href="#rfc-keywords">MAY</a> support additional query
languages. For each additional query language processor <a href="#rfc-keywords">MUST</a> define:</p><ul><li><p>identifier of query language used in <code class="its-attr-markup">queryLanguage</code>;</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>Future versions of this specification <a href="#rfc-keywords">MAY</a> define
additional query languages. The following query language identifiers are reserved:
<code>xpath</code>, <code>css</code>, <code>xpath2</code>, <code>xpath3</code>,
@@ -1150,7 +1144,7 @@
attribute, as shown in <a href="#EX-link-external-rules-1">Example 19</a></p></li></ul></li><li><p>By associating the rules and the document through a tool-specific mechanism. For
example, for a command-line tool: providing the paths of both the XML document to
process and its corresponding external rules file.</p></li></ul></div><div class="div2">
-<h3><a href="#contents"><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="conversion-to-nif" id="conversion-to-nif"></a>5.7 Conversion to NIF</h3><span class="editor-note">[Ed. note: This will also need to be marked as feature at risk, only one implementation so far]</span><p>This section defines an algorithm to convert XML or HTML documents (or their DOM
+<h3><a href="#contents"><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="conversion-to-nif" id="conversion-to-nif"></a>5.7 Conversion to NIF</h3><p>This section defines an algorithm to convert XML or HTML documents (or their DOM
representations) that contain ITS metadata to the RDF-based format <a href="http://nlp2rdf.org/nif-1-0">NIF</a>. The conversion results in RDF triples.</p><div class="note"><p class="prefix"><b>Note:</b></p><p>The algorithm is intended to extract the text from the XML/HTML/DOM for an NLP
tool and can produce a lot of "<span class="quote">phantom</span>" predicates from excessive
whitespace, which 1) increases the size of the intermediate mapping and 2) extracts
@@ -1239,7 +1233,7 @@
str:referenceContext <strong class="hl-tag" style="color: #000096"><http:</strong>//example.com/exampledoc.html#offset_0_29> .
</pre></div></div><p>A complete sample output in RDF/XML format after step 7, given the input document <a href="#EX-HTML-whitespace-normalization">Example 25</a>, is available at <a href="examples/nif/EX-nif-conversion-output.xml">examples/nif/EX-nif-conversion-output.xml</a>.</p><div class="note"><p class="prefix"><b>Note:</b></p><p>The conversion to NIF is the basis for natural language processing (NLP)
applications, creating for example named entity annotations. A non-normative algorithm
- to integrate these annotations into the original input document is given in <a class="section-ref" href="#nif-backconversion">Appendix H: Conversion NIF2ITS</a>. The algorithm in that appendix is
+ to integrate these annotations into the original input document is given in <a class="section-ref" href="#nif-backconversion">Appendix G: Conversion NIF2ITS</a>. The algorithm in that appendix is
non-normative since many choices depend on the actual NLP application.</p></div></div><div class="div2">
<h3><a href="#contents"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="its-tool-annotation" id="its-tool-annotation"></a>5.8 ITS Tools Annotation</h3><p>In some cases, it may be important for instances of data categories to be associated with information about the processor that generated them. For example, the score of the <a href="#mtconfidence">MT Confidence</a> data category (provided via the <code class="its-attr-markup">mtConfidence</code> attribute) is meaningful only when the consumer of the information also knows what MT engine produced it, because the score provides the relative confidence of translations from the same MT engine but does not provide a score that can be reliably compared between MT engines. The same is true for confidence provided for the <a href="#Disambiguation">Disambiguation</a> data category, providing confidence information via the <code class="its-attr-markup">disambiConfidence</code> attribute, or the <a href="#terminology">Terminology</a> data category, providing confidence information via the <code class="its-attr-markup">termConfidence</code> attribute.</p><p>ITS 2.0 provides a mechanism to associate such processor information with the use of individual data categories in a document, independently from data category annotations themselves.</p><p>The attribute <code class="its-attr-markup">toolsRef</code> provides a way to associate all the annotations of a given data category within the element with information about the processor that generated those data category annotations.</p><p>The value of <code class="its-attr-markup">toolsRef</code> is a space-separated list of references where each reference is composed of two parts: a data category identifier and an IRI. These two parts are separated by a character <code>|</code> VERTICAL LINE (U+007C).</p><ul><li><p>The data category identifier <a href="#rfc2119">MUST</a> be one of the identifiers specified in the <a hre="#datacategories-overview">data category overview table</a>.</p></li><li><p>The IRI indicates information about the processor used to generate the data category annotation. No single means is specified for how this IRI should be used to indicate processor information. Possible mechanisms are: to encode information directly in the IRI, e.g. as parameters; to reference an external resource that provides such information, e.g. an XML file or an RDF declaration; or to reference another part of the document that provides such information.</p></li></ul><p>In HTML documents, the mechanism is implemented with the <code class="its-attr-markup">its-tools-ref</code> attribute.</p><p>The attribute applies to the content of the element where it is declared (including its children elements) and to the attributes of that element.</p><p>On any given node, the information provided by this mechanism is a space-separated list of the accumulated references found it the <code class="its-attr-markup">toolsRef</code> attributes declared in the enclosing elements and sorted by data category identifiers. For each data category, the IRI part is the one of the inner-most declarartion.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-its-tool-annotation-1" id="EX-its-tool-annotation-1"></a>Example 26: Accumulation and Overriding of the <code class="its-attr-markup">toolsRef</code> Values</div><p>In this example, the text shows the computed tools reference information for the given node. Note that the references are ordered alphabetically and
@@ -1436,7 +1430,7 @@
<a href="#provenance">Provenance</a> (<code>provenance</code>)
</td><td>Yes</td><td>Yes</td><td>No</td><td>Yes</td><td>None</td><td>Textual content of element, <em>including</em> child elements and
attributes</td><td>
- <a href="#EX-provenance-local-1">local</a>, <a href="#EX-provenance-global-3">global</a>
+ <a href="#EX-provenance-local-1">local</a>, <a href="#EX-provenance-global-1">global</a>
</td></tr><tr><td>
<a href="#externalresource">External Resource</a> (<code>external-resource</code>)
</td><td>No</td><td>Yes</td><td>No</td><td>Yes</td><td>None</td><td>None</td><td>
@@ -2030,7 +2024,7 @@
consumer tool may opt to include its domains "auto" and "medicine", but not
"law", since the extra training resources does not justify the improvement in the
output.</p></div></div></div><div class="div2">
-<h3><a href="#contents"><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="Disambiguation" id="Disambiguation"></a>8.10 Disambiguation</h3><span class="editor-note">[Ed. note: This data category is not completely stable yet.]</span><div class="div3">
+<h3><a href="#contents"><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="Disambiguation" id="Disambiguation"></a>8.10 Disambiguation</h3><div class="div3">
<h4><a href="#contents"><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="Disambiguation-definition" id="Disambiguation-definition"></a>8.10.1 Definition</h4><p>The <a href="#Disambiguation">Disambiguation</a> data category is used to
highlight (mark up) specific conceptual patterns that may require special treatment
when localizing and translating content.</p><p>This data category can be used for several purposes, including, but not limited
@@ -2215,7 +2209,7 @@
but it is recommended that an open provenance or change logging format be used, e.g. the W3C provenance data model <a title="" href="#prov-dm">[PROV-DM]</a>.</p></div><p>Translation or translation revision tools, such as machine translation engines or computer assisted translation
tools, may offer an easy way to create this information. Translation tools can then
present this information to post-editors or translation workflow managers. Web
- applications may to present such information to consumers of translated documents.</p><p>The data category defines seven pieces of information:</p><a name="provenanceDefs" id="provenanceDefs"></a><table border="1"><thead><tr><td>Information</td><td>Description</td><td>Value</td></tr></thead><tbody><tr><td>Human provenance information</td><td>Identification of a human translation agent</td><td>A string or an IRI (only for the <code>Ref</code> attributes)</td></tr><tr><td>Organisational provenance information</td><td>Identification of an organization acting as a translation agent</td><td>A string or an IRI (only for the <code>Ref</code> attributes)</td></tr><tr><td>Tool related provenance information</td><td>Identification of a software tool that was used in translating the selected content</td><td>A string or an IRI (only for the <code>Ref</code> attributes)</td></tr><tr><td>Human revision provenance information</td><td>Identification of a human translation revision agent</td><td>A string or a IRI (only for the <code>Ref</code> attributes)</td></tr><tr><td>Organisational revision provenance information</td><td>Identification of an organization acting as a translation revision agent</td><td>A string or an IRI (only for the <code>Ref</code> attributes)</td></tr><tr><td>Tool related revision provenance information</td><td>Identification of a software tool that was used in revising the translation of the selected content</td><td>A string or an IRI (only for the <code>Ref</code> attributes)</td></tr><tr><td>Reference to external provenance information</td><td>A reference to external provenance information</td><td>An IRI</td></tr></tbody></table></div><div class="div3">
+ applications may to present such information to consumers of translated documents.</p><p>The data category defines seven pieces of information:</p><a name="provenanceDefs" id="provenanceDefs"></a><table border="1"><thead><tr><td>Information</td><td>Description</td><td>Value</td></tr></thead><tbody><tr><td>Human provenance information</td><td>Identification of a human translation agent</td><td>A string or an IRI (only for the <code>Ref</code> attributes)</td></tr><tr><td>Organisational provenance information</td><td>Identification of an organization acting as a translation agent</td><td>A string or an IRI (only for the <code>Ref</code> attributes)</td></tr><tr><td>Tool related provenance information</td><td>Identification of a software tool that was used in translating the selected content</td><td>A string or an IRI (only for the <code>Ref</code> attributes)</td></tr><tr><td>Human revision provenance information</td><td>Identification of a human translation revision agent</td><td>A string or a IRI (only for the <code>Ref</code> attributes)</td></tr><tr><td>Organisational revision provenance information</td><td>Identification of an organization acting as a translation revision agent</td><td>A string or an IRI (only for the <code>Ref</code> attributes)</td></tr><tr><td>Tool related revision provenance information</td><td>Identification of a software tool that was used in revising the translation of the selected content</td><td>A string or an IRI (only for the <code>Ref</code> attributes)</td></tr><tr><td>Reference to external provenance information</td><td>A reference to external provenance information</td><td>A space (U+0020) separated list of IRIs</td></tr></tbody></table></div><div class="div3">
<h4><a href="#contents"><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="provenance-implementation" id="provenance-implementation"></a>8.12.2 Implementation</h4><p>The <a href="#provenance">Provenance</a> data category can be expressed with
global rules, or locally on individual elements. For elements, the data category
information <a href="#def-inheritance">inherits</a> to the textual content of
@@ -2223,7 +2217,7 @@
following:</p><ul><li><p>A required <code class="its-attr-markup">selector</code> attribute. It contains an <a href="#selectors">absolute selector</a> which selects the nodes to which
this rule applies.</p></li><li><p>A <code class="its-attr-markup">provenanceRecordsRefPointer</code> attribute that contains a <a href="#selectors">relative selector</a> pointing to a
node containing a list of <a href="#elem-provenanceRecords">provenance records</a>.
- These are related to the content selected via the <code class="its-attr-markup">selector</code> attribute.</p></li></ul><p>The global rule does not apply to HTML as local markup is provided for direct annotation in HTML.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-provenance-global-3" id="EX-provenance-global-3"></a>Example 63: The <a href="#provenance">Provenance</a> data category used globally with standoff provenance
+ These are related to the content selected via the <code class="its-attr-markup">selector</code> attribute.</p></li></ul><p>The global rule does not apply to HTML as local markup is provided for direct annotation in HTML.</p><div class="exampleOuter"><div class="exampleHeader"><a name="EX-provenance-global-1" id="EX-provenance-global-1"></a>Example 63: The <a href="#provenance">Provenance</a> data category used globally with standoff provenance
records.</div><p>This example expresses provenance information in a standoff manner using
<code>provenanceRecords</code> elements. The <code class="its-elem-markup">provRule</code> element specifies that for any element with a <code>ref</code> attribute, that
<code>ref</code> attribute holds a reference to an associated <code class="its-elem-markup">provenanceRecords</code> element where the provenance information is listed.
@@ -2250,7 +2244,7 @@
<span class="hl-attribute" style="color: #F5844C">revPerson</span>=<span class="hl-value" style="color: #993300">"John Smith"</span>
<span class="hl-attribute" style="color: #F5844C">revOrgRef</span>=<span class="hl-value" style="color: #993300">"http://john-smith.qa.example.com"</span><strong class="hl-tag" style="color: #000096">/></strong>
<strong class="hl-tag" style="color: #000096"></its:provenanceRecords></strong>
- <strong class="hl-tag" style="color: #000096"><its:rules></strong>
+ <strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><its:provRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//*[@ref]"</span> <span class="hl-attribute" style="color: #F5844C">provenanceRecordsRefPointer</span>=<span class="hl-value" style="color: #993300">"@ref"</span><strong class="hl-tag" style="color: #000096">/></strong>
<strong class="hl-tag" style="color: #000096"></its:rules></strong>
<strong class="hl-tag" style="color: #000096"><title></strong>Translation Revision Provenance Agent: Global Test in XML<strong class="hl-tag" style="color: #000096"></title></strong>
@@ -2259,7 +2253,7 @@
<strong class="hl-tag" style="color: #000096"><legalnotice</strong> <span class="hl-attribute" style="color: #F5844C">postediting-by</span>=<span class="hl-value" style="color: #993300">"http://www.vistatec.com/"</span> <span class="hl-attribute" style="color: #F5844C">ref</span>=<span class="hl-value" style="color: #993300">"#pr2"</span><strong class="hl-tag" style="color: #000096">></strong>This text was
translated directly by a person.<strong class="hl-tag" style="color: #000096"></legalnotice></strong>
<strong class="hl-tag" style="color: #000096"></body></strong>
-<strong class="hl-tag" style="color: #000096"></text></strong></pre></div><p>[Source file: <a href="examples/xml/EX-provenance-global-3.xml">examples/xml/EX-provenance-global-3.xml</a>]</p></div><p id="provenance-local">LOCAL: Using the inline markup to
+<strong class="hl-tag" style="color: #000096"></text></strong></pre></div><p>[Source file: <a href="examples/xml/EX-provenance-global-1.xml">examples/xml/EX-provenance-global-1.xml</a>]</p></div><p id="provenance-local">LOCAL: Using the inline markup to
represent the data category locally is limited to a single occurrence for a given
content (e.g. one cannot have different <code class="its-attr-markup">toolRef</code> attributes applied to
the same span of text because the inner-most one would override the others). A local
@@ -2284,7 +2278,7 @@
<span class="hl-attribute" style="color: #F5844C">its:org</span>=<span class="hl-value" style="color: #993300">"acme-CAT-v2.3"</span>
<span class="hl-attribute" style="color: #F5844C">its:revToolRef</span>=<span class="hl-value" style="color: #993300">"http://www.mycat.com/v1.0/download"</span>
<span class="hl-attribute" style="color: #F5844C">its:revOrg</span>=<span class="hl-value" style="color: #993300">"acme-CAT-v2.3"</span>
- <span class="hl-attribute" style="color: #F5844C">its:provRef</span>=<span class="hl-value" style="color: #993300">"http://www.examplelsp.com/excontent987/production/prov/e6354"</span><strong class="hl-tag" style="color: #000096">
+ <span class="hl-attribute" style="color: #F5844C">its:provRef</span>=<span class="hl-value" style="color: #993300">"http://www.example.lsp1.com/prov/e6354 http://www.example.lsp2.com/prov/e7738"</span><strong class="hl-tag" style="color: #000096">
></strong>This paragraph was translated from the machine.<strong class="hl-tag" style="color: #000096"></par></strong>
<strong class="hl-tag" style="color: #000096"><legalnotice</strong> <span class="hl-attribute" style="color: #F5844C">its:person</span>=<span class="hl-value" style="color: #993300">"John Doe"</span>
<span class="hl-attribute" style="color: #F5844C">its:orgRef</span>=<span class="hl-value" style="color: #993300">"http://www.legaltrans-ex.com/"</span>
@@ -2445,7 +2439,7 @@
<strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><its:translateRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"/file"</span> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"no"</span><strong class="hl-tag" style="color: #000096">/></strong>
<strong class="hl-tag" style="color: #000096"><its:translateRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//source"</span> <span class="hl-attribute" style="color: #F5844C">translate</span>=<span class="hl-value" style="color: #993300">"yes"</span><strong class="hl-tag" style="color: #000096">/></strong>
- <strong class="hl-tag" style="color: #000096"><its:targetPointerRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//source"</span> <span class="hl-attribute" style="color: #F5844C">targerPointer</span>=<span class="hl-value" style="color: #993300">"../target"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"><its:targetPointerRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//source"</span> <span class="hl-attribute" style="color: #F5844C">targetPointer</span>=<span class="hl-value" style="color: #993300">"../target"</span><strong class="hl-tag" style="color: #000096">/></strong>
<strong class="hl-tag" style="color: #000096"></its:rules></strong>
<strong class="hl-tag" style="color: #000096"><entry</strong> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">"one"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><source></strong>Remember last folder<strong class="hl-tag" style="color: #000096"></source></strong>
@@ -2458,28 +2452,27 @@
<strong class="hl-tag" style="color: #000096"></file></strong></pre></div><p>[Source file: <a href="examples/xml/EX-target-pointer-global-1.xml">examples/xml/EX-target-pointer-global-1.xml</a>]</p></div></div></div><div class="div2">
<h3><a href="#contents"><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="idvalue" id="idvalue"></a>8.15 Id Value</h3><div class="div3">
<h4><a href="#contents"><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="idvalue-definition" id="idvalue-definition"></a>8.15.1 Definition</h4><p>The <a href="#idvalue">Id Value</a> data category indicates a value that can be
- used as unique identifier for a given part of the content.</p><p>The recommended way to specify a unique identifier is to use <code>xml:id</code> (See
+ used as unique identifier for a given part of the content.</p><p>The recommended way to specify a unique identifier is to use <code>xml:id</code> or <code>id</code> in HTML (See
the best practice “<a href="http://www.w3.org/TR/2008/NOTE-xml-i18n-bp-20080213/#DevUniqueID">Defining
markup for unique identifiers</a>” from <a title="Best
 Practices for XML Internationalization" href="#xml-i18n-bp">[XML i18n BP]</a>). The <code class="its-elem-markup">idValueRule</code> element is intended only as a fall-back
mechanism for documents where unique identifiers are available with another
- construct.</p><p>Providing a unique identifier that is maintained in the original document can be use
+ construct.</p><p>Providing a unique identifier that is maintained in the original document can be useful
for several purposes, for example:</p><ul><li><p>Allow automated alignment between different versions of the source document,
or between source and translated documents.</p></li><li><p>Improve the confidence in leveraged translation for exact matches.</p></li><li><p>Provide back-tracking information between displayed text and source material
when testing or debugging.</p></li></ul><div class="note"><p class="prefix"><b>Note:</b></p><ul><li><p>The <a href="#idvalue">Id Value</a> data category only provides for
rules to be expressed at a global level. Locally, users are able to use
- <code>xml:id</code> (which is defined by XML) or an attribute specific to the
+ <code>xml:id</code> (which is defined by XML) or <code>id</code> in HTML, or an attribute specific to the
format in question (as in <a href="#EX-idvalue-attribute-1">Example 73</a>).</p></li><li><p>Applying the <a href="#idvalue">Id Value</a> data category to
- <code>xml:id</code> attributes using global rules is not necessary, since
- <code>xml:id</code> is the recommended way to specify an identifier in
- XML.</p></li></ul></div></div><div class="div3">
+ <code>xml:id</code> (in XML) or <code>id</code> (in HTML) attributes in global rules is not necessary, since
+ these attributes are the recommended way to specify an identifier.</p></li></ul></div></div><div class="div3">
<h4><a href="#contents"><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="idvalue-implementation" id="idvalue-implementation"></a>8.15.2 Implementation</h4><p>The <a href="#idvalue">id Value</a> data category can be expressed only with
global rules. There is no inheritance. There is no default.</p><p id="idvalue-global">GLOBAL: The <code class="its-elem-markup">idValueRule</code> element contains the
following:</p><ul><li><p>A required <code class="its-attr-markup">selector</code> attribute. It contains an <a href="#selectors">absolute selector</a> which selects the nodes to which this
rule applies.</p></li><li><p>A required <code class="its-attr-markup">idValue</code> attribute. It contains an XPath expression which
constructs a string corresponding to the identifier of the node to which this rule
applies. The identifier <a href="#rfc-keywords">MUST</a> be unique at least
- within the document. If the attribute <code>xml:id</code> is present for the
- selected node, the value of the <code>xml:id</code> attribute <a href="#rfc2119">MUST</a> take precedence over the <code class="its-attr-markup">idValue</code> value.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-idvalue-element-1" id="EX-idvalue-element-1"></a>Example 71: Pointing to an ID value with the <code class="its-elem-markup">idValueRule</code> element</div><p>The <code class="its-elem-markup">idValueRule</code> element indicates that the unique identifier for each
+ within the document. If the attribute <code>xml:id</code> is present or <code>id</code> in HTML for the
+ selected node, the value of the <code>xml:id</code> attribute or <code>id</code> in HTML <a href="#rfc2119">MUST</a> take precedence over the <code class="its-attr-markup">idValue</code> value.</p></li></ul><div class="exampleOuter"><div class="exampleHeader"><a name="EX-idvalue-element-1" id="EX-idvalue-element-1"></a>Example 71: Pointing to an ID value with the <code class="its-elem-markup">idValueRule</code> element</div><p>The <code class="its-elem-markup">idValueRule</code> element indicates that the unique identifier for each
<code><text></code> element is the value of the attribute <code>name</code> of
its parent element.</p><div class="exampleInner"><pre><span class="hl-directive" style="color: maroon"><?xml version="1.0"?></span>
<strong class="hl-tag" style="color: #000096"><resources></strong>
@@ -2537,7 +2530,7 @@
<h4><a href="#contents"><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="preservespace-definition" id="preservespace-definition"></a>8.16.1 Definition</h4><p>The <a href="#preservespace">Preserve Space</a> data category indicates how
whitespace should be handled in content. The possible values for this data category
are "default" and "preserve" and carry the same meaning as the corresponding values of
- the xml:space attribute. The default value is "default".</p></div><div class="div3">
+ the <a href="http://www.w3.org/TR/2008/REC-xml-20081126/#sec-white-space">xml:space</a> attribute. The default value is "default".</p></div><div class="div3">
<h4><a href="#contents"><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="preservespace-implementation" id="preservespace-implementation"></a>8.16.2 Implementation</h4><p>The <a href="#preservespace">Preserve Space</a> data category can be expressed
with global rules, or locally using the <code>xml:space</code> attribute. For elements,
the data category information <a href="#def-inheritance">inherits</a> to the
@@ -2552,7 +2545,7 @@
globally</div><p>The <code class="its-elem-markup">preserveSpaceRule</code> element specifies that whitespace in all verse
elements must be treated literally.</p><div class="exampleInner"><pre><strong class="hl-tag" style="color: #000096"><book></strong>
<strong class="hl-tag" style="color: #000096"><info></strong>
- <strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">its:version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><its:preserveSpaceRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//verse"</span> <span class="hl-attribute" style="color: #F5844C">space</span>=<span class="hl-value" style="color: #993300">"preserve"</span><strong class="hl-tag" style="color: #000096">/></strong>
<strong class="hl-tag" style="color: #000096"></its:rules></strong>
<strong class="hl-tag" style="color: #000096"></info></strong>
@@ -2592,7 +2585,7 @@
subsequent process examines this markup to ensure that changes were
made.</p></li></ul><p>The data category defines five pieces of information:</p><a name="lqissueDefs" id="lqissueDefs"></a><table border="1"><thead><tr><td>Information</td><td>Description</td><td>Value</td><td>Notes</td></tr></thead><tbody><tr><td>Type</td><td>A set of broad types of issues into which tool-specific issues can be
categorized.</td><td>One of the values defined in <a href="#lqissue-typevalues">list of type
- values</a>.</td><td>ITS 2.0-compliant tools that use these categories <a href="#rfc-keywords">MUST</a> map their internal values to these types. If the type of the issue
+ values</a>.</td><td>ITS 2.0-compliant tools that use these types <a href="#rfc-keywords">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">MUST</a> be specified as well.</td></tr><tr><td>Comment</td><td>A human-readable description of the quality issue.</td><td>Text</td><td/></tr><tr><td>Severity</td><td>A decimal value representing the severity of the issue, as defined by the
model generating the metadata.</td><td>A rational number in the interval 0 to 100 (inclusive). The value follows the
<a href="http://www.w3.org/TR/2004/REC-xmlschema-2-20041028/#decimal">XML Schema decimal data
@@ -2620,14 +2613,14 @@
<a href="#lqissueDefs">comment information</a>.</p></li></ul></li></ul></li><li><p>An optional <code class="its-attr-markup">locQualityIssueSeverity</code> attribute that implements the <a href="#lqissueDefs">severity
information</a>.</p></li><li><p>An optional <code class="its-attr-markup">locQualityIssueProfileRef</code> attribute that implements the <a href="#lqissueDefs">profile
reference information</a>.</p></li><li><p>An optional <code class="its-attr-markup">locQualityIssueEnabled</code> attribute that implements the <a href="#lqissueDefs">enabled
- information</a>.</p></li></ul><div class="note"><p class="prefix"><b>Note:</b></p><p>The attribute <code class="its-attr-markup">locQualityIssuesRefPointer</code>, do not apply to HTML as local markup is provided for direct annotation in HTML.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityIssue-global-1" id="EX-locQualityIssue-global-1"></a>Example 76: Annotating an issue in XML with <code class="its-elem-markup">locQualityIssueRule</code> element</div><p>The <code class="its-elem-markup">locQualityIssueRule</code> element associates the issue information with the
+ information</a>.</p></li></ul><div class="note"><p class="prefix"><b>Note:</b></p><p>The attribute <code class="its-attr-markup">locQualityIssuesRefPointer</code> does not apply to HTML as local markup is provided for direct annotation in HTML.</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityIssue-global-1" id="EX-locQualityIssue-global-1"></a>Example 76: Annotating an issue in XML with <code class="its-elem-markup">locQualityIssueRule</code> element</div><p>The <code class="its-elem-markup">locQualityIssueRule</code> element associates the issue information with the
value of the <code>text</code> attribute.</p><div class="exampleInner"><pre><span class="hl-directive" style="color: maroon"><?xml version="1.0"?></span>
<strong class="hl-tag" style="color: #000096"><doc></strong>
<strong class="hl-tag" style="color: #000096"><header></strong>
<strong class="hl-tag" style="color: #000096"><its:rules</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">version</span>=<span class="hl-value" style="color: #993300">"2.0"</span><strong class="hl-tag" style="color: #000096">></strong>
<strong class="hl-tag" style="color: #000096"><its:locQualityIssueRule</strong> <span class="hl-attribute" style="color: #F5844C">selector</span>=<span class="hl-value" style="color: #993300">"//image[@id='i1']/@text"</span>
<span class="hl-attribute" style="color: #F5844C">locQualityIssueType</span>=<span class="hl-value" style="color: #993300">"typographical"</span>
- <span class="hl-attribute" style="color: #F5844C">locQualitIssueComment</span>=<span class="hl-value" style="color: #993300">"Sentence without capitalization"</span>
+ <span class="hl-attribute" style="color: #F5844C">locQualityIssueComment</span>=<span class="hl-value" style="color: #993300">"Sentence without capitalization"</span>
<span class="hl-attribute" style="color: #F5844C">locQualityIssueSeverity</span>=<span class="hl-value" style="color: #993300">"50"</span><strong class="hl-tag" style="color: #000096">/></strong>
<strong class="hl-tag" style="color: #000096"></its:rules></strong>
<strong class="hl-tag" style="color: #000096"></header></strong>
@@ -3086,7 +3079,7 @@
<strong class="hl-tag" style="color: #000096"><body></strong>
<strong class="hl-tag" style="color: #000096"><p></strong>String to translate:<strong class="hl-tag" style="color: #000096"></p></strong>
<strong class="hl-tag" style="color: #000096"><p</strong> <span class="hl-attribute" style="color: #F5844C">contenteditable</span>=<span class="hl-value" style="color: #993300">true</span> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">123</span> <span class="hl-attribute" style="color: #F5844C">its-storage-size</span>=<span class="hl-value" style="color: #993300">25</span><strong class="hl-tag" style="color: #000096">></strong>Papua New-Guinea<strong class="hl-tag" style="color: #000096"></p></strong>
- <strong class="hl-tag" style="color: #000096"><p</strong> <span class="hl-attribute" style="color: #F5844C">contenteditable</span>=<span class="hl-value" style="color: #993300">true</span> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">139</span> <span class="hl-attribute" style="color: #F5844C">its-storage-size</span>=<span class="hl-value" style="color: #993300">25</span><strong class="hl-tag" style="color: #000096">></strong>Dominican Replubic<strong class="hl-tag" style="color: #000096"></p></strong>
+ <strong class="hl-tag" style="color: #000096"><p</strong> <span class="hl-attribute" style="color: #F5844C">contenteditable</span>=<span class="hl-value" style="color: #993300">true</span> <span class="hl-attribute" style="color: #F5844C">id</span>=<span class="hl-value" style="color: #993300">139</span> <span class="hl-attribute" style="color: #F5844C">its-storage-size</span>=<span class="hl-value" style="color: #993300">25</span><strong class="hl-tag" style="color: #000096">></strong>Dominican Republic<strong class="hl-tag" style="color: #000096"></p></strong>
<strong class="hl-tag" style="color: #000096"></body></strong>
<strong class="hl-tag" style="color: #000096"></html></strong></pre></div><p>[Source file: <a href="examples/html5/EX-storageSize-html5-local-1.html">examples/html5/EX-storageSize-html5-local-1.html</a>]</p></div></div></div></div></div><div class="back"><div class="div1">
<h2><a href="#contents"><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"></a>A References</h2><dl><dt class="label"><a name="bcp47" id="bcp47"/>BCP47</dt><dd>Addison Phillips, Mark Davis. <a href="http://www.rfc-editor.org/rfc/bcp/bcp47.txt"><cite>Tags for Identifying
@@ -3170,12 +3163,12 @@
<h2><a href="#contents"><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-typevalues" id="lqissue-typevalues"></a>C Values for the Localization Quality Issue Type</h2><p>The <code class="its-attr-markup">locQualityIssueType</code> attribute provides a basic level of interoperability
between different localization quality assurance systems. It offers a list of high-level
quality issue types common in automatic and human localization quality assessment. Tools
- can map their internal categories to these categories in order to exchange information
+ can map their internal types to these types in order to exchange information
about the kinds of issues they identify and take appropriate action even if another tool
does not know the specific issues identified by the generating tool.</p><p>The values listed in the following table are allowed for <code class="its-attr-markup">locQualityIssueType</code>.
The values a tool implementing the data category produces for the attribute <a href="#rfc-keywords">MUST</a> match one of the values provided in this table and
<a href="#rfc-keywords">MUST</a> be semantically accurate. If a tool can map its
- internal values to these categories it <a href="#rfc-keywords">MUST</a> do so and
+ internal values to these types it <a href="#rfc-keywords">MUST</a> do so and
<a href="#rfc-keywords">MUST NOT</a> use the value <code>other</code>, which is
reserved strictly for values that cannot be mapped to these values.</p><div class="note"><p class="prefix"><b>Note:</b></p><p id="qa-issue-types-tool-specific-mappings">The <a href="http://www.w3.org/International/its/ig/">ITS Interest Group</a> maintains an
informative mappings of tools to localization quality issue types. <a href="http://www.w3.org/International/its/wiki/Tool_specific_mappings">The ITS IG
@@ -3348,11 +3341,1937 @@
<h2><a href="#contents"><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-schemas" id="its-schemas"></a>D Schemas for ITS</h2><p>The following schemas define ITS elements and attributes and can be used as building
blocks when you want to integrate ITS markup into your own XML vocabulary. You can see
examples of such integration in <a href="http://www.w3.org/TR/xml-i18n-bp/">Best
- Practices for XML Internationalization</a>.</p><p>The following schemas are provided:</p><span class="editor-note">[Ed. note: Add more comments into schemas once they are stable]</span><ul><li><p>
- <a href="schemas/its20.rnc">RELAX NG compact syntax document for ITS</a>
- </p></li><li><p>
- <a href="schemas/its20.rng">RELAX NG XML syntax document for ITS</a>
- </p></li></ul></div><div class="div1">
+ Practices for XML Internationalization</a>.</p><p>The following schemas are provided:</p><span class="editor-note">[Ed. note: Add more comments into schemas once they are stable]</span><ul><li><p>The following <a title="Namespace-based Validation Dispatching Language
 (NVDL)" href="#nvdl">[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="its20.nvdl" id="its20.nvdl"></a>Example 96: NVDL schema for ITS</div><div class="exampleInner"><pre><span class="hl-directive" style="color: maroon"><?xml version="1.0" encoding="UTF-8"?></span>
+<strong class="hl-tag" style="color: #000096"><rules</strong> <span class="hl-attribute" style="color: #F5844C">xmlns</span>=<span class="hl-value" style="color: #993300">"http://purl.oclc.org/dsdl/nvdl/ns/structure/1.0"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><namespace</strong> <span class="hl-attribute" style="color: #F5844C">ns</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><validate</strong> <span class="hl-attribute" style="color: #F5844C">schema</span>=<span class="hl-value" style="color: #993300">"its20-elements.rng"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"></namespace></strong>
+ <strong class="hl-tag" style="color: #000096"><namespace</strong> <span class="hl-attribute" style="color: #F5844C">ns</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">match</span>=<span class="hl-value" style="color: #993300">"attributes"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><validate</strong> <span class="hl-attribute" style="color: #F5844C">schema</span>=<span class="hl-value" style="color: #993300">"its20-attributes.rng"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"></namespace></strong>
+ <strong class="hl-tag" style="color: #000096"><anyNamespace></strong>
+ <strong class="hl-tag" style="color: #000096"><allow/></strong>
+ <strong class="hl-tag" style="color: #000096"></anyNamespace></strong>
+<strong class="hl-tag" style="color: #000096"></rules></strong></pre></div><p>[Source file: <a href="schemas/its20.nvdl">schemas/its20.nvdl</a>]</p></div></li><li><p>The NVDL schema depends on the following two schemas:</p><ul><li><p><div class="exampleOuter"><div class="exampleHeader"><a name="its20-elements.rng" id="its20-elements.rng"></a>Example 97: RELAX NG schema for ITS elements</div><div class="exampleInner"><pre><span class="hl-directive" style="color: maroon"><?xml version="1.0" encoding="UTF-8"?></span>
+<strong class="hl-tag" style="color: #000096"><grammar</strong> <span class="hl-attribute" style="color: #F5844C">xmlns:a</span>=<span class="hl-value" style="color: #993300">"http://relaxng.org/ns/compatibility/annotations/1.0"</span> <span class="hl-attribute" style="color: #F5844C">xmlns</span>=<span class="hl-value" style="color: #993300">"http://relaxng.org/ns/structure/1.0"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><include</strong> <span class="hl-attribute" style="color: #F5844C">href</span>=<span class="hl-value" style="color: #993300">"its20.rng"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"><define</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-local.attributes"</span> <span class="hl-attribute" style="color: #F5844C">combine</span>=<span class="hl-value" style="color: #993300">"interleave"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><a:documentation></strong>enable all xml:* attributes<strong class="hl-tag" style="color: #000096"></a:documentation></strong>
+ <strong class="hl-tag" style="color: #000096"><zeroOrMore></strong>
+ <strong class="hl-tag" style="color: #000096"><attribute></strong>
+ <strong class="hl-tag" style="color: #000096"><nsName</strong> <span class="hl-attribute" style="color: #F5844C">ns</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/XML/1998/namespace"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"></attribute></strong>
+ <strong class="hl-tag" style="color: #000096"></zeroOrMore></strong>
+ <strong class="hl-tag" style="color: #000096"></define></strong>
+ <strong class="hl-tag" style="color: #000096"><define</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-local.nons.attributes"</span> <span class="hl-attribute" style="color: #F5844C">combine</span>=<span class="hl-value" style="color: #993300">"interleave"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><zeroOrMore></strong>
+ <strong class="hl-tag" style="color: #000096"><attribute></strong>
+ <strong class="hl-tag" style="color: #000096"><nsName</strong> <span class="hl-attribute" style="color: #F5844C">ns</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/XML/1998/namespace"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"></attribute></strong>
+ <strong class="hl-tag" style="color: #000096"></zeroOrMore></strong>
+ <strong class="hl-tag" style="color: #000096"></define></strong>
+ <strong class="hl-tag" style="color: #000096"><start></strong>
+ <strong class="hl-tag" style="color: #000096"><choice></strong>
+ <strong class="hl-tag" style="color: #000096"><ref</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-rules"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"><ref</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-span"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"><ref</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-ruby"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"><ref</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-standoff"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"></choice></strong>
+ <strong class="hl-tag" style="color: #000096"></start></strong>
+<strong class="hl-tag" style="color: #000096"></grammar></strong>
+</pre></div><p>[Source file: <a href="schemas/its20-elements.rng">schemas/its20-elements.rng</a>]</p><p>(<a href="schemas/its20-elements.rnc">RELAX NG compact syntax version of schema</a>)</p></div></p></li><li><p><div class="exampleOuter"><div class="exampleHeader"><a name="its20-attributes.rng" id="its20-attributes.rng"></a>Example 98: RELAX NG schema for all ITS local attributes</div><div class="exampleInner"><pre><span class="hl-directive" style="color: maroon"><?xml version="1.0" encoding="UTF-8"?></span>
+<strong class="hl-tag" style="color: #000096"><grammar</strong> <span class="hl-attribute" style="color: #F5844C">xmlns</span>=<span class="hl-value" style="color: #993300">"http://relaxng.org/ns/structure/1.0"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><include</strong> <span class="hl-attribute" style="color: #F5844C">href</span>=<span class="hl-value" style="color: #993300">"its20.rng"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"><start></strong>
+ <strong class="hl-tag" style="color: #000096"><group></strong>
+ <strong class="hl-tag" style="color: #000096"><optional></strong>
+ <strong class="hl-tag" style="color: #000096"><ref</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-local.attributes"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"></optional></strong>
+ <strong class="hl-tag" style="color: #000096"><optional></strong>
+ <strong class="hl-tag" style="color: #000096"><ref</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-attribute.version"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"></optional></strong>
+ <strong class="hl-tag" style="color: #000096"></group></strong>
+ <strong class="hl-tag" style="color: #000096"></start></strong>
+<strong class="hl-tag" style="color: #000096"></grammar></strong>
+</pre></div><p>[Source file: <a href="schemas/its20-attributes.rng">schemas/its20-attributes.rng</a>]</p><p>(<a href="schemas/its20-attributes.rnc">RELAX NG compact syntax version of schema</a>)</p></div></p></li></ul></li><li><p>All ITS elements and attributes referenced by previous two schemas are defined in
+ the base RELAX NG schema for ITS.
+ </p><div class="exampleOuter"><div class="exampleHeader"><a name="its20.rng" id="its20.rng"></a>Example 99: Base RELAX NG schema for ITS</div><div class="exampleInner"><pre><span class="hl-directive" style="color: maroon"><?xml version="1.0" encoding="UTF-8"?></span>
+<strong class="hl-tag" style="color: #000096"><grammar</strong> <span class="hl-attribute" style="color: #F5844C">ns</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:a</span>=<span class="hl-value" style="color: #993300">"http://relaxng.org/ns/compatibility/annotations/1.0"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:xlink</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/1999/xlink"</span> <span class="hl-attribute" style="color: #F5844C">xmlns:its</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2005/11/its"</span> <span class="hl-attribute" style="color: #F5844C">xmlns</span>=<span class="hl-value" style="color: #993300">"http://relaxng.org/ns/structure/1.0"</span> <span class="hl-attribute" style="color: #F5844C">datatypeLibrary</span>=<span class="hl-value" style="color: #993300">"http://www.w3.org/2001/XMLSchema-datatypes"</span><strong lass="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><include</strong> <span class="hl-attribute" style="color: #F5844C">href</span>=<span class="hl-value" style="color: #993300">"its20-types.rng"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"><define</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-attribute.translate"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><attribute</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its:translate"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><ref</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-translate.type"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"></attribute></strong>
+ <strong class="hl-tag" style="color: #000096"></define></strong>
+ <strong class="hl-tag" style="color: #000096"><define</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-attribute.translate.nons"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><attribute</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"translate"</span><strong class="hl-tag" style="color: #000096">></strong>
+ <strong class="hl-tag" style="color: #000096"><ref</strong> <span class="hl-attribute" style="color: #F5844C">name</span>=<span class="hl-value" style="color: #993300">"its-translate.type"</span><strong class="hl-tag" style="color: #000096">/></strong>
+ <strong class="hl-tag" style="color: #000096"></attribute></strong>
[1950 lines skipped]
Received on Friday, 30 November 2012 10:15:36 UTC