- From: poot <cvsmail@w3.org>
- Date: Fri, 10 Dec 2010 04:47:29 +0900 (JST)
- To: public-html-diffs@w3.org
eliot: Added sentence in Section 4 about about:legacy-compat & XML per
bug 11057; Added new section, "Comments in Polyglot Markup" per bug
11260; fixed malformed sample per bug 11516; Fixed attribute value
decription per bug 11261;
http://dev.w3.org/cvsweb/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html?r1=1.45&r2=1.46&f=h
===================================================================
RCS file: /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html,v
retrieving revision 1.45
retrieving revision 1.46
diff -u -d -r1.45 -r1.46
--- html-xhtml-authoring-guide.html 6 Dec 2010 20:43:20 -0000 1.45
+++ html-xhtml-authoring-guide.html 9 Dec 2010 19:45:01 -0000 1.46
@@ -1,7 +1,8 @@
<!DOCTYPE html>
<html dir="ltr" lang="en"><head>
-<title>Polyglot Markup: HTML-Compatible XHTML Documents</title>
+
+ <title>Polyglot Markup: HTML-Compatible XHTML Documents</title>
<meta name="GENERATOR" content="MSHTML 8.00.7600.16588"/>
<style type="text/css">
@@ -470,19 +471,32 @@
</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"/>
+<link type="text/css" rel="stylesheet" href="html-xhtml-authoring-guide_files/W3C-ED.css"/>
+</head>
+<body style="display: inherit;">
-</head>
- <body style="display: inherit;">
- <div class="head">
+<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-06-december-2010">W3C Editor's Draft 06 December 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-20101019/">http://www.w3.org/TR/2010/WD-html-polyglot-20101019/</a></dd><dt>Editor:</dt><dd><span>Eliot Graff</span>, Microsoft Corporation</dd>
-</dl>
+ <h1 class="title" id="title">Polyglot Markup: HTML-Compatible XHTML Documents</h1>
+ <h2 id="w3c-editor-s-draft-09-december-2010">W3C Editor's Draft 09 December 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-20101019/">http://www.w3.org/TR/2010/WD-html-polyglot-20101019/</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
@@ -493,8 +507,8 @@
<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>
-
</div>
+
<hr/>
<div class="introductory section" id="abstract"><h2>Abstract</h2>
@@ -541,21 +555,24 @@
<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.
-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>
- 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>
+ <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.
+ </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 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>
@@ -612,8 +629,9 @@
</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="#example-document"><span class="secno">11. </span>Example Document</a></li>
+ <li class="tocline"><a class="tocxref" href="#comments"><span class="secno">10. </span>Comments in Polyglot Markup</a></li>
+ <li class="tocline"><a class="tocxref" href="#foreign-content"><span class="secno">11. </span>Exceptions from the Foreign Content Parsing Rules</a></li>
+ <li class="tocline"><a class="tocxref" href="#example-document"><span class="secno">12. </span>Example Document</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">
@@ -625,7 +643,6 @@
</div>
-
<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>
@@ -676,8 +693,7 @@
<p></p>
<p>
Using <code><meta charset="*"/></code> has no effect in XML.
- Therefore, <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> may 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".
+ Therefore, <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> may 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>
@@ -708,7 +724,10 @@
</li>
</ul>
<p>
- Note that <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> does not use document type declarations for HTML4, HTML3, or HTML2, regardless of whether they contain a URI or not and
+ Note that using <code>about:legacy-compat</code> in XML may yield unpredictable parsing results, depending on the XML processing pipeline.
+ </p>
+ <p>
+ <a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> does not use document type declarations for HTML4, HTML3, or HTML2, regardless of whether they contain a URI or not and
regardless of their effect in HTML5 parsers, as these document type declarations are not compatible with XHTML.
</p>
<!--End section: The DOCTYPE-->
@@ -1085,11 +1104,20 @@
<div id="attributes" class="section">
<!--OddPage--><h2><span class="secno">7. </span>Attributes</h2>
-<p>Because of attribute-value normalization in XML [<cite><a href="#bib-XML10" rel="biblioentry" class="bibref">XML10</a></cite>], <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> does not contain tabs, line feeds, or carriage returns within CDATA attributes.
+<p>
+ Within an attribute's value, <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> represents tabs, line feeds, and carriage returns
+ as numeric character references rather than by using literal characters.
+ For example, within an attribute's value, <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> uses <code>&#x9;</code> for a tab
+ rather than the literal character <code>'\t'</code>.
+ This is because of attribute-value normalization in XML [<cite><a href="#bib-XML10" rel="biblioentry" class="bibref">XML10</a></cite>].
+</p>
+<p>
+ <a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> surrounds all attribute values with quotation marks.
+ <a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> surrounds attribute values by either single quotation marks or by double quotation marks.
+</p>
+<p>
+ See also <a href="#attribute-values">Attribute Values</a>.
</p>
-<p><a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> surrounds all attribute values with quotation marks.
- <a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> surrounds attribute values by either single quotation marks or by double quotation marks.</p>
-<p>See also <a href="#attribute-values">Attribute Values</a>.</p>
<div id="disallowed-attributes" class="section">
<h3><span class="secno">7.1 </span>Disallowed Attributes</h3>
@@ -1120,7 +1148,8 @@
<div id="named-entity-references" class="section">
<!--OddPage--><h2><span class="secno">8. </span>Named Entity References</h2>
- <p><a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> uses only the following named entity references:</p>
+ <p>
+ <a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> uses only the following named entity references:</p>
<ul>
<li><code>amp</code></li>
<li><code>lt</code></li>
@@ -1222,8 +1251,18 @@
<!--End section: Script and Style-->
</div>
+<div id="comments" class="section">
+ <!--OddPage--><h2><span class="secno">10. </span>Comments in Polyglot Markup</h2>
+ <p>
+ <a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> does not begin a comment with either "<code>></code>" or "<code>-></code>".
+ </p>
+
+<!--End section: Comments-->
+</div>
+
+
<div id="foreign-content" class="section">
- <!--OddPage--><h2><span class="secno">10. </span>Exceptions from the Foreign Content Parsing Rules</h2>
+ <!--OddPage--><h2><span class="secno">11. </span>Exceptions from the Foreign Content Parsing Rules</h2>
<p>
<!-- TODO: Need to call out exceptions from the foreign content parsing rules (e.g. <foreignContent> -->
</p>
@@ -1232,7 +1271,7 @@
</div>
<div id="example-document" class="section">
- <!--OddPage--><h2><span class="secno">11. </span>Example Document</h2>
+ <!--OddPage--><h2><span class="secno">12. </span>Example Document</h2>
<p>
The following example code acts as <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> and validates as either XHTML or as HTML. You can view the page live
at <a href="http://dev.w3.org/html5/html-xhtml-author-guide/SamplePage.html">http://dev.w3.org/html5/html-xhtml-author-guide/SamplePage.html</a>.
@@ -1306,83 +1345,82 @@
</a>
</g>
</svg>
- <h2>Empty Elements</h2>
- <!-- Given an empty instance of an element whose content model is not EMPTY (in this case, an empty paragraph)
- <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> does not use the minimized form, as described in <a href="#empty-elements">Section 6.4 Empty Elements</a> -->
- <p></p>
- <p>
- There is an empty <p> element before this paragraph.
- <a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> uses <p></p> and not <p />.
- </p>
- <p>
- <a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> treats certain elements as self-closing,
- empty elements, such as the following <img> element.
- </p>
- <img height="48" width="72" alt="W3C" src="http://www.w3.org/Icons/w3c_home"/>
- <p>
- For more information, see <a href="#empty-elements">Section 6.4 Empty Elements</a>.
- </p>
+ <h2>Empty Elements</h2>
+ <!-- Given an empty instance of an element whose content model is not EMPTY (in this case, an empty paragraph)
+ <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> does not use the minimized form, as described in <a href="#empty-elements">Section 6.4 Empty Elements</a> -->
+ <p></p>
+ <p>
+ There is an empty <p> element before this paragraph.
+ <a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> uses <p></p> and not <p />.
+ </p>
+ <p>
+ <a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> treats certain elements as self-closing,
+ empty elements, such as the following <img> element.
+ </p>
+ <img height="48" width="72" alt="W3C" src="http://www.w3.org/Icons/w3c_home"/>
+ <p>
+ For more information, see <a href="#empty-elements">Section 6.4 Empty Elements</a>.
+ </p>
- <h2>Required Elements</h2>
- <p>
- The following table uses the required <tbody> element, as described in
- <a href="#required-elements">Section 6.1 Required Elements</a>.
- </p>
- <table>
- <tbody>
- <tr>
- <th>Column One</th>
- <th>Column Two</th>
- </tr>
+ <h2>Required Elements</h2>
+ <p>
+ The following table uses the required <tbody> element, as described in
+ <a href="#required-elements">Section 6.1 Required Elements</a>.
+ </p>
+ <table>
+ <tbody>
+ <tr>
+ <th>Column One</th>
+ <th>Column Two</th>
+ </tr>
+ <tr>
+ <td>Row 1, Column 1</td>
+ <td>Row 1, Column 2</td>
+ </tr>
+ <tr>
+ <td>Row 2, Column 1</td>
+ <td>Row 2, Column 2</td>
+ </tr>
+ <tr>
+ <td>Row 3, Column 1</td>
+ <td>Row 3, Column 2</td>
+ </tr>
+ </tbody>
+ </table>
+
+ <p>
+ The following table uses the required <colgroup> element, as described in
+ <a href="#required-elements">Section 6.1 Required Elements</a>.
+ </p>
+ <table>
+ <colgroup>
+ <col style="background-color:silver"/>
+ <col style="background-color:gray"/>
+ <col style="background-color:yellow"/>
+ </colgroup>
<tr>
- <td>Row 1, Column 1</td>
- <td>Row 1, Column 2</td>
+ <th>ISBN</th>
+ <th>Title</th>
+ <th>Price</th>
</tr>
<tr>
- <td>Row 2, Column 1</td>
- <td>Row 2, Column 2</td>
+ <td>3476896</td>
+ <td>My first HTML</td>
+ <td>$53</td>
</tr>
<tr>
- <td>Row 3, Column 1</td>
- <td>Row 3, Column 2</td>
+ <td>1234567</td>
+ <td>Intermediate Polyglot</td>
+ <td>$49</td>
</tr>
- </tbody>
- </table>
-
- <p>
- The following table uses the required <colgroup> element, as described in
- <a href="#required-elements">Section 6.1 Required Elements</a>.
- </p>
- <table>
- <colgroup>
- <col style="background-color:silver"/>
- <col style="background-color:gray"/>
- <col style="background-color:yellow"/>
- </colgroup>
- <tr>
- <th>ISBN</th>
- <th>Title</th>
- <th>Price</th>
- </tr>
- <tr>
- <td>3476896</td>
- <td>My first HTML</td>
- <td>$53</td>
- </tr>
- <tr>
- <td>1234567</td>
- <td>Intermediate Polyglot</td>
- <td>$49</td>
- </tr>
- </table>
-
+ </table>
- <h2>Named Entity References</h2>
- <p>
- This paragraph uses the string "&amp;" for ampersands ("&") and uses the string "&#xA0;"
- for a nonbreaking space between the words "polyglot markup," as described in
- <a href="#named-entity-references">Section 8. Named Entity References</a>.
+ <h2>Named Entity References</h2>
+ <p>
+ This paragraph uses the string "&amp;" for ampersands ("&") and uses the string "&#xA0;"
+ for a nonbreaking space between the words "polyglot markup," as described in
+ <a href="#named-entity-references">Section 8. Named Entity References</a>.
</p>
</body>
</html> </pre>
@@ -1392,18 +1430,16 @@
<div id="acknowledgements" class="appendix section">
-<!--OddPage--><h2><span class="secno">A. </span>Acknowledgements</h2>
-<p>
- Many thanks to Daniel Glazman, Richard Ishida, Tony Ross, Sam Ruby,
-Jonas Sicking, Leif Halvard Silli, Henri Sivonen, Manu Sporny, and
-Philip Taylor.
- Special thanks to the W3C TAG and the W3C Internationalization (i18n)
-Core Working Group.
-</p>
+ <h2><span class="secno">A. </span>Acknowledgements</h2>
+ <p>
+ Many thanks to Robin Berjon, Daniel Glazman, Richard Ishida, Tony Ross, Sam Ruby, Jonas Sicking, Leif Halvard Silli,
+ Henri Sivonen, Manu Sporny, and Philip Taylor.
+ Special thanks to the W3C TAG and the W3C Internationalization (i18n) Core Working Group.
+ </p>
</div>
<div class="appendix section" id="references">
-<h2><span class="secno">B. </span>References</h2>
+ <h2><span class="secno">B. </span>References</h2>
<div class="section" id="normative-references">
<h3><span class="secno">B.1 </span>Normative references</h3>
@@ -1440,5 +1476,5 @@
</div>
</div>
-
-</body></html>
\ No newline at end of file
+</body>
+</html>
\ No newline at end of file
Received on Thursday, 9 December 2010 19:47:59 UTC