W3C home > Mailing lists > Public > public-multilingualweb-lt-commits@w3.org > October 2012

its20 CVS commit

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
Message-Id: <E1TMOtI-0004kR-H1@lionel-hutz.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 @@
   &lt;/body&gt;
  &lt;/html&gt;</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 -&gt; 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&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&#x9;&#x9;-- 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">
 &lt;sch:schema
   xmlns:sch="http://www.ascc.net/xml/schematron" &gt;
 &lt;!-- Schematron document to test constraints for global and local ITS markup.
@@ -3647,7 +3663,7 @@
          </p><p>The following <a title="Namespace-based Validation&#xA;&#x9;&#x9;&#x9;&#x9;&#x9;&#x9;&#x9;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">
 &lt;nvdl:rules
   xmlns:nvdl="http://purl.oclc.org/dsdl/nvdl/ns/structure/1.0" &gt;
  &lt;nvdl:namespace ns="http://www.w3.org/2005/11/its"&gt;
@@ -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

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 16:32:38 UTC