- From: Eliot Graff via cvs-syncmail <cvsmail@w3.org>
- Date: Wed, 26 Jan 2011 23:48:34 +0000
- To: public-html-commits@w3.org
Update of /sources/public/html5/html-xhtml-author-guide
In directory hutz:/tmp/cvs-serv22380
Modified Files:
html-xhtml-authoring-guide.html
Log Message:
Rewrote Attribute Values based on mail feedback
Index: html-xhtml-authoring-guide.html
===================================================================
RCS file: /sources/public/html5/html-xhtml-author-guide/html-xhtml-authoring-guide.html,v
retrieving revision 1.53
retrieving revision 1.54
diff -u -d -r1.53 -r1.54
--- html-xhtml-authoring-guide.html 13 Jan 2011 22:19:55 -0000 1.53
+++ html-xhtml-authoring-guide.html 26 Jan 2011 23:48:32 -0000 1.54
@@ -4,465 +4,8 @@
<head>
<title>Polyglot Markup: HTML-Compatible XHTML Documents</title>
<meta name="GENERATOR" content="MSHTML 8.00.7600.16588"/>
- <style type="text/css">
-
- /* --- INLINES --- */
- em.rfc2119 {
- text-transform: lowercase;
- font-variant: small-caps;
- font-style: normal;
- color: #900;
- }
-
- h1 acronym, h2 acronym, h3 acronym, h4 acronym, h5 acronym, h6 acronym, a acronym,
- h1 abbr, h2 abbr, h3 abbr, h4 abbr, h5 abbr, h6 abbr, a abbr {
- border: none;
- }
-
- dfn {
- font-weight: bold;
- }
-
- a.internalDFN {
- color: inherit;
- border-bottom: medium solid #99c;
- text-decoration: none;
- }
-
- a.externalDFN {
- color: inherit;
- border-bottom: medium dotted #ccc;
- text-decoration: none;
- }
-
- a.bibref {
- text-decoration: none;
- }
-
- code {
- color: #ff4500;
- }
-
-
- /* --- WEB IDL --- */
- pre.idl {
- border-top: 1px solid #90b8de;
- border-bottom: 1px solid #90b8de;
- padding: 1em;
- line-height: 120%;
- }
-
- pre.idl::before {
- content: "WebIDL";
- display: block;
- width: 150px;
- background: #90b8de;
- color: #fff;
- font-family: initial;
- padding: 3px;
- font-weight: bold;
- margin: -1em 0 1em -1em;
- }
-
- .idlType {
- color: #ff4500;
- font-weight: bold;
- text-decoration: none;
- }
-
- /*.idlModule*/
- /*.idlModuleID*/
- /*.idlInterface*/
- .idlInterfaceID {
- font-weight: bold;
- color: #005a9c;
- }
-
- .idlSuperclass {
- font-style: italic;
- color: #005a9c;
- }
-
- /*.idlAttribute*/
- .idlAttrType, .idlFieldType {
- color: #005a9c;
- }
- .idlAttrName, .idlFieldName {
- color: #ff4500;
- }
- .idlAttrName a, .idlFieldName a {
- color: #ff4500;
- border-bottom: 1px dotted #ff4500;
- text-decoration: none;
- }
-
- /*.idlMethod*/
- .idlMethType {
- color: #005a9c;
- }
- .idlMethName {
- color: #ff4500;
- }
- .idlMethName a {
- color: #ff4500;
- border-bottom: 1px dotted #ff4500;
- text-decoration: none;
- }
-
- /*.idlParam*/
- .idlParamType {
- color: #005a9c;
- }
- .idlParamName {
- font-style: italic;
- }
-
- .extAttr {
- color: #666;
- }
-
- /*.idlConst*/
- .idlConstType {
- color: #005a9c;
- }
- .idlConstName {
- color: #ff4500;
- }
- .idlConstName a {
- color: #ff4500;
- border-bottom: 1px dotted #ff4500;
- text-decoration: none;
- }
-
- /*.idlException*/
- .idlExceptionID {
- font-weight: bold;
- color: #c00;
- }
-
- .idlTypedefID, .idlTypedefType {
- color: #005a9c;
- }
-
- .idlRaises, .idlRaises a.idlType, .idlRaises a.idlType code, .excName a, .excName a code {
- color: #c00;
- font-weight: normal;
- }
-
- .excName a {
- font-family: monospace;
- }
-
- .idlRaises a.idlType, .excName a.idlType {
- border-bottom: 1px dotted #c00;
- }
-
- .excGetSetTrue, .excGetSetFalse, .prmNullTrue, .prmNullFalse, .prmOptTrue, .prmOptFalse {
- width: 45px;
- text-align: center;
- }
- .excGetSetTrue, .prmNullTrue, .prmOptTrue { color: #0c0; }
- .excGetSetFalse, .prmNullFalse, .prmOptFalse { color: #c00; }
-
- .idlImplements a {
- font-weight: bold;
- }
-
- dl.attributes, dl.methods, dl.constants, dl.fields {
- margin-left: 2em;
- }
-
- .attributes dt, .methods dt, .constants dt, .fields dt {
- font-weight: normal;
- }
-
- .attributes dt code, .methods dt code, .constants dt code, .fields dt code {
- font-weight: bold;
- color: #000;
- font-family: monospace;
- }
-
- .attributes dt code, .fields dt code {
- background: #ffffd2;
- }
-
- .attributes dt .idlAttrType code, .fields dt .idlFieldType code {
- color: #005a9c;
- background: transparent;
- font-family: inherit;
- font-weight: normal;
- font-style: italic;
- }
-
- .methods dt code {
- background: #d9e6f8;
- }
-
- .constants dt code {
- background: #ddffd2;
- }
-
- .attributes dd, .methods dd, .constants dd, .fields dd {
- margin-bottom: 1em;
- }
-
- table.parameters, table.exceptions {
- border-spacing: 0;
- border-collapse: collapse;
- margin: 0.5em 0;
- width: 100%;
- }
- table.parameters { border-bottom: 1px solid #90b8de; }
- table.exceptions { border-bottom: 1px solid #deb890; }
-
- .parameters th, .exceptions th {
- color: #fff;
- padding: 3px 5px;
- text-align: left;
- font-family: initial;
- font-weight: normal;
- text-shadow: #666 1px 1px 0;
- }
- .parameters th { background: #90b8de; }
- .exceptions th { background: #deb890; }
-
- .parameters td, .exceptions td {
- padding: 3px 10px;
- border-top: 1px solid #ddd;
- vertical-align: top;
- }
-
- .parameters tr:first-child td, .exceptions tr:first-child td {
- border-top: none;
- }
-
- .parameters td.prmName, .exceptions td.excName, .exceptions td.excCodeName {
- width: 100px;
- }
-
- .parameters td.prmType {
- width: 120px;
- }
-
- table.exceptions table {
- border-spacing: 0;
- border-collapse: collapse;
- width: 100%;
- }
-
- /* --- TOC --- */
- .toc a {
- text-decoration: none;
- }
-
- a .secno {
- color: #000;
- }
-
- /* --- TABLE --- */
- table.simple {
- border-spacing: 0;
- border-collapse: collapse;
- border-bottom: 3px solid #005a9c;
- }
-
- .simple th {
- background: #005a9c;
- color: #fff;
- padding: 3px 5px;
- text-align: left;
- }
-
- .simple th[scope="row"] {
- background: inherit;
- color: inherit;
- border-top: 1px solid #ddd;
- }
-
- .simple td {
- padding: 3px 10px;
- border-top: 1px solid #ddd;
- }
-
- .simple tr:nth-child(even) {
- background: #f0f6ff;
- }
-
- /* --- DL --- */
- .section dd > p:first-child {
- margin-top: 0;
- }
-
- .section dd > p:last-child {
- margin-bottom: 0;
- }
-
- .section dd {
- margin-bottom: 1em;
- }
-
- .section dl.attrs dd, .section dl.eldef dd {
- margin-bottom: 0;
- }
-
- /* --- EXAMPLES --- */
- pre.example {
- border-top: 1px solid #ff4500;
- border-bottom: 1px solid #ff4500;
- padding: 1em;
- margin-top: 1em;
- }
-
- pre.example::before {
- content: "Example";
- display: block;
- width: 150px;
- background: #ff4500;
- color: #fff;
- font-family: initial;
- padding: 3px;
- font-weight: bold;
- margin: -1em 0 1em -1em;
- }
-
- /* --- EDITORIAL NOTES --- */
- .issue {
- padding: 1em;
- margin: 1em 0em 0em;
- border: 1px solid #f00;
- background: #ffc;
- }
-
- .issue::before {
- content: "Issue";
- display: block;
- width: 150px;
- margin: -1.5em 0 0.5em 0;
- font-weight: bold;
- border: 1px solid #f00;
- background: #fff;
- padding: 3px 1em;
- }
-
- .note {
- margin: 1em 0em 0em;
- padding: 1em;
- border: 2px solid #cff6d9;
- background: #e2fff0;
- }
-
- .note::before {
- content: "Note";
- display: block;
- width: 150px;
- margin: -1.5em 0 0.5em 0;
- font-weight: bold;
- border: 1px solid #cff6d9;
- background: #fff;
- padding: 3px 1em;
- }
-
- /* --- Best Practices --- */
- div.practice {
- border: solid #bebebe 1px;
- margin: 2em 1em 1em 2em;
- }
-
- span.practicelab {
- margin: 1.5em 0.5em 1em 1em;
- font-weight: bold;
- font-style: italic;
- }
-
- span.practicelab { background: #dfffff; }
-
- span.practicelab {
- position: relative;
- padding: 0 0.5em;
- top: -1.5em;
- }
-
- p.practicedesc {
- margin: 1.5em 0.5em 1em 1em;
- }
-
- @media screen {
- p.practicedesc {
- position: relative;
- top: -2em;
- padding: 0;
- margin: 1.5em 0.5em -1em 1em;
- }
-
- /* --- SYNTAX HIGHLIGHTING --- */
- pre.sh_sourceCode {
- background-color: white;
- color: black;
- font-style: normal;
- font-weight: normal;
- }
-
- pre.sh_sourceCode .sh_keyword { color: #005a9c; font-weight: bold; } /* language keywords */
- pre.sh_sourceCode .sh_type { color: #666; } /* basic types */
- pre.sh_sourceCode .sh_usertype { color: teal; } /* user defined types */
- pre.sh_sourceCode .sh_string { color: red; font-family: monospace; } /* strings and chars */
- pre.sh_sourceCode .sh_regexp { color: orange; font-family: monospace; } /* regular expressions */
- pre.sh_sourceCode .sh_specialchar { color: #ffc0cb; font-family: monospace; } /* e.g., \n, \t, \\ */
- pre.sh_sourceCode .sh_comment { color: #A52A2A; font-style: italic; } /* comments */
- pre.sh_sourceCode .sh_number { color: purple; } /* literal numbers */
- pre.sh_sourceCode .sh_preproc { color: #00008B; font-weight: bold; } /* e.g., #include, import */
- pre.sh_sourceCode .sh_symbol { color: blue; } /* e.g., *, + */
- pre.sh_sourceCode .sh_function { color: black; font-weight: bold; } /* function calls and declarations */
- pre.sh_sourceCode .sh_cbracket { color: red; } /* block brackets (e.g., {, }) */
- pre.sh_sourceCode .sh_todo { font-weight: bold; background-color: #00FFFF; } /* TODO and FIXME */
-
- /* Predefined variables and functions (for instance glsl) */
- pre.sh_sourceCode .sh_predef_var { color: #00008B; }
- pre.sh_sourceCode .sh_predef_func { color: #00008B; font-weight: bold; }
-
- /* for OOP */
- pre.sh_sourceCode .sh_classname { color: teal; }
-
- /* line numbers (not yet implemented) */
- pre.sh_sourceCode .sh_linenum { display: none; }
-
- /* Internet related */
- pre.sh_sourceCode .sh_url { color: blue; text-decoration: underline; font-family: monospace; }
-
- /* for ChangeLog and Log files */
- pre.sh_sourceCode .sh_date { color: blue; font-weight: bold; }
- pre.sh_sourceCode .sh_time, pre.sh_sourceCode .sh_file { color: #00008B; font-weight: bold; }
- pre.sh_sourceCode .sh_ip, pre.sh_sourceCode .sh_name { color: #006400; }
-
- /* for Prolog, Perl... */
- pre.sh_sourceCode .sh_variable { color: #006400; }
-
- /* for LaTeX */
- pre.sh_sourceCode .sh_italics { color: #006400; font-style: italic; }
- pre.sh_sourceCode .sh_bold { color: #006400; font-weight: bold; }
- pre.sh_sourceCode .sh_underline { color: #006400; text-decoration: underline; }
- pre.sh_sourceCode .sh_fixed { color: green; font-family: monospace; }
- pre.sh_sourceCode .sh_argument { color: #006400; }
- pre.sh_sourceCode .sh_optionalargument { color: purple; }
- pre.sh_sourceCode .sh_math { color: orange; }
- pre.sh_sourceCode .sh_bibtex { color: blue; }
-
- /* for diffs */
- pre.sh_sourceCode .sh_oldfile { color: orange; }
- pre.sh_sourceCode .sh_newfile { color: #006400; }
- pre.sh_sourceCode .sh_difflines { color: blue; }
-
- /* for css */
- pre.sh_sourceCode .sh_selector { color: purple; }
- pre.sh_sourceCode .sh_property { color: blue; }
- pre.sh_sourceCode .sh_value { color: #006400; font-style: italic; }
-
- /* other */
- pre.sh_sourceCode .sh_section { color: black; font-weight: bold; }
- pre.sh_sourceCode .sh_paren { color: red; }
- pre.sh_sourceCode .sh_attribute { color: #006400; }
- </style>
<link rel="stylesheet" type="text/css" href="http://www.w3.org/StyleSheets/TR/W3C-ED"/>
+ <link rel="stylesheet" type="text/css" href="http://dev.w3.org/2009/dap/ReSpec.js/css/respec.css"/>
</head>
<body style="display: inherit;">
@@ -471,7 +14,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-05-january-2011">W3C Editor's Draft 13 January 2011</h2>
+ <h2 id="w3c-editor-s-draft-05-january-2011">W3C Editor's Draft 26 January 2011</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>
@@ -898,7 +441,7 @@
<!--End section: Element Names-->
</div>
-
+
<div id="attribute-names" class="section">
<h4><span class="secno">6.3.2 </span>Attribute Names</h4>
<p><a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> uses the correct case for attribute names.</p>
@@ -977,71 +520,51 @@
<!--End section: Attribute Names-->
</div>
+
<div id="attribute-values" class="section">
<h4><span class="secno">6.3.3 </span>Attribute Values</h4>
<p>
- <a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a>
- requires the case used for characters in the values of the following
-attributes to be consistent between markup, DOM APIs, and CSS
+ For characters in attribute values, <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a> maintains case consistency 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, <a class="internalDFN" href="#dfn-polyglot-markup">polyglot markup</a>
- respects the case sensitivity of all 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>
- <ul>
- <li><code>accept</code></li>
- <li><code>accept-charset</code></li>
- <li><code>align</code></li>
- <li><code>alink</code></li>
- <li><code>axis</code></li>
- <li><code>bgcolor</code></li>
- <li><code>charset</code></li>
- <li><code>checked</code></li>
- <li><code>clear</code></li>
- <li><code>codetype</code></li>
- <li><code>color</code></li>
- <li><code>compact</code></li>
- <li><code>declare</code></li>
- <li><code>defer</code></li>
- <li><code>dir</code></li>
- <li><code>direction</code></li>
- <li><code>disabled</code></li>
- <li><code>enctype</code></li>
- <li><code>face</code></li>
- <li><code>frame</code></li>
- <li><code>hreflang</code></li>
- <li><code>http-equiv</code></li>
- <li><code>lang</code></li>
- <li><code>language</code></li>
- <li><code>link</code></li>
- <li><code>media</code></li>
- <li><code>method</code></li>
- <li><code>multiple</code></li>
- <li><code>nohref</code></li>
- <li><code>noresize</code></li>
- <li><code>noshade</code></li>
- <li><code>nowrap</code></li>
- <li><code>readonly</code></li>
- <li><code>rel</code></li>
- <li><code>rev</code></li>
- <li><code>rules</code></li>
- <li><code>scope</code></li>
- <li><code>scrolling</code></li>
- <li><code>selected</code></li>
- <li><code>shape</code></li>
- <li><code>target</code></li>
- <li><code>text</code></li>
- <li><code>type</code></li>
- <li><code>valign</code></li>
- <li><code>valuetype</code></li>
- <li><code>vlink</code></li>
- </ul>
+ <p>
+ <a class="internalDFN" href="#dfn-polyglot-markup" title="polyglot markup">Polyglot markup</a> maintains case consistency for values on the following attributes, which occur on
+ MIME types, language tags, charsets, booleans, media queries, and keywords.
+ Though not required, an easy way to maintain case-consistency is to use only lower case values for these attributes.
+ <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>]
+
+ </p>
+ <ul>
+ <li><code>accept</code></li>
+ <li><code>accept-charset</code></li>
+ <li><code>charset</code></li>
+ <li><code>checked</code></li>
+ <li><code>defer</code></li>
+ <li><code>dir</code></li>
+ <li><code>direction</code></li>
+ <li><code>disabled</code></li>
+ <li><code>enctype</code></li>
+ <li><code>hreflang</code></li>
+ <li><code>http-equiv</code></li>
+ <li><code>lang</code></li>
+ <li><code>media</code></li>
+ <li><code>method</code></li>
+ <li><code>multiple</code></li>
+ <li><code>readonly</code></li>
+ <li><code>rel</code> (for values that do not contain a colon)</li>
+ <li><code>scope</code></li>
+ <li><code>selected</code></li>
+ <li><code>shape</code></li>
+ <li><code>target</code> (keywords only; browsing context names are case-sensitive)</li>
+ <li><code>type</code> (on <code>a</code>, <code>link</code>, <code>object</code>, <code>script</code>, or <code>style</code> elements)</li>
+ <li><code>type</code> (on input)</li>
+ </ul>
+ <p>
+ Note that other specifications, such as RDFa, may place additional restrictions on the allowed values of certain attributes.
+ </p>
<!--End section: Attribute Values-->
</div>
<!--End section: Case-Sensitivity-->
@@ -1434,7 +957,6 @@
<!--End section: Example Document-->
</div>
-
<div id="acknowledgements" class="appendix section">
<!--OddPage--><h2><span class="secno">A. </span>Acknowledgements</h2>
<p>
Received on Wednesday, 26 January 2011 23:48:35 UTC