- From: CVS User egraff <cvsmail@w3.org>
- Date: Wed, 03 Jul 2013 23:07:57 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/html-xhtml-author-guide
In directory roscoe:/tmp/cvs-serv13161
Modified Files:
html-xhtml-authoring-guide.html
Log Message:
Changes to the SOTD as requested in bug 22563
--- /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html 2013/05/24 19:38:50 1.110
+++ /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html 2013/07/03 23:07:56 1.111
@@ -44,13 +44,21 @@
<section id="sotd">
<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 specification is intended to be used by web authors.
- It is not a specification for user agents and creates no obligations on user agents.
+ This document summarizes design guidelines for authors who wish their XHTML or HTML documents to validate on either HTML or XML parsers.
+ This specification is intended to be used by web authors, particularly authors who want to serve receivers which may have either (but not both) XML or HTML parsers available.
+ This commonly arises in legacy systems and content syndication.
+ Polyglot is one of several transition mechanisms from legacy XML to HTML5 and this document serves to describe it accurately.
+ </p>
+ <p>
+ No recommendation is made in this document or by the W3C regarding whether or not to publish polyglot content.
+ In general, authors are encouraged to publish HTML content using HTML5 syntax and media types
+ (either HTML syntax and <code>text/html</code>, or XHTML syntax and <code>application/xhtml+xml</code>).
+ </p>
+ <p>
+ This document 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 [[!HTML5]] and [[!RFC2854]].
+ Nor does it define the meaning of the Internet Media Type <code>text/html</code>.
+ For user agent guidance and for these definitions, see [[!HTML5]] and [[!RFC2854]].
</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.
@@ -808,20 +816,20 @@
<tr>
<th rowspan="2" >Ambiguous?</th><th rowspan="2">String</th><th rowspan="2">Info</th><th rowspan="2">HTML interpretation</th><th colspan="2">XML interpretation</th>
</tr>
- <tr><th>if inside <code><[CDATA[</code>section<code>]]></code></th><th>if outside <code><[CDATA[</code>section<code>]]></code></th>
+ <tr><th>if inside <code><[CDATA[</code>section<code>]]></code></th><th>if outside <code><[CDATA[</code>section<code>]]></code></th>
</tr>
</thead>
<tbody>
<tr><td>ambiguous</td><td><code><</code></td><td>LESS-THAN SIGN</td><td>nearly uninterpreted</td><td>completely uninterpreted</td><td>interpreted <small>(commences tags, comments, CDATA)</small></td></tr>
<tr><td>ambiguous</td><td><code>&</code></td><td>AMPERSAND</td><td colspan="2">completely uninterpreted</td><td>interpreted <small>commences character reference or entity</small></td></tr>
<tr><td>ambiguous</td><td><code><--</code></td><td>start of comment</td><td>partly unintepreted</td><td>completely uninterpreted</td><td>interpreted</td></tr>
-<tr><td>ambiguous</td><td><code>--></code></td><td>end of comment</td><td>partly unintepreted</td><td>completely uninterpreted</td><td>interpreted</td></tr>
+<tr><td>ambiguous</td><td><code>--></code></td><td>end of comment</td><td>partly unintepreted</td><td>completely uninterpreted</td><td>interpreted</td></tr>
<tr><td>ambiguous</td><td><code><[CDATA[</code></td><td>start of CDATA declaration</td><td colspan="2">completely uninterpreted<td>interpreted <small>(begins CDATA block)</small></td></tr>
-<tr><td>ambiguous</td><td><code>]]></code></td><td>end of CDATA declaration</td><td colspan="2">completely uninterpreted<td>interpreted <small>(ends CDATA block</small></td></tr>
+<tr><td>ambiguous</td><td><code>]]></code></td><td>end of CDATA declaration</td><td colspan="2">completely uninterpreted<td>interpreted <small>(ends CDATA block</small></td></tr>
<tr><td>ambiguous</td><td><code>cdata content</code></td><td>the content of CDATA sections</td><td></td><td>completely uninterpreted<td>—</td></tr>
-<tr><td>ambiguous</td><td><code></script</code> </td><td>if occuring inside <code>script</code> element and followed by one of "tab" (U+0009), "LF" (U+000A), "FF" (U+000C), "CR" (U+000D), U+0020 SPACE, ">" (U+003E), or "/" (U+002F)</td><td>terminates parent</td><td>completely uninterpreted</td><td>interpreted</td></tr>
-<tr><td>ambiguous</td><td><code></style</code></td><td>if occuring inside <code>style</code> element and followed by one of "tab" (U+0009), "LF" (U+000A), "FF" (U+000C), "CR" (U+000D), U+0020 SPACE, ">" (U+003E), or "/" (U+002F)</td><td>terminates parent</td><td>completely uninterpreted</td><td>interpreted</td></tr>
-<tr><td>ambiguous</td><td><code><foo></bar></code></td><td>all other tags, wellformed or not</td><td colspan="2">completely uninterpreted</td><td>interpreted <small>subject to normal parsing rules</small></td></tr> </tbody>
+<tr><td>ambiguous</td><td><code></script</code> </td><td>if occuring inside <code>script</code> element and followed by one of "tab" (U+0009), "LF" (U+000A), "FF" (U+000C), "CR" (U+000D), U+0020 SPACE, ">" (U+003E), or "/" (U+002F)</td><td>terminates parent</td><td>completely uninterpreted</td><td>interpreted</td></tr>
+<tr><td>ambiguous</td><td><code></style</code></td><td>if occuring inside <code>style</code> element and followed by one of "tab" (U+0009), "LF" (U+000A), "FF" (U+000C), "CR" (U+000D), U+0020 SPACE, ">" (U+003E), or "/" (U+002F)</td><td>terminates parent</td><td>completely uninterpreted</td><td>interpreted</td></tr>
+<tr><td>ambiguous</td><td><code><foo></bar></code></td><td>all other tags, wellformed or not</td><td colspan="2">completely uninterpreted</td><td>interpreted <small>subject to normal parsing rules</small></td></tr> </tbody>
<tbody>
<tr><td>unambiguous</td><td><code>none of the above strings</code></td><td></td><td colspan="3">completely uninterpreted</td></tr>
</tbody>
@@ -834,7 +842,7 @@
<ul>
<li>If the syntax rules of the script or stylesheet does not iclude CDATA declarations in its syntax, then use the comment syntax (or another loophole) of the script/stylesheet language to hide the CDATA declaration from the script.</li>
<li>If HTML comments, or the start or the end of an HTML comment is inserted in an CDATA section, then it SHOULD also be closed within the same CDATA section.</li>
-<li>Inside a CDATA section, the CDATA ‘end tag’ string — <code>]]></code> – MUST be escaped, though the exact escaping method depends on the goals of the use.</li>
+<li>Inside a CDATA section, the CDATA ‘end tag’ string — <code>]]></code> – MUST be escaped, though the exact escaping method depends on the goals of the use.</li>
</ul>
<p>The following the example is <a>polyglot markup</a> because there are no <a>ambiguous strings</a> within the <code>script</code> tag. </p>
@@ -871,153 +879,153 @@
The example page could also be served as <code>'application/xhtml+xml'</code> instead, with the file extension .html,
maintaining adherence to Polyglot markup and enabling the rendering of the SVG.
</p>
- <pre class="example" id="SampleDoc"><!DOCTYPE html>
+ <pre class="example" id="SampleDoc"><!DOCTYPE html>
-<html id="SampleDoc" xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
+<html id="SampleDoc" xmlns="http://www.w3.org/1999/xhtml" lang="en" xml:lang="en">
- <head>
- <title>A Sample Page Using Polglot Markup</title>
- <meta charset='utf-8' />
- <!-- The link element is self-closing as described in <a href="http://www.w3.org/TR/html-polyglot/#empty-elements">Section 6.4 Void Elements</a> -->
+ <head>
+ <title>A Sample Page Using Polglot Markup</title>
+ <meta charset='utf-8' />
+ <!-- The link element is self-closing as described in <a href="http://www.w3.org/TR/html-polyglot/#empty-elements">Section 6.4 Void Elements</a> -->
<!-- Style commands are included by linking to an external file rather than including them in-line,
- as described in <a href="http://www.w3.org/TR/html-polyglot/#script-and-style">Section 9. Script and Style</a> -->
- <link type="text/css" rel="stylesheet" href="Sample.css"/>
- </head>
-
- <body>
-<nav><p><strong>NB:</strong> These bytes are available served as <a href="SamplePage.xhtml"><a href="SamplePage.xhtml">XHTML</a></a> and as <a href="SamplePage.html"><a href="SamplePage.html">HTML</a></a></p></nav>
-
- <h1>Sample Page Using Polyglot Markup</h1>
- <p>
- The source code for <a href="#SampleDoc">this document</a> uses <dfn id="sampleDef">polyglot markup</dfn>,
+ as described in <a href="http://www.w3.org/TR/html-polyglot/#script-and-style">Section 9. Script and Style</a> -->
+ <link type="text/css" rel="stylesheet" href="Sample.css"/>
+ </head>
+
+ <body>
+<nav><p><strong>NB:</strong> These bytes are available served as <a href="SamplePage.xhtml"><a href="SamplePage.xhtml">XHTML</a></a> and as <a href="SamplePage.html"><a href="SamplePage.html">HTML</a></a></p></nav>
+
+ <h1>Sample Page Using Polyglot Markup</h1>
+ <p>
+ The source code for <a href="#SampleDoc">this document</a> uses <dfn id="sampleDef">polyglot markup</dfn>,
a 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.
The source code for this document also contains additional comments about the use of
- <a href="#sampleDef">polyglot markup</a>.
- </p>
+ <a href="#sampleDef">polyglot markup</a>.
+ </p>
- <h2>Foreign Elements</h2>
- <p>
+ <h2>Foreign Elements</h2>
+ <p>
The following shapes use SVG elements.
- <a href="#sampleDef">Polyglot markup</a> introduces undeclared (native) default namespaces
- for the the root SVG element (<code>svg</code>) and respects the mixed-case element names and values
+ <a href="#sampleDef">Polyglot markup</a> introduces undeclared (native) default namespaces
+ for the the root SVG element (<code>svg</code>) and respects the mixed-case element names and values
when appropriate, as described in the sections <a href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html#element-level-namespaces">5.1 Element-Level Namespaces</a>, <a href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html#element-names">6.3.1 Element Names</a>, and <a href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html#attribute-values">6.3.3 Attribute Values</a>.
- </p>
+ </p>
- <!-- <a href="#sampleDef">Polyglot markup</a> declares the xlink: namespace on the <svg> element to maintain XML-compatibility -->
- <svg width="350" height="250" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
- <g>
- <title>Three SVG shapes</title>
- <desc>
+ <!-- <a href="#sampleDef">Polyglot markup</a> declares the xlink: namespace on the <svg> element to maintain XML-compatibility -->
+ <svg width="350" height="250" version="1.1" xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink">
+ <g>
+ <title>Three SVG shapes</title>
+ <desc>
This SVG image contains an ellipse filled with a gradient that goes from white to blue as it moves outward from the center.
A yellow rectangle with a black border overlaps the ellipse in the upper-left quadrant,
and a red spiral on a white background overlaps the ellipse in the bottom-right quadrant.
The red spiral is also a link to the example code for that SVG shape.
- </desc>
- <defs>
- <!-- Note that "radialGradient" and "myGradient" respect mixed-case values. -->
- <radialGradient id="myGradient" cx="50%" cy="50%" r="50%" fx="50%" fy="50%">
- <stop offset="0%" style="stop-color:rgb(200,200,200); stop-opacity:0"/>
- <stop offset="100%" style="stop-color:rgb(0,0,255); stop-opacity:1"/>
- </radialGradient>
- </defs>
- <ellipse cx="50%" cy="50%" rx="50%" ry="42%" style="fill:url(#myGradient)"/>
- <rect x="0" y="0" width="100" height="100" style="fill: yellow; stroke: black;"/>
- <a xlink:href="http://www.example.org/foo">
+ </desc>
+ <defs>
+ <!-- Note that "radialGradient" and "myGradient" respect mixed-case values. -->
+ <radialGradient id="myGradient" cx="50%" cy="50%" r="50%" fx="50%" fy="50%">
+ <stop offset="0%" style="stop-color:rgb(200,200,200); stop-opacity:0"/>
+ <stop offset="100%" style="stop-color:rgb(0,0,255); stop-opacity:1"/>
+ </radialGradient>
+ </defs>
+ <ellipse cx="50%" cy="50%" rx="50%" ry="42%" style="fill:url(#myGradient)"/>
+ <rect x="0" y="0" width="100" height="100" style="fill: yellow; stroke: black;"/>
+ <a xlink:href="http://www.example.org/foo">
<!--
Note that the following attribute contains newlines which will produce a different DOM,
but will not affect the way in which SVG functions in the least.
- -->
+ -->
<path transform="translate(60, -175)"
d="M153 334 C153 334 151 334 151 334 C151 339 153 344 156 344 C164 344 171 339 171 334
C171 322 164 314 156 314 C142 314 131 322 131 334 C131 350 142 364 156 364
C175 364 191 350 191 334 C191 311 175 294 156 294 C131 294 111 311 111 334
C111 361 131 384 156 384 C186 384 211 361 211 334 C211 300 186 274 156 274"
- style="fill:white;stroke:red;stroke-width:2"/>
- </a>
- </g>
- </svg>
- <h2>Void Elements</h2>
+ style="fill:white;stroke:red;stroke-width:2"/>
+ </a>
+ </g>
+ </svg>
+ <h2>Void Elements</h2>
<!-- Given an empty instance of an element whose content model is not EMPTY (in this case, an empty paragraph)
- <a href="#sampleDef">polyglot markup</a> does not use the minimized form, as described in Section 6.4 Void Elements -->
- <p></p>
- <p>
- There is an empty <code>p</code> element before this paragraph.
- <a href="#sampleDef">Polyglot markup</a> uses <code>&lt;p>&lt;/p></code> and not <code>&lt;p/></code>.
- </p>
- <p>
- <a href="#sampleDef">Polyglot markup</a> treats certain elements as self-closing,
- void elements, such as the following <code>img</code> element.
- </p>
- <img height="48" width="72" alt="W3C" src="http://www.w3.org/Icons/w3c_home"/>
- <p>
+ <a href="#sampleDef">polyglot markup</a> does not use the minimized form, as described in Section 6.4 Void Elements -->
+ <p></p>
+ <p>
+ There is an empty <code>p</code> element before this paragraph.
+ <a href="#sampleDef">Polyglot markup</a> uses <code>&lt;p>&lt;/p></code> and not <code>&lt;p/></code>.
+ </p>
+ <p>
+ <a href="#sampleDef">Polyglot markup</a> treats certain elements as self-closing,
+ void elements, such as the following <code>img</code> element.
+ </p>
+ <img height="48" width="72" alt="W3C" src="http://www.w3.org/Icons/w3c_home"/>
+ <p>
For more information, see <a href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html#empty-elements">Section 6.4 Void Elements</a>.
- </p>
+ </p>
- <h2>Required Elements</h2>
- <p>
- The following table uses the required <code>tbody</code> element, as described in
+ <h2>Required Elements</h2>
+ <p>
+ The following table uses the required <code>tbody</code> element, as described in
<a href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html#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>
+ <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 <code>colgroup</code> element, as described in
+ <p>
+ The following table uses the required <code>colgroup</code> element, as described in
<a href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html#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>
- <tbody>
- <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>
- </tbody>
- </table>
-
- <h2>Named Entity References</h2>
- <p>
- The paragraph you now read, uses the string <code>&amp;amp;</code> for ampersands (“&amp;”) and uses,
- as described in <a href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html#named-entity-references">Section 8. Named Entity References</a>, the string <code>&amp;#xA0;</code>
- for a non-breaking space between the following two words: <i>“<a href="#sampleDef">polyglot&#xA0;markup</a>”</i>.
- </p>
- </body>
-</html></pre>
+ </p>
+ <table>
+ <colgroup>
+ <col style="background-color:silver"/>
+ <col style="background-color:gray"/>
+ <col style="background-color:yellow"/>
+ </colgroup>
+ <tbody>
+ <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>
+ </tbody>
+ </table>
+
+ <h2>Named Entity References</h2>
+ <p>
+ The paragraph you now read, uses the string <code>&amp;amp;</code> for ampersands (“&amp;”) and uses,
+ as described in <a href="http://dev.w3.org/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html#named-entity-references">Section 8. Named Entity References</a>, the string <code>&amp;#xA0;</code>
+ for a non-breaking space between the following two words: <i>“<a href="#sampleDef">polyglot&#xA0;markup</a>”</i>.
+ </p>
+ </body>
+</html></pre>
<!--End section: Example Document-->
</section>
Received on Wednesday, 3 July 2013 23:07:59 UTC