- From: Yves Savourel via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 22 Aug 2012 13:15:39 +0000
- To: public-multilingualweb-lt-commits@w3.org
Update of /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20
In directory hutz:/tmp/cvs-serv10146
Modified Files:
its20.html its20.odd
Log Message:
Continued implementation of loc quality.
Index: its20.odd
===================================================================
RCS file: /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd,v
retrieving revision 1.125
retrieving revision 1.126
diff -u -d -r1.125 -r1.126
--- its20.odd 22 Aug 2012 12:12:39 -0000 1.125
+++ its20.odd 22 Aug 2012 13:15:37 -0000 1.126
@@ -4483,12 +4483,41 @@
<egXML xmlns="http://www.tei-c.org/ns/Examples"
target="examples/xml/EX-locQualityIssue-local-1.xml" />
</exemplum>
- <exemplum xml:id="EX-locQualityIssue-html5-local">
+ <exemplum xml:id="EX-locQualityIssue-html5-local-1">
<head>Annotating an issue in HTML with local inline markup</head>
<p>In this example several spans of content are assocaited with a quality issue.</p>
<egXML xmlns="http://www.tei-c.org/ns/Examples"
- target="examples/html5/EX-locQualityIssue-html5-local.html" />
+ target="examples/html5/EX-locQualityIssue-html5-local-1.html" />
+ </exemplum>
+ <exemplum xml:id="EX-locQualityIssue-local-2">
+ <head>Annotating an issue in XML with local standoff markup</head>
+ <p>The following example shows a document using local standoff markup to encode several issues.
+ The <code>mrk</code> element delimits the content to markup and holds a <att>locQualityIssuesRef</att>
+ attribute that points to the <gi>locQualityIssues</gi> element where the issues are listed.</p>
+ <egXML xmlns="http://www.tei-c.org/ns/Examples"
+ target="examples/xml/EX-locQualityIssue-local-2.xml" />
+ </exemplum>
+ <exemplum xml:id="EX-locQualityIssue-local-3">
+ <head>Annotating an issue in XML with local standoff markup and a global rule</head>
+ <p>The following example shows a document using local standoff markup to encode several issues.
+ But because, in this case, the <code>mrk</code> element does not allow attributes from another
+ namespace we cannot use <att>locQualityIssuesRef</att> directly.
+ Instead, a global rule is used to map the function of <att>locQualityIssuesRef</att> to a non-ITS
+ construct, here the <code>ref</code> attribute of any <code>mrk</code> elements that has its attribute
+ <code>type</code> set to "x-itslq".</p>
+ <egXML xmlns="http://www.tei-c.org/ns/Examples"
+ target="examples/xml/EX-locQualityIssue-local-3.xml" />
</exemplum>
+ <exemplum xml:id="EX-locQualityIssue-html5-local-2">
+ <head>Annotating an issue in HTML with local standoff markup</head>
+ <p>The following example shows a document using local standoff markup to encode several issues.
+ The <code>span</code> element delimits the content to markup and holds a <att>loc-quality-issues-ref</att>
+ attribute that points to a special <code>span</code> element where the issues are listed within a set of
+ other special <code>span</code> elements.</p>
+ <egXML xmlns="http://www.tei-c.org/ns/Examples"
+ target="examples/html5/EX-locQualityIssue-html5-local-2.html" />
+ </exemplum>
+ <note type="ed">TODO for above: Finalize how HTML its-loc-quality-issues and its-loc-quality-issue should be defined.</note>
<p xml:id="lqissue-typevalues">Values for the Localization Quality Issue Type:</p>
<p>The <att>locQualityIssueType</att> attribute provides a basic level of interoperability between different localization quality
@@ -4787,6 +4816,7 @@
</div>
<div xml:id="lqissue-markup">
<head>Markup Declarations for Localization Quality Issue</head>
+ <note type="ed">TODO: update to proper declaration and add markup for HTML.</note>
<specGrp xml:id="spec-its-locqualitynote">
<elementSpec ident="locQualityIssueRule" ns="http://www.w3.org/2005/11/its">
<desc>Rule about the <ref target="#lqissue">Localization Quality Issue</ref> data category.</desc>
Index: its20.html
===================================================================
RCS file: /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html,v
retrieving revision 1.125
retrieving revision 1.126
diff -u -d -r1.125 -r1.126
--- its20.html 22 Aug 2012 12:12:39 -0000 1.125
+++ its20.html 22 Aug 2012 13:15:37 -0000 1.126
@@ -2413,7 +2413,7 @@
its:locQualityIssueType="typographical"
its:locQualityIssueComment="Sentence without capitalization"
its:locQualityIssueSeverity="50">this</span> is an example</para>
-</doc></pre></div><p>[Source file: <a href="examples/xml/EX-locQualityIssue-local-1.xml" shape="rect">examples/xml/EX-locQualityIssue-local-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityIssue-html5-local" id="EX-locQualityIssue-html5-local" shape="rect"/>Example 72: Annotating an issue in HTML with local inline markup</div><p>In this example several spans of content are assocaited with a quality issue.</p><div class="exampleInner"><pre xml:space="preserve">
+</doc></pre></div><p>[Source file: <a href="examples/xml/EX-locQualityIssue-local-1.xml" shape="rect">examples/xml/EX-locQualityIssue-local-1.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityIssue-html5-local-1" id="EX-locQualityIssue-html5-local-1" shape="rect"/>Example 72: Annotating an issue in HTML with local inline markup</div><p>In this example several spans of content are assocaited with a quality issue.</p><div class="exampleInner"><pre xml:space="preserve">
<html lang="en">
<head>
<title>Telharmonium 1897</title>
@@ -2490,7 +2490,79 @@
</span>
</p>
</body>
-</html></pre></div><p>[Source file: <a href="examples/html5/EX-locQualityIssue-html5-local.html" shape="rect">examples/html5/EX-locQualityIssue-html5-local.html</a>]</p></div><p id="lqissue-typevalues">Values for the Localization Quality Issue Type:</p><p>The <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueType</a> attribute provides a basic level of interoperability between different localization quality
+</html></pre></div><p>[Source file: <a href="examples/html5/EX-locQualityIssue-html5-local-1.html" shape="rect">examples/html5/EX-locQualityIssue-html5-local-1.html</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityIssue-local-2" id="EX-locQualityIssue-local-2" shape="rect"/>Example 73: Annotating an issue in XML with local standoff markup</div><p>The following example shows a document using local standoff markup to encode several issues.
+ The <code>mrk</code> element delimits the content to markup and holds a <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssuesRef</a>
+ attribute that points to the <a class="itsmarkup" href="#locQualityIssues" shape="rect">locQualityIssues</a> element where the issues are listed.</p><div class="exampleInner"><pre xml:space="preserve">
+<xliff
+ xmlns:its="http://www.w3.org/2005/11/its" version="1.2"
+ its:version="2.0">
+ <file original="example.doc" source-language="en" datatype="plaintext">
+ <body>
+ <trans-unit id="1">
+ <source xml:lang="en">This is the content</source>
+ <target xml:lang="fr">
+ <mrk mtype="x-itslq"
+ its:locQualityIssuesRef="#lq1">c'es</mrk>
+ le contenu</target>
+ <its:locQualityIssues xml:id="lq1">
+ <its:locQualityIssue locQualityIssueType="misspelling" locQualityIssueComment="'c'es' is unknown. Could be 'c'est'" locQualityIssueSeverity="50"/>
+ <its:locQualityIssue locQualityIssueType="typographical" locQualityIssueComment="Sentence without capitalization" locQualityIssueSeverity="30"/>
+ </its:locQualityIssues>
+ </trans-unit>
+ </body>
+ </file>
+</xliff></pre></div><p>[Source file: <a href="examples/xml/EX-locQualityIssue-local-2.xml" shape="rect">examples/xml/EX-locQualityIssue-local-2.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityIssue-local-3" id="EX-locQualityIssue-local-3" shape="rect"/>Example 74: Annotating an issue in XML with local standoff markup and a global rule</div><p>The following example shows a document using local standoff markup to encode several issues.
+ But because, in this case, the <code>mrk</code> element does not allow attributes from another
+ namespace we cannot use <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssuesRef</a> directly.
+ Instead, a global rule is used to map the function of <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssuesRef</a> to a non-ITS
+ construct, here the <code>ref</code> attribute of any <code>mrk</code> elements that has its attribute
+ <code>type</code> set to "x-itslq".</p><div class="exampleInner"><pre xml:space="preserve">
+<doc
+ xmlns:its="http://www.w3.org/2005/11/its"
+ its:version="2.0">
+ <file>
+ <header>
+ <its:rules>
+ <its:locQualityIssueRule selector="//mrk[@type='x-itslq']" locQualityIssuesRefPointer="@ref"/>
+ </its:rules>
+ </header>
+ <unit id="1">
+ <segment>
+ <source>This is the content</source>
+ <target>
+ <mrk type="x-itslq" ref="#lq1">c'es</mrk> le contenu</target>
+ </segment>
+ <its:locQualityIssues xml:id="lq1">
+ <its:locQualityIssue locQualityIssueType="misspelling" locQualityIssueComment="'c'es' is unknown. Could be 'c'est'" locQualityIssueSeverity="50"/>
+ <its:locQualityIssue locQualityIssueType="typographical" locQualityIssueComment="Sentence without capitalization" locQualityIssueSeverity="30"/>
+ </its:locQualityIssues>
+ </unit>
+ </file>
+</doc></pre></div><p>[Source file: <a href="examples/xml/EX-locQualityIssue-local-3.xml" shape="rect">examples/xml/EX-locQualityIssue-local-3.xml</a>]</p></div><div class="exampleOuter"><div class="exampleHeader"><a name="EX-locQualityIssue-html5-local-2" id="EX-locQualityIssue-html5-local-2" shape="rect"/>Example 75: Annotating an issue in HTML with local standoff markup</div><p>The following example shows a document using local standoff markup to encode several issues.
+ The <code>span</code> element delimits the content to markup and holds a <code>loc-quality-issues-ref</code>
+ attribute that points to a special <code>span</code> element where the issues are listed within a set of
+ other special <code>span</code> elements.</p><div class="exampleInner"><pre xml:space="preserve">
+<html lang="en">
+ <head>
+ <title>Example</title>
+ </head>
+ <body>
+ <p>
+ <span its-loc-quality-issues-ref="#lq1">c'es</span> le contenu</p>
+ <span its-loc-quality-issues="its-loc-quality-issues" id="lq1">
+ <span
+ its-loc-quality-issue="its-loc-quality-issue"
+ its-loc-quality-issue-type="misspelling"
+ its-loc-quality-issue-coment="'c'es' is unknown. Could be 'c'est'"
+ its-loc-quality-issue-severity="50"/>
+ <span
+ its-loc-quality-issue="its-loc-quality-issue"
+ its-loc-quality-issue-type="typographical"
+ its-loc-quality-issue-coment="Sentence without capitalization"
+ its-loc-quality-issue-severity="30"/>
+ </span>
+ </body>
+</html></pre></div><p>[Source file: <a href="examples/html5/EX-locQualityIssue-html5-local-2.html" shape="rect">examples/html5/EX-locQualityIssue-html5-local-2.html</a>]</p></div><span class="editor-note">[Ed. note: TODO for above: Finalize how HTML its-loc-quality-issues and its-loc-quality-issue should be defined.]</span><p id="lqissue-typevalues">Values for the Localization Quality Issue Type:</p><p>The <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueType</a> 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 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 <a class="itsmarkup" href="#locQualityIssueRule.attributes" shape="rect">locQualityIssueType</a>. The values a tool implementing the data category
@@ -2629,7 +2701,7 @@
may be assigned to another precise value, while other issues cannot.</p></li><li><p>If a system has an "miscellaneous" or "other" category, it <a href="#rfc-keywords" shape="rect">MUST</a> be mapped to this
value even if the specific instance of the issue might be mapped to another category.</p></li></ul>
</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="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>
+<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><span class="editor-note">[Ed. note: TODO: update to proper declaration and add markup for HTML.]</span><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,
@@ -2921,7 +2993,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="d3e9025" id="d3e9025" shape="rect"/>Example 73: Testing constraints in ITS markup</div><div class="exampleInner"><pre xml:space="preserve">
+ constraints.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d3e9108" id="d3e9108" shape="rect"/>Example 76: 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.
@@ -2988,7 +3060,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="d3e9047" id="d3e9047" shape="rect"/>Example 74: 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="d3e9130" id="d3e9130" shape="rect"/>Example 77: 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>
Received on Wednesday, 22 August 2012 13:15:45 UTC