- From: Jirka Kozek via cvs-syncmail <cvsmail@w3.org>
- Date: Thu, 11 Oct 2012 19:57:56 +0000
- To: public-multilingualweb-lt-commits@w3.org
Update of /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20
In directory hutz:/tmp/cvs-serv18140
Modified Files:
its20.html its20.odd
Log Message:
Added section "Using ITS Markup in HTML5"
Index: its20.odd
===================================================================
RCS file: /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.odd,v
retrieving revision 1.179
retrieving revision 1.180
diff -u -d -r1.179 -r1.180
--- its20.odd 11 Oct 2012 03:09:26 -0000 1.179
+++ its20.odd 11 Oct 2012 19:57:54 -0000 1.180
@@ -4483,14 +4483,38 @@
<div xml:id="html5-local-attributes">
<head>Mapping of Local Data Categories to HTML5</head>
- <note type="ed">camelCase -> its-*; special mapping of @lang, @translate and @dir</note>
- <note type="ed">Case sensitivity</note>
+ <p>All data categories defined in <ptr target="#datacategory-description" type="specref"/>
+ and having local implementation might be used in HTML with the exception of <ref target="#trans-datacat" type="specref">Translate</ref>,
+ <ref target="#directionality" type="specref">Directionality</ref>, <ref target="#ruby-annotation" type="specref">Ruby</ref>,
+ and <ref target="#language-information" type="specref">Language Information</ref> data categories.</p>
+ <note>
+ <p>Above mentioned data categories are excluded because HTML have native markup for them.</p>
+ </note>
+ <p>In HTML data categories are implemented as attributes. Name of HTML attribute is derived from
+ the name of attribute defined in the local implementation by using the following
+ rules:<list type="ordered">
+ <item>Attribute name is prefixed with <code>its-</code></item>
+ <item>Each uppercase letter in the attribute name is replaced by <code>-</code>
+ (U+002D) followed by a lowercase variant of the letter.</item>
+ </list></p>
+ <p>Values of attributes which corresponds to data categories with a predefined set of values
+ MUST be matched case-insensitively. </p>
+ <note><p>Case of attribute names is also irrelevant given the nature of HTML syntax. So in HTML
+ terminology data category can be stored as <att>its-term</att>, <att>ITS-TERM</att>,
+ <att>its-Term</att> etc. All those attributes are treated as equivalent and will
+ gets normalized upon DOM construction.</p></note>
</div>
<div>
- <head>Inline Global Rules in HTML5</head>
- <note type="ed">Constraints on using rules inside script</note>
- </div>
+ <head>Inline Global Rules in HTML5</head>
+ <p>Inline global rules MUST be specified inside <gi>script</gi> which has <att>type</att>
+ attribute with the value <code>application/xml</code> or <code>application/its+xml</code>.
+ The <gi>script</gi> element itself MUST be child of <gi>head</gi> element. Comments MUST
+ NOT be used inside global rules. Each <gi>script</gi> element MUST NOT contain more then
+ one <gi>rules</gi> element.</p>
+ <note><p>It is preferred to use external global rules linked using <gi>link</gi>
+ element.</p></note>
+ </div>
</div>
@@ -5220,6 +5244,7 @@
target="http://www.w3.org/TR/2012/WD-its20-20120829/">ITS 2.0 Working Draft
29 August 2012</ref>.</p>
<list type="ordered">
+ <item>Added separate section about HTML5 implementation of ITS.</item>
<item>Removed inline markup declarations</item>
<item>Added informative appendix mapping <att>locQualityIssueType</att> values
to tool-specific issue types</item>
Index: its20.html
===================================================================
RCS file: /w3ccvs/WWW/International/multilingualweb/lt/drafts/its20/its20.html,v
retrieving revision 1.182
retrieving revision 1.183
diff -u -d -r1.182 -r1.183
--- its20.html 11 Oct 2012 03:09:26 -0000 1.182
+++ its20.html 11 Oct 2012 19:57:54 -0000 1.183
@@ -125,7 +125,7 @@
</div>
</div>
<div class="toc1">7 <a href="#html5-markup" shape="rect">Using ITS Markup in HTML5</a><div class="toc2">7.1 <a href="#html5-local-attributes" shape="rect">Mapping of Local Data Categories to HTML5</a></div>
-<div class="toc2">7.2 <a href="#d3e7595" shape="rect">Inline Global Rules in HTML5</a></div>
+<div class="toc2">7.2 <a href="#d3e7637" shape="rect">Inline Global Rules in HTML5</a></div>
</div>
<div class="toc1">8 <a href="#xhtml5-markup" shape="rect">Using ITS Markup in XHTML</a></div>
</div>
@@ -3242,8 +3242,24 @@
</body>
</html></pre></div><p>[Source file: <a href="examples/html5/EX-storageSize-html5-local-1.html" shape="rect">examples/html5/EX-storageSize-html5-local-1.html</a>]</p></div></div></div></div><div class="div1">
<h2><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="html5-markup" id="html5-markup" shape="rect"/>7 Using ITS Markup in HTML5</h2><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="html5-local-attributes" id="html5-local-attributes" shape="rect"/>7.1 Mapping of Local Data Categories to HTML5</h3><span class="editor-note">[Ed. note: camelCase -> its-*; special mapping of @lang, @translate and @dir]</span><span class="editor-note">[Ed. note: Case sensitivity]</span></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="d3e7595" id="d3e7595" shape="rect"/>7.2 Inline Global Rules in HTML5</h3><span class="editor-note">[Ed. note: Constraints on using rules inside script]</span></div></div><div class="div1">
+<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="html5-local-attributes" id="html5-local-attributes" shape="rect"/>7.1 Mapping of Local Data Categories to HTML5</h3><p>All data categories defined in <a class="section-ref" href="#datacategory-description" shape="rect">Section 6: Description of Data Categories</a>
+ and having local implementation might be used in HTML with the exception of <a href="#trans-datacat" shape="rect">Translate</a>,
+ <a href="#directionality" shape="rect">Directionality</a>, <a href="#ruby-annotation" shape="rect">Ruby</a>,
+ and <a href="#language-information" shape="rect">Language Information</a> data categories.</p><div class="note"><p class="prefix"><b>Note:</b></p><p>Above mentioned data categories are excluded because HTML have native markup for them.</p></div><p>In HTML data categories are implemented as attributes. Name of HTML attribute is derived from
+ the name of attribute defined in the local implementation by using the following
+ rules:</p><ol class="depth1"><li><p>Attribute name is prefixed with <code>its-</code></p></li><li><p>Each uppercase letter in the attribute name is replaced by <code>-</code>
+ (U+002D) followed by a lowercase variant of the letter.</p></li></ol><p>
+ </p><p>Values of attributes which corresponds to data categories with a predefined set of values
+ MUST be matched case-insensitively. </p><div class="note"><p class="prefix"><b>Note:</b></p><p>Case of attribute names is also irrelevant given the nature of HTML syntax. So in HTML
+ terminology data category can be stored as <code>its-term</code>, <code>ITS-TERM</code>,
+ <code>its-Term</code> etc. All those attributes are treated as equivalent and will
+ gets normalized upon DOM construction.</p></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="d3e7637" id="d3e7637" shape="rect"/>7.2 Inline Global Rules in HTML5</h3><p>Inline global rules MUST be specified inside <code>script</code> which has <code>type</code>
+ attribute with the value <code>application/xml</code> or <code>application/its+xml</code>.
+ The <code>script</code> element itself MUST be child of <code>head</code> element. Comments MUST
+ NOT be used inside global rules. Each <code>script</code> element MUST NOT contain more then
+ one <code>rules</code> element.</p><div class="note"><p class="prefix"><b>Note:</b></p><p>It is preferred to use external global rules linked using <code>link</code>
+ element.</p></div></div></div><div class="div1">
<h2><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="xhtml5-markup" id="xhtml5-markup" shape="rect"/>8 Using ITS Markup in XHTML</h2><span class="editor-note">[Ed. note: Guidance about using camelCase/its-camel-case w/respect to DOM representation and consistency with HTML parsing]</span><span class="editor-note">[Ed. note: Guidance about inline global rules]</span></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">
@@ -3579,7 +3595,7 @@
<em>This section is informative.</em>
</p><p>Several constraints of ITS markup cannot be validated with ITS schemas. The
following <a title="Rule-based validation
							-- Schematron" href="#schematron" shape="rect">[Schematron]</a> document allows for
