- From: Eliot Graff via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 08 Oct 2010 19:27:37 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/html-xhtml-author-guide In directory hutz:/tmp/cvs-serv26767 Modified Files: html-xhtml-authoring-guide.html Log Message: Updated wording in Language Attributes per recommendations in bug 10152 Index: html-xhtml-authoring-guide.html =================================================================== RCS file: /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html,v retrieving revision 1.38 retrieving revision 1.39 diff -u -d -r1.38 -r1.39 --- html-xhtml-authoring-guide.html 8 Oct 2010 18:48:05 -0000 1.38 +++ html-xhtml-authoring-guide.html 8 Oct 2010 19:27:34 -0000 1.39 @@ -482,37 +482,35 @@ </style><link charset="utf-8" type="text/css" rel="stylesheet" href="html-xhtml-authoring-guide_files/W3C-ED.css"></head><body style="display: inherit;"><div class="head"><p><a href="http://www.w3.org/"><img src="html-xhtml-authoring-guide_files/w3c_home.png" alt="W3C" width="72" height="48"></a></p><h1 class="title" id="title">Polyglot Markup: HTML-Compatible XHTML Documents</h1><h2 id="w3c-editor-s-draft-08-october-2010">W3C Editor's Draft 08 October 2010</h2><dl><dt>This version:</dt><dd><a href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html">http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html</a></dd><dt>Latest published version:</dt><dd><a href="http://www.w3.org/TR/html-polyglot/">http://www.w3.org/TR/html-polyglot/</a></dd><dt>Latest editor's draft:</dt><dd><a href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html">http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html</a></dd><dt>Prvious version:</dt><dd><a href="http://www.w3.org/TR/2010/WD-html-polyglot-20100624/">http://www.w3.org/TR/2010/WD-html-polyglot-20100624/</a></dd><dt>Editor:</dt><dd><span>Eliot Graff</span>, Microsoft Corporation</dd> </dl><p class="copyright"><a href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 2010 <a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a><sup>®</sup> (<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>, <a href="http://www.ercim.eu/"><acronym title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>, <a href="http://www.keio.ac.jp/">Keio</a>), All Rights Reserved. W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>, <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a> and <a href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a> rules apply.</p><hr></div> -<div class="introductory section" id="abstract"><h2>Abstract</h2>A -document that uses polyglot markup is document that is a stream of bytes - that parses into identical document trees (with the exception of the -xmlns attribute on the root element) when processed as HTML and when -processed as XML. -Polyglot markup that meets a well defined set of constraints is -interpreted as compatible, regardless of whether they are processed as -HTML or as XHTML, per the HTML5 specification. -Polyglot markup uses a specific DOCTYPE, namespace declarations, and a -specific case—normally lower case but occasionally camel case—for -element and attribute names. -Polyglot markup uses lower case for certain attribute values. -Further constraints include those on empty elements, named entity -references, and the use of scripts and style. +<div class="introductory section" id="abstract"> +<h2>Abstract</h2> + A document that uses polyglot markup is document that is a stream of bytes that parses into identical document trees (with the exception of the + xmlns attribute on the root element) when processed as HTML and when processed as XML. + Polyglot markup that meets a well defined set of constraints is interpreted as compatible, regardless of whether they are processed as + HTML or as XHTML, per the HTML5 specification. + Polyglot markup uses a specific DOCTYPE, namespace declarations, and a specific case—normally lower case but occasionally camel case—for + element and attribute names. + Polyglot markup uses lower case for certain attribute values. + Further constraints include those on empty elements, named entity references, and the use of scripts and style. +</div> -</div><div id="sotd" class="introductory section"><h2>Status of This Document</h2><p><em>This - section describes the status of this document at the time of its -publication. Other documents may supersede this document. A list of -current W3C publications and the latest revision of this technical -report can be found in the <a href="http://www.w3.org/TR/">W3C technical reports index</a> at http://www.w3.org/TR/.</em></p> +<div id="sotd" class="introductory section"> +<h2>Status of This Document</h2> + <p><em> + This section describes the status of this document at the time of its publication. + Other documents may supersede this document. + A list of current W3C publications and the latest revision of this technical report can be found in the + <a href="http://www.w3.org/TR/">W3C technical reports index</a> at http://www.w3.org/TR/. + </em></p> <p> - This document summarizes design guidelines for authors who wish their -XHTML or HTML documents to validate on either HTML or XML parsers, -assuming the parsers to be HTML5-compliant. + This document summarizes design guidelines for authors who wish their XHTML or HTML documents to validate on either HTML or XML parsers, + assuming the parsers to be HTML5-compliant. This specification is intended to be used by web authors. - It is not a specification for user agents and creates no obligations -on user agents. - Note that this recommendation does not define how HTML5-conforming -user agents should process HTML documents. + It is not a specification for user agents and creates no obligations on user agents. + Note that this recommendation does not define how HTML5-conforming user agents should process HTML documents. Nor does it define the meaning of the Internet Media Type text/html. -For user agent guidance and for these definitions, see [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>] and [<cite><a href="#bib-RFC2854" rel="biblioentry" class="bibref">RFC2854</a></cite>]. + For user agent guidance and for these definitions, see [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>] + and [<cite><a href="#bib-RFC2854" rel="biblioentry" class="bibref">RFC2854</a></cite>]. </p> <p> This document was published by the <a href="http://www.w3.org/html/wg/">HTML working group</a> as an Editor's Draft. @@ -521,13 +519,83 @@ All feedback is welcome.</p> <p> Publication as a Editor's 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. + 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="" rel="disclosure">public list of any patent disclosures</a> - made in connection with the deliverables of the group; that page also -includes instructions for disclosing a patent. An individual who has -actual knowledge of a patent which the individual believes contains <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#def-essential">Essential Claim(s)</a> must disclose the information in accordance with <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">section 6 of the W3C Patent Policy</a>.</p></div><div class="section" id="toc"><h2 class="introductory">Table of Contents</h2><ul class="toc"><li class="tocline"><a class="tocxref" href="#introduction"><span class="secno">1. </span>Introduction</a></li><li class="tocline"><a class="tocxref" href="#PI-and-xml"><span class="secno">2. </span>Processing Instructions and the XML Declaration</a></li><li class="tocline"><a class="tocxref" href="#character-encoding"><span class="secno">3. </span>Specifying a Document's Character Encoding</a></li><li class="tocline"><a class="tocxref" href="#doctype"><span class="secno">4. </span>The DOCTYPE</a></li><li class="tocline"><a class="tocxref" href="#namespaces"><span class="secno"5. </span>Namespaces</a><ul class="toc"><li class="tocline"><a class="tocxref" href="#element-level-namespaces"><span class="secno">5.1 </span>Element-Level Namespaces</a></li><li class="tocline"><a class="tocxref" href="#attribute-level-namespaces"><span class="secno">5.2 </span>Attribute-Level Namespaces</a></li></ul></li><li class="tocline"><a class="tocxref" href="#elements"><span class="secno">6. </span>Elements</a><ul class="toc"><li class="tocline"><a class="tocxref" href="#required-elements"><span class="secno">6.1 </span>Required Elements</a></li><li class="tocline"><a class="tocxref" href="#elements-that-cannot-be-used"><span class="secno">6.2 </span>Elements that Cannot Be Used in Polyglot Markup</a></li><li class="tocline"><a class="tocxref" href="#case-sensitivity"><span class="secno">6.3 </span>Case-Sensitivity</a><ul class="toc"><li class="tocline"><a class="tocxref" href="#element-names"><span class="secno">6.3.1 </span>Element Names</a></li><li class="tocline"><a class="tocxref" href="#attrbute-names"><span class="secno">6.3.2 </span>Attribute Names</a></li><li class="tocline"><a class="tocxref" href="#attribute-values"><span class="secno">6.3.3 </span>Attribute Values</a></li></ul></li><li class="tocline"><a class="tocxref" href="#empty-elements"><span class="secno">6.4 </span>Empty Elements</a></li><li class="tocline"><a class="tocxref" href="#elements-with-soecial-considerations"><span class="secno">6.5 </span>Elements with Special Considerations</a><ul class="toc"><li class="tocline"><a class="tocxref" href="#white-space-in-textarea-and-pre"><span class="secno">6.5.1 </span>White Space in <code><textarea></code> and <code><pre></code> Elements</a></li></ul></li></ul></li><li class="tocline"><a class="tocxref" href="#attributes"><span class="secno">7. </span>Attributes</a><ul class="toc"><li class="tocline"><a class="tocxref" href="#disallowed-attributes"><span class="secno">7.1 </span>Disallowed Attributes</a></li><li class="tocline"><a class="tocxref" href="#language-attributs"><span class="secno">7.2 </span>Language Attributes</a></li></ul></li><li class="tocline"><a class="tocxref" href="#named-entity-references"><span class="secno">8. </span>Named Entity References</a></li><li class="tocline"><a class="tocxref" href="#script-and-style"><span class="secno">9. </span>Script and Style</a><ul class="toc"><li class="tocline"><a class="tocxref" href="#external-script-and-style"><span class="secno">9.1 </span>External Script and Style</a></li><li class="tocline"><a class="tocxref" href="#in-line-script-and-style"><span class="secno">9.2 </span>In-line Script and Style</a><ul class="toc"><li class="tocline"><a class="tocxref" href="#safe-content"><span class="secno">9.2.1 </span>Safe Content</a></li><li class="tocline"><a class="tocxref" href="#wrapping-in-cdata"><span class="secno">9.2.2 </span>Wrapping a Command in a CDATA Section</a></li></ul></li></ul></li><li class="tocline"><a class="tocxref" href="#foreign-content"><span class="secno">10. </span>Exceptions from the Foreign Cotent Parsing Rules</a></li><li class="tocline"><a class="tocxref" href="#acknowledgements"><span class="secno">A. </span>Acknowledgements</a></li><li class="tocline"><a class="tocxref" href="#references"><span class="secno">B. </span>References</a><ul class="toc"><li class="tocline"><a class="tocxref" href="#normative-references"><span class="secno">B.1 </span>Normative references</a></li><li class="tocline"><a class="tocxref" href="#informative-references"><span class="secno">B.2 </span>Informative references</a></li></ul></li></ul></div> + <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="" rel="disclosure">public list of any patent disclosures</a> made in connection with the deliverables of the group; + that page also includes instructions for disclosing a patent. + An individual who has actual knowledge of a patent which the individual believes contains + <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#def-essential">Essential Claim(s)</a> must disclose the information + in accordance with <a href="http://www.w3.org/Consortium/Patent-Policy-20040205/#sec-Disclosure">section 6 of the W3C Patent Policy</a>. + </p> +</div> +<div class="section" id="toc"> +<h2 class="introductory">Table of Contents</h2> + <ul class="toc"> + <li class="tocline"><a class="tocxref" href="#introduction"><span class="secno">1. </span>Introduction</a></li> + <li class="tocline"><a class="tocxref" href="#PI-and-xml"><span class="secno">2. </span>Processing Instructions and the XML Declaration</a></li> + <li class="tocline"><a class="tocxref" href="#character-encoding"><span class="secno">3. </span>Specifying a Document's Character Encoding</a></li> + <li class="tocline"><a class="tocxref" href="#doctype"><span class="secno">4. </span>The DOCTYPE</a></li> + <li class="tocline"><a class="tocxref" href="#namespaces"><span class="secno">5. </span>Namespaces</a> + <ul class="toc"> + <li class="tocline"><a class="tocxref" href="#element-level-namespaces"><span class="secno">5.1 </span>Element-Level Namespaces</a></li> + <li class="tocline"><a class="tocxref" href="#attribute-level-namespaces"><span class="secno">5.2 </span>Attribute-Level Namespaces</a></li> + </ul> + </li> + <li class="tocline"><a class="tocxref" href="#elements"><span class="secno">6. </span>Elements</a> + <ul class="toc"> + <li class="tocline"><a class="tocxref" href="#required-elements"><span class="secno">6.1 </span>Required Elements</a></li> + <li class="tocline"><a class="tocxref" href="#elements-that-cannot-be-used"><span class="secno">6.2 </span> + Elements that Cannot Be Used in Polyglot Markup</a></li> + <li class="tocline"><a class="tocxref" href="#case-sensitivity"><span class="secno">6.3 </span>Case-Sensitivity</a> + <ul class="toc"> + <li class="tocline"><a class="tocxref" href="#element-names"><span class="secno">6.3.1 </span>Element Names</a></li> + <li class="tocline"><a class="tocxref" href="#attribute-names"><span class="secno">6.3.2 </span>Attribute Names</a></li> + <li class="tocline"><a class="tocxref" href="#attribute-values"><span class="secno">6.3.3 </span>Attribute Values</a></li> + </ul> + </li> + <li class="tocline"><a class="tocxref" href="#empty-elements"><span class="secno">6.4 </span>Empty Elements</a></li> + <li class="tocline"><a class="tocxref" href="#elements-with-soecial-considerations"><span class="secno">6.5 </span> + Elements with Special Considerations</a> + <ul class="toc"> + <li class="tocline"><a class="tocxref" href="#white-space-in-textarea-and-pre"><span class="secno">6.5.1 </span> + White Space in <code><textarea></code> and <code><pre></code> Elements</a></li> + </ul> + </li> + </ul> + </li> + <li class="tocline"><a class="tocxref" href="#attributes"><span class="secno">7. </span>Attributes</a> + <ul class="toc"> + <li class="tocline"><a class="tocxref" href="#disallowed-attributes"><span class="secno">7.1 </span>Disallowed Attributes</a></li> + <li class="tocline"><a class="tocxref" href="#language-attributes"><span class="secno">7.2 </span>Language Attributes</a></li> + </ul> + </li> + <li class="tocline"><a class="tocxref" href="#named-entity-references"><span class="secno">8. </span>Named Entity References</a></li> + <li class="tocline"><a class="tocxref" href="#script-and-style"><span class="secno">9. </span>Script and Style</a> + <ul class="toc"> + <li class="tocline"><a class="tocxref" href="#external-script-and-style"><span class="secno">9.1 </span>External Script and Style</a></li> + <li class="tocline"><a class="tocxref" href="#in-line-script-and-style"><span class="secno">9.2 </span>In-line Script and Style</a> + <ul class="toc"> + <li class="tocline"><a class="tocxref" href="#safe-content"><span class="secno">9.2.1 </span>Safe Content</a></li> + <li class="tocline"><a class="tocxref" href="#wrapping-in-cdata"><span class="secno">9.2.2 </span> + Wrapping a Command in a CDATA Section</a></li> + </ul> + </li> + </ul> + </li> + <li class="tocline"><a class="tocxref" href="#foreign-content"><span class="secno">10. </span>Exceptions from the Foreign Content Parsing Rules</a></li> + <li class="tocline"><a class="tocxref" href="#acknowledgements"><span class="secno">A. </span>Acknowledgements</a></li> + <li class="tocline"><a class="tocxref" href="#references"><span class="secno">B. </span>References</a> + <ul class="toc"> + <li class="tocline"><a class="tocxref" href="#normative-references"><span class="secno">B.1 </span>Normative references</a></li> + <li class="tocline"><a class="tocxref" href="#informative-references"><span class="secno">B.2 </span>Informative references</a></li> + </ul> + </li> + </ul> +</div> @@ -988,14 +1056,9 @@ <div id="language-attributes" class="section"> <h3><span class="secno">7.2 </span>Language Attributes</h3> - <p>Polyglot markup <em title="should" class="rfc2119">should</em> use the language attributes in the <code>html</code> element to set the default language for the document.</p> <p>When using language attributes, polyglot markup <em title="must" class="rfc2119">must</em> use both the <code>lang</code> and <code>xml:lang</code> attributes. - Neither attribute is to be used without the other.</p> - <!-- TODO Need to verify that XML ignores this - - <p>Note that polyglot markup does not use the meta <code>Content-Language</code> element, as this element has no effect in XML for setting the language of content.</p> - - --> + Neither attribute is to be used without the other, and the values for both <code>lang</code> and <code>xml:lang</code> <em title="must" class="rfc2119">must</em> be the same.</p> + <p>Polyglot markup <em title="should" class="rfc2119">should</em> use the language attributes in the <code>html</code> element to set the default language for the document.</p> </div> </div>
Received on Friday, 8 October 2010 19:27:39 UTC