- From: CVS User lsilli <cvsmail@w3.org>
- Date: Sun, 01 Sep 2013 20:34:07 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/html-xhtml-author-guide In directory roscoe:/tmp/cvs-serv19412/html-xhtml-author-guide Modified Files: html-xhtml-authoring-guide.html Log Message: Fixing bug 19869 --- /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html 2013/09/01 19:52:47 1.116 +++ /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html 2013/09/01 20:34:07 1.117 @@ -82,25 +82,28 @@ <p> It is often valuable to be able to serve HTML5 documents that are also well formed XML documents. An author may, for example, use XML tools to generate a document, and they and others may process the document using XML tools. - The language used to create documents that can be parsed by both HTML and XML parsers is called <dfn>polyglot markup</dfn>. + The language used to create documents that can be parsed by both HTML and XML parsers is called <a title="polyglot markkup">polyglot markup</a>. <a title="polyglot markup">Polyglot markup</a> is the overlap language of documents that are both HTML5 documents and XML documents. It is recommended that these documents be served as either <code>text/html</code> (if the content is transmitted to an HTML-aware user agent) or <code>application/xhtml+xml</code> (if the content is transmitted to an XHTML-aware user agent). Other permissible MIME types are <code>text/xml</code>, <code>application/xml</code>, and any MIME type whose subtype ends with the four characters "<code>+xml</code>". [[!XML-MT]] </p> +</section> +<section id="syntax"> + <h2>The syntax of polyglot markup</h2> + <section id="principles"><h3>Principles</h3> <p> - <a title="polyglot markup">Polyglot markup</a> results in: + <dfn>Polyglot markup</dfn> results in: </p> <ul> <li>a valid HTML document. [[!HTML5]]</li> <li>a <a href="http://www.w3.org/TR/2008/PER-xml-20080205/#sec-well-formed">well-formed XML</a> document. [[!XML10]]</li> - <li>identical DOMs when processed as HTML and when processed as XML. - A noteable exception to this is that HTML and XML parsers generate different DOMs for some + <li>identical DOMs when processed as HTML and when processed as XML, with some notable exceptions: HTML and XML parsers generate different DOMs for some <code>xml</code> (<code>xml:lang</code>, <code>xml:space</code>, and <code>xml:base</code>), <code>xmlns</code> (<code>xmlns=""</code> and <code>xmlns:xlink=""</code>), and <code>xlink</code> (such as <code>xlink:href</code>) attributes. - XML requires and HTML5 permits these attributes in certain locations and the attributes are preserved by HTML parsers. - </li> + XML requires and HTML5 permits these attributes in certain locations and the attributes are preserved by HTML parsers. The exception must not break the requiremetn to be a valid HTML document. + </li> </ul> <p> <a title="polyglot markup">Polyglot markup</a> is not constrained: @@ -132,9 +135,10 @@ so long as the extension does not violate the rules of <a>polyglot markup</a>. [[!HTML5]] In addition, being well formed XML, <a>polyglot markup</a> can be extended when it is served as <code>application/xhtml+xml</code>. </p> -<!--End section: Introduction--> </section> - +<!--End section: principles--> +</section> +<section id="writing"><h3>Writing HTML documents with polyglot markup</h3> <section id="PI-and-xml" class="section"> <h2>Processing Instructions and the XML Declaration</h2> <p> @@ -864,7 +868,7 @@ <!--End section: Comments--> </section> - +</section> <section id="example-document" class="section">
Received on Sunday, 1 September 2013 20:34:08 UTC