- From: Eliot Graff via cvs-syncmail <cvsmail@w3.org>
- Date: Fri, 29 Oct 2010 20:34:46 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/html-xhtml-author-guide
In directory hutz:/tmp/cvs-serv1677
Modified Files:
html-xhtml-authoring-guide.html
Log Message:
Edited 6.3.3 per bug 10167; changed paragraph in section 3, per bug 11055; fixed typo per bug 11058; added guidance about <plaintext> and <xmp> in new section 6.5.2;
Index: html-xhtml-authoring-guide.html
===================================================================
RCS file: /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html,v
retrieving revision 1.42
retrieving revision 1.43
diff -u -d -r1.42 -r1.43
--- html-xhtml-authoring-guide.html 25 Oct 2010 20:55:16 -0000 1.42
+++ html-xhtml-authoring-guide.html 29 Oct 2010 20:34:44 -0000 1.43
@@ -485,17 +485,20 @@
pre.sh_sourceCode .sh_attribute { color: #006400; }
</style>
+
<link type="text/css" rel="stylesheet" href="html-xhtml-authoring-guide_files/W3C-ED.css"/>
<link rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/W3C-ED"/>
</head>
<body style="display: inherit;">
-<div class="head">
-<p><a href="http://www.w3.org/"><img height="48" width="72" alt="W3C" src="http://www.w3.org/Icons/w3c_home"/></a></p>
-<h1 class="title" id="title">Polyglot Markup: HTML-Compatible XHTML Documents</h1><h2 id="w3c-editor-s-draft-25-october-2010">W3C Editor's Draft 25 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>Previous 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>
+<div class="head">
+ <p>
+ <a href="http://www.w3.org/"><img height="48" width="72" alt="W3C" src="http://www.w3.org/Icons/w3c_home"/></a>
+ </p>
+<h1 class="title" id="title">Polyglot Markup: HTML-Compatible XHTML Documents</h1>
+<h2 id="w3c-editor-s-draft-30-october-2010">W3C Editor's Draft 30 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>Previous 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/"><abbr title="World Wide Web Consortium">W3C</abbr></a><sup>®</sup>
@@ -505,7 +508,7 @@
<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/>
+ <hr/>
</div>
<div class="introductory section" id="abstract"><h2>Abstract</h2>
@@ -552,17 +555,17 @@
<a href="http://lists.w3.org/Archives/Public/public-html/">archives</a>) and arrangements will be made to transpose the comments to the bug database.
All feedback is welcome.</p>
<!--End of Status of This Document-->
-<p>Publication
- as a Editor's Draft does not imply endorsement by the W3C Membership.
+<p>Publication as an 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.</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/40318/status" rel="disclosure">public list of any patent disclosures</a>
+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/40318/status" 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>
-<h2 class="introductory">Table of Contents</h2>
+<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>
@@ -592,6 +595,9 @@
<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>
+ <li class="tocline"><a class="tocxref" href="#elements-that-cannot-contain-special-characters"><span class="secno">6.5.2 </span>
+ Elements that Cannot Contain Special Characters</a></li>
+
</ul>
</li>
</ul>
@@ -628,7 +634,6 @@
-
<div id="introduction" class="section informative">
<!--OddPage--><h2><span class="secno">1. </span>Introduction</h2><p><em>This section is non-normative.</em></p>
<p>
@@ -679,8 +684,9 @@
<p></p>
<p>
Using <code><meta charset="*"/></code> has no effect in XML.
- Therefore, polyglot markup <em title="may" class="rfc2119">may</em> use <code><meta charset="*"/></code> in combination with BOM, as long the meta element specifies the same character encoding as the BOM.
- In addition, the meta tag <em title="may" class="rfc2119">may</em> be used in the absence of a BOM as long as it matches the already specified encoding.
+ Therefore, polyglot markup <em title="may" class="rfc2119">may</em> use <code><meta charset="*"/></code> provided the document is encoded as UTF-8 and the value of charset is a case-insensitive match for the string “utf-8”.
+ </p>
+ <p>
Note that the <a href="http://www.w3.org/International/questions/qa-html-encoding-declarations">W3C Internationalization (i18n) Group recommends</a>
to always include a visible encoding declaration in a document, because
it helps developers, testers, or translation production managers to
@@ -747,7 +753,7 @@
[<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>] introduces undeclared (native) support for attributes in the XLink namespace and with the prefix <code>xlink:</code>.
Polyglot markup <em title="must" class="rfc2119">must</em> declare the XLink namespace on the HTML root element (<code><html></code>) or once on the foreign element where is used (<code><svg></code> or <code><mathml></code>), to maintain XML-compatibility [<cite><a href="#bib-XML10" rel="biblioentry" class="bibref">XML10</a></cite>].
</p>
- <p>In polyglot markup, the xlink prefix uses the namespace declaration <code>xmlns:xlink="http://www.w3.org/1999/xlink"</code> before using the xlink prefix for the following elements:
+ <p>In polyglot markup, the xlink prefix uses the namespace declaration <code>xmlns:xlink="http://www.w3.org/1999/xlink"</code> before using the xlink prefix for the following attributes:
</p><ul>
<li><code>xlink:actuate</code></li>
<li><code>xlink:arcrole</code></li>
@@ -956,25 +962,18 @@
<div id="attribute-values" class="section">
<h4><span class="secno">6.3.3 </span>Attribute Values</h4>
<p>
- Polyglot markup uses lowercase letters for the values of the
-attributes in the following list when they exist on HTML elements.
- More specifically, where required, polyglot markup <em title="must" class="rfc2119">must</em>
- use lower case letters for all ASCII letters in these attribute values;
-
- however, polyglot markup respects case sensitivity for non-ASCII
-letters such as Greek, Cyrillic, or non-ASCII Latin letters.
- For attribute values on HTML elements other than those in the
-following list, polyglot markup <em title="may" class="rfc2119">may</em> use mixed case letters.
- </p>
- <p>
- Because XML is case sensitive, polyglot markup also requires case to
-be consistent for values between markup, DOM APIs, and CSS.
+ Polyglot markup requires the case used for characters in the values
+of the following attributes to be consistent between markup, DOM APIs,
+and CSS
+ when these attributes are used on HTML elements.
+ This is because XML is case sensitive, but the values of these
+attributes are treated as case insensitive in HTML when matched via CSS
+selectors
+ (See <a href="http://dev.w3.org/html5/spec/links.html#selectors">4.14.1 Case-sensitivity</a>, in the HTML5 specification). [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>]
+
In addition, polyglot markup respects the case sensitivity of all
-other attribute values.
- Although polyglot markup must always have lowercase values of the
-attributes in the following list when they exist on HTML elements,
- attributes not in this list and attributes on non-HTML elements may
-have values made of mixed case letters.
+other attribute values and for non-ASCII characters in the values of the
+ attributes listed.
Note that other specifications, such as RDFa, may place additional
restrictions on the allowed values of certain attributes.
</p>
@@ -1070,6 +1069,20 @@
Within polyglot markup, the text within either a <code><textarea></code> or <code><pre></code> element <em title="must not" class="rfc2119">must not</em> begin with white space.
<!--End section: White Space in textarea and pre Elements-->
</div>
+
+ <div id="elements-that-cannot-contain-special-characters" class="section">
+ <h4><span class="secno">6.5.2 </span>Elements that Cannot Contain Special Characters</h4>
+ <p>
+ Due to the conflict between parsing rules between HTML and XML,
+polyglot markup uses the following elements only if they do not contain
+angled brackets ("<" or ">") or ampersands ("&").
+ </p>
+ <ul>
+ <li><code>plaintext</code></li>
+ <li><code>xmp</code></li>
+ </ul>
+<!--End Section: Elements that Cannot Contain Special Characters-->
+ </div>
<!--End section: Elements with Special Considerations-->
</div>
@@ -1275,4 +1288,5 @@
</div>
</body>
+
</html>
\ No newline at end of file
Received on Friday, 29 October 2010 20:34:48 UTC