- validating some of these constraints.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d3e8588" id="d3e8588" shape="rect"/>Example 94: Testing constraints in ITS markup</div><div class="exampleInner"><pre xml:space="preserve">
+ validating some of these constraints.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d3e8660" id="d3e8660" shape="rect"/>Example 94: 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.
@@ -3647,7 +3663,7 @@
</p><p>The following <a title="Namespace-based Validation
							Dispatching Language (NVDL)" href="#nvdl" shape="rect">[NVDL]</a> document allows validation of
ITS markup which has been added to a host vocabulary. Only ITS elements and
attributes are checked. Elements and attributes of host language are ignored
- during validation against this NVDL document/schema.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d3e8610" id="d3e8610" shape="rect"/>Example 95: NVDL schema for ITS</div><div class="exampleInner"><pre xml:space="preserve">
+ during validation against this NVDL document/schema.</p><div class="exampleOuter"><div class="exampleHeader"><a name="d3e8682" id="d3e8682" shape="rect"/>Example 95: NVDL schema for ITS</div><div class="exampleInner"><pre xml:space="preserve">
<nvdl:rules
xmlns:nvdl="http://purl.oclc.org/dsdl/nvdl/ns/structure/1.0" >
<nvdl:namespace ns="http://www.w3.org/2005/11/its">
@@ -3666,7 +3682,7 @@
</p></li></ul></div><div class="div1">
<h2><a href="#contents" shape="rect"><img src="images/topOfPage.gif" align="right" height="26" width="26" title="Go to the table of contents." alt="Go to the table of contents."/></a><a name="revisionlog" id="revisionlog" shape="rect"/>G Revision Log (Non-Normative)</h2><p id="changelog-since-20120829">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-20120829/" shape="rect">ITS 2.0 Working Draft
- 29 August 2012</a>.</p><ol class="depth1"><li><p>Removed inline markup declarations</p></li><li><p>Added informative appendix mapping <code>locQualityIssueType</code> values
+ 29 August 2012</a>.</p><ol class="depth1"><li><p>Added separate section about HTML5 implementation of ITS.</p></li><li><p>Removed inline markup declarations</p></li><li><p>Added informative appendix mapping <code>locQualityIssueType</code> values
to tool-specific issue types</p></li><li><p>Addition of a <code>locQualityPrecisVote</code> attribute and a
<code>locQualityPrecisVotePointer</code> attribute to <a class="section-ref" href="#lqprecis" shape="rect">Section 6.19: Localization Quality Précis</a>.</p></li><li><p>A <a href="#its-information_versus_content" shape="rect">clarification</a> of ITS
data category information and processing of content in <a class="section-ref" href="#datacategories-defaults-etc" shape="rect">Section 6.1: Position, Defaults, Inheritance and Overriding of Data Categories</a>.</p></li><li><p>Added <a class="section-ref" href="#allowedchars" shape="rect">Section 6.21: Allowed Characters</a>.</p></li><li><p>Added <a class="section-ref" href="#storagesize" shape="rect">Section 6.22: Storage Size</a>.</p></li><li><p>Added <a class="section-ref" href="#mtconfidence" shape="rect">Section 6.20: MT Confidence</a>.</p></li><li><p>Added <a href="#qa-issue-types-tool-specific-mappings" shape="rect">a note</a>
Received on Thursday, 11 October 2012 19:57:58 UTC