- From: Eliot Graff via cvs-syncmail <cvsmail@w3.org>
- Date: Sat, 15 Sep 2012 19:14:32 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/html-xhtml-author-guide
In directory hutz:/tmp/cvs-serv1801
Modified Files:
WD-html-polyglot-20120925.htm
Log Message:
Fixing PubRules issues
Index: WD-html-polyglot-20120925.htm
===================================================================
RCS file: /sources/public/html5/html-xhtml-author-guide/WD-html-polyglot-20120925.htm,v
retrieving revision 1.1
retrieving revision 1.2
diff -u -d -r1.1 -r1.2
--- WD-html-polyglot-20120925.htm 15 Sep 2012 19:03:23 -0000 1.1
+++ WD-html-polyglot-20120925.htm 15 Sep 2012 19:14:30 -0000 1.2
@@ -44,7 +44,7 @@
<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-september-2012">W3C Editor's Draft 25 September 2012</h2>
+ <h2 id="w3c-working-draft-25-september-2012">W3C Working Draft 25 September 2012</h2>
<dl>
<dt>This version:</dt>
<dd><a href="http://dev.w3.org/html5/html-xhtml-author-guide/">http://dev.w3.org/html5/html-xhtml-author-guide/</a></dd>
@@ -104,8 +104,8 @@
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" class="bibref">HTML5</a></cite>] and
+ [<cite><a href="#bib-RFC2854" 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 a Working Draft.
@@ -234,16 +234,16 @@
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>". [<cite><a href="#bib-XML-MT" rel="biblioentry" class="bibref">XML-MT</a></cite>]
+ and any MIME type whose subtype ends with the four characters "<code>+xml</code>". [<cite><a href="#bib-XML-MT" class="bibref">XML-MT</a></cite>]
</p>
<p>
<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> results in:
</p>
<ul>
- <li>a valid HTML document. [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>]</li>
+ <li>a valid HTML document. [<cite><a href="#bib-HTML5" class="bibref">HTML5</a></cite>]</li>
<li>
a <a href="http://www.w3.org/TR/2008/PER-xml-20080205/#sec-well-formed">well-formed XML</a> document.
- [<cite><a href="#bib-XML10" rel="biblioentry" class="bibref">XML10</a></cite>]
+ [<cite><a href="#bib-XML10" class="bibref">XML10</a></cite>]
</li>
<li>
identical DOMs when processed as HTML and when processed as XML.
@@ -259,7 +259,7 @@
<ul>
<li>
to be <a href="http://www.w3.org/TR/2008/PER-xml-20080205/#dt-valid">valid XML</a>.
- [<cite><a href="#bib-XML10" rel="biblioentry" class="bibref">XML10</a></cite>]
+ [<cite><a href="#bib-XML10" class="bibref">XML10</a></cite>]
</li>
<li>by conformance to any XML DTD.</li>
</ul>
@@ -299,9 +299,9 @@
<!--OddPage--><h2><span class="secno">3. </span>Specifying a Document's Character Encoding</h2>
<p>
Polyglot markup uses the UTF-8 character encoding, the only character encoding for which both HTML and XML require support.
- HTML requires UTF-8 to be explicitly declared to avoid <a href="http://www.w3.org/TR/html5/semantics.html#charset">fallback to a legacy encoding</a> [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>].
+ HTML requires UTF-8 to be explicitly declared to avoid <a href="http://www.w3.org/TR/html5/semantics.html#charset">fallback to a legacy encoding</a> [<cite><a href="#bib-HTML5" class="bibref">HTML5</a></cite>].
For XML, UTF-8 is an <a href="http://www.w3.org/TR/2008/REC-xml-20081126/#charencoding">encoding default</a>.
- As such, character encoding <em title="may" class="rfc2119">may</em> be left undeclared in XML with the result that UTF-8 is still supported [<cite><a href="#bib-XML10" rel="biblioentry" class="bibref">XML10</a></cite>].
+ As such, character encoding <em title="may" class="rfc2119">may</em> be left undeclared in XML with the result that UTF-8 is still supported [<cite><a href="#bib-XML10" class="bibref">XML10</a></cite>].
</p>
<p>
<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> declares the UTF-8 character encoding in the following ways, which may be used separately or in combination:
@@ -315,7 +315,7 @@
</li>
<li>Outside the document
<ul>
- <li>By adding <code>"charset=utf-8"</code> to the MIME/HTTP Content-Type header [<cite><a href="#bib-HTTP11" rel="biblioentry" class="bibref">HTTP11</a></cite>], as the following examples show in HTML and XML, respectively: </li>
+ <li>By adding <code>"charset=utf-8"</code> to the MIME/HTTP Content-Type header [<cite><a href="#bib-HTTP11" class="bibref">HTTP11</a></cite>], as the following examples show in HTML and XML, respectively: </li>
</ul>
<pre class="example"><code>Content-type: text/html; charset=utf-8</code></pre>
<pre class="example"><code>Content-type: application/xhtml+xml; charset=utf-8</code></pre>
@@ -327,7 +327,7 @@
the encoding default from XML makes XML parsers treat content as UTF-8.
</p>
<p>
- The <a href="http://www.w3.org/International/questions/qa-html-encoding-declarations"><acronym title="World Wide Web Consortium">W3C</acronym> Internationalization (i18n) Group recommends</a>
+ The <a href="http://www.w3.org/International/questions/qa-html-encoding-declarations"><abbr title="World Wide Web Consortium">W3C</abbr> 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 check the
@@ -339,7 +339,7 @@
<div id="doctype" class="section">
<!--OddPage--><h2><span class="secno">4. </span>The DOCTYPE</h2>
<p>
- <a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> uses a document type declaration (DOCTYPE) specified by <a href="http://www.w3.org/TR/html5/syntax.html#the-doctype">section 8.1.1</a> of [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>].
+ <a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> uses a document type declaration (DOCTYPE) specified by <a href="http://www.w3.org/TR/html5/syntax.html#the-doctype">section 8.1.1</a> of [<cite><a href="#bib-HTML5" class="bibref">HTML5</a></cite>].
In addition, the DOCTYPE conforms to the following rules:
</p>
<ul>
@@ -375,11 +375,11 @@
<div id="element-level-namespaces" class="section">
<h3><span class="secno">5.1 </span>Element-Level Namespaces</h3>
<p>
- [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>] introduces undeclared (native) default namespaces for the root HTML element, <code>html</code>, the root SVG element, <code>svg</code>,
+ [<cite><a href="#bib-HTML5" class="bibref">HTML5</a></cite>] introduces undeclared (native) default namespaces for the root HTML element, <code>html</code>, the root SVG element, <code>svg</code>,
and the root MathML element, <code>math</code>.
<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a>
declares the following default namespaces, when the markup languages
-are included in the document, to maintain XML-compatibility [<cite><a href="#bib-XML10" rel="biblioentry" class="bibref">XML10</a></cite>]:
+are included in the document, to maintain XML-compatibility [<cite><a href="#bib-XML10" class="bibref">XML10</a></cite>]:
</p><ul>
<li><code><html xmlns="http://www.w3.org/1999/xhtml"></code></li>
<li><code><math xmlns="http://www.w3.org/1998/Math/MathML"></code></li>
@@ -391,7 +391,7 @@
the root SVG element, <code>svg</code>, and the root MathML element <code>math</code>,
and on any HTML elements used as children of SVG or MathML elements.
<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> does not declare any other default or prefixed element namespace, because
- [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>] does not natively support the declaring of any other default or prefixed element namespace.
+ [<cite><a href="#bib-HTML5" class="bibref">HTML5</a></cite>] does not natively support the declaring of any other default or prefixed element namespace.
</p>
<!-- End section, "Element-Level Namespaces" -->
</div>
@@ -399,9 +399,9 @@
<div id="attribute-level-namespaces" class="section">
<h3><span class="secno">5.2 </span>Attribute-Level Namespaces</h3>
<p>
- [<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>.
+ [<cite><a href="#bib-HTML5" class="bibref">HTML5</a></cite>] introduces undeclared (native) support for attributes in the XLink namespace and with the prefix <code>xlink:</code>.
<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> declares the XLink namespace on the HTML root element (<code>html</code>) or
- once on the foreign element where it is used (<code>svg</code> or <code>math</code>), to maintain XML-compatibility [<cite><a href="#bib-XML10" rel="biblioentry" class="bibref">XML10</a></cite>].
+ once on the foreign element where it is used (<code>svg</code> or <code>math</code>), to maintain XML-compatibility [<cite><a href="#bib-XML10" class="bibref">XML10</a></cite>].
</p>
<p>In <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a>, 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>
@@ -486,7 +486,7 @@
<h3><span class="secno">6.2 </span>Elements that Cannot Be Used in Polyglot Markup</h3>
<p>
<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> does not use the <code>noscript</code> element, because
- the <code>noscript</code> element cannot be used in XML documents. [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>]
+ the <code>noscript</code> element cannot be used in XML documents. [<cite><a href="#bib-HTML5" class="bibref">HTML5</a></cite>]
</p>
<!--End section: Elements that Cannot Be Used in Polyglot Markup-->
</div>
@@ -645,7 +645,7 @@
<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> maintains case consistency for these values
because, for the purpose of selector matching, attribute values in XML are all treated case sensitively;
however, HTML treats the values of these attributes as case insensitive
- (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>]
+ (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" class="bibref">HTML5</a></cite>]
</p>
<ul>
@@ -781,14 +781,14 @@
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>].
+ This is because of attribute-value normalization in XML [<cite><a href="#bib-XML10" class="bibref">XML10</a></cite>].
The following example uses numeric character references (escaped
characters) for the line feed, tab, and less-than characters within a <code>srcdoc</code> attribute.
</p>
<pre class="example"><iframe srcdoc="&lt;p>Hello &#x0A; &#x09; world!&lt;/p>" src="demo_iframe_srcdoc.htm"></iframe></pre>
<p class="note">
- 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>
+ Because of attribute-value normalization in XML [<cite><a href="#bib-XML10" class="bibref">XML10</a></cite>], <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a>
does not use newline characters within an attribute.
Practically speaking, for source code with newlines within attributes,
DOMs generated via XML and HTML will be different;
@@ -806,7 +806,7 @@
<h3><span class="secno">7.1 </span>Disallowed Attributes</h3>
<p>The following attributes are not allowed in <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a>.
These attributes have effects in documents parsed as XML but do not have effects in documents parsed as text/html.
- The HTML5 spec therefore defines them as invalid in text/html documents. [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>]
+ The HTML5 spec therefore defines them as invalid in text/html documents. [<cite><a href="#bib-HTML5" class="bibref">HTML5</a></cite>]
</p>
<ul>
<li><code>xml:space</code></li>
@@ -834,7 +834,7 @@
For the mechanism to actually set a fallback language, however, it has to locate either an <code>http-equiv="Content-Language"</code> declaration on the <code>meta</code> element
or an <code>HTTP Content-Language:</code> header, either of whose content value is no more and no less than exactly one language tag.
Note that although the mechanism can locate either the meta element or the header, the meta element is considered first.
- For more information about determining language in HTML5, see the <a href="http://www.w3.org/TR/html5/elements#language">language determination rules</a>. [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>].
+ For more information about determining language in HTML5, see the <a href="http://www.w3.org/TR/html5/elements#language">language determination rules</a>. [<cite><a href="#bib-HTML5" class="bibref">HTML5</a></cite>].
</p>
<!--End section: Language Attributes-->
@@ -850,7 +850,7 @@
<h4><span class="secno">7.3.1 </span>The <code>id</code> Attribute</h4>
<p>
<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> does not contain any space characters within the value of an <code>id</code> attribute.
- This is because values for the <code>id</code> attribute <a href="http://dev.w3.org/html5/spec/elements.html#the-id-attribute">may not contain space characters</a> in HTML5. [<cite><a href="#bib-HTML5" rel="biblioentry" class="bibref">HTML5</a></cite>]
+ This is because values for the <code>id</code> attribute <a href="http://dev.w3.org/html5/spec/elements.html#the-id-attribute">may not contain space characters</a> in HTML5. [<cite><a href="#bib-HTML5" class="bibref">HTML5</a></cite>]
</p>
<!-- End section: The id Attribute -->
</div>
@@ -878,7 +878,7 @@
For example, <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> uses <code>&#xA0;</code> instead of <code>&nbsp;</code>.
Note that <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> may use decimal values for escape characters (such as &#160; in the previous example);
however, the <a href="http://www.w3.org/TR/2005/REC-charmod-20050215/#C048">Character Model for the World Wide Web</a> recommends
- that content <em title="should" class="rfc2119">should</em> use the hexadecimal form of character escapes rather than the decimal form when both are available. [<cite><a href="#bib-CHARMOD" rel="biblioentry" class="bibref">CHARMOD</a></cite>]
+ that content <em title="should" class="rfc2119">should</em> use the hexadecimal form of character escapes rather than the decimal form when both are available. [<cite><a href="#bib-CHARMOD" class="bibref">CHARMOD</a></cite>]
</p>
<p>
<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> always uses character references for the less than sign (<code><</code>) and ampersand (<code>&</code>) when they are used as characters,
@@ -1032,7 +1032,7 @@
<a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> treats certain elements as self-closing,
void elements, such as the following <img> element.
</p>
- <img height="48" width="72" alt="<acronym title="World Wide Web Consortium">W3C</acronym>" src="http://www.w3.org/Icons/w3c_home"/>
+ <img height="48" width="72" alt="<abbr title="World Wide Web Consortium">W3C</abbr>" src="http://www.w3.org/Icons/w3c_home"/>
<p>
For more information, see <a href="#empty-elements">Section 6.4 Void Elements</a>.
</p>
Received on Saturday, 15 September 2012 19:14:33 UTC