/[suikacvs]/test/html-webhacc/error-description.en.html.u8
Suika

Contents of /test/html-webhacc/error-description.en.html.u8

Parent Directory Parent Directory | Revision Log Revision Log


Revision 1.8 - (hide annotations) (download)
Sun Sep 2 07:59:01 2007 UTC (17 years, 3 months ago) by wakaba
Branch: MAIN
Changes since 1.7: +50 -2 lines
++ ChangeLog	2 Sep 2007 07:58:58 -0000
2007-08-26  Wakaba  <wakaba@suika.fam.cx>

	* cc.cgi: New catalog macros |local-name| and |element-local-name|.

1 wakaba 1.1 <!DOCTYPE html><html id="error-description" lang="en" xmlns:d="http://suika.fam.cx/~wakaba/archive/2007/wdcc-desc/" xmlns="http://www.w3.org/1999/xhtml">
2     <head>
3     <title xml:lang="en">Description of Errors —
4     Web Document Conformance Checker (BETA)</title>
5     <link href="cc-style" rel="stylesheet">
6     <link href="#license" rel="license">
7     </head>
8     <body>
9     <h1>Description of Errors</h1>
10    
11 wakaba 1.2 <section id="html5-tokenize-error">
12     <h2>HTML5 Parse Errors in Tokenization Stage</h2>
13 wakaba 1.1
14 wakaba 1.3 <div class="section parse-error" id="after-html"><h3>Tag <code>&lt;<var>$0</var>&gt;</code>
15     is not allowed after the end tag <code>&lt;/html&gt;</code>.</h3>
16     <p>The start or end tag of an element appears after the
17     <code>html</code> element has been closed. The document is
18     non-conforming.</p>
19    
20     <p>Any content of the document other than comments
21     must be put into the <code>html</code> element.</p>
22     </div>
23    
24 wakaba 1.7 <div class="section parse-error" id="after-body"><h3>Tag <code>&lt;<var>$0</var>&gt;</code>
25     is not allowed after the end tag <code>&lt;/body&gt;</code>.</h3>
26     <p>The start or end tag of an element appears after the
27     <code>body</code> element has been closed. The document is
28     non-conforming.</p>
29    
30     <p>Any content of the document other than <code>head</code>
31     contents and comments must be put into the <code>body</code>
32     element.</p>
33     </div>
34    
35 wakaba 1.3 <div class="section tokenize-error" id="bare-ero"><h3>The <code>&amp;</code> character must
36     introduce a reference.</h3>
37     <p>An <code>&amp;</code> (<code>U+0026</code>
38     <code class="charname">AMPERSAND</code>) character which
39     is not part of any reference appears in the input stream.
40     The document is non-conforming.</p>
41    
42     <p>The <code>&amp;</code> character must
43     be the first character of a reference:
44     <dl>
45     <dt>Named entity reference</dt>
46     <dd><pre class="html example">
47     <code>&amp;<var>entity-name</var>;</code></pre>
48     where <var>entity-name</var> is the name of the
49     character entity to be referenced.</dd>
50     <dt>Numeric character reference</dt>
51     <dd><pre class="html example">
52     <code>&amp;#<var>d</var>;</code></pre>
53     where <var>d</var> is the decimal representation of
54     the code position of the character to be referenced.</dd>
55     <dt>Hexadecimal character reference</dt>
56     <dd><pre class="html example">
57     <code>&amp;#x<var>h</var>;</code></pre>
58     where <var>h</var> is the hexadecimal representation
59     of the code position of the character to be referenced.</dd>
60     </dl>
61     </p>
62    
63     <p>To represent <code>&amp;</code> as a data character, use
64     named entity reference:
65     <pre class="html example">
66     <code>&amp;amp;</code></pre>
67     </p>
68     </div>
69    
70 wakaba 1.7 <div class="section tokenize-error" id="bare-etago"><h3>A <code>&lt;/</code> string is not followed
71     by a tag name.</h3>
72     <p>There is a <code>&lt;</code> (<code>U+003C</code>
73     <code class="charname">LESS-THAN SIGN</code>) character
74     immediately followed by a <code>/</code> (<code>U+005F</code>
75     <code>SOLIDUS</code>) character, which is not part
76     of any end tag, in the input stream. The document
77     is non-conforming.</p>
78    
79     <p>The <code>&lt;/</code> sequence immediately followed
80     by an <abbr title="End of file pseudo-character">EOF</abbr> is
81     interpreted as a string data of <code>&lt;/</code>.</p>
82    
83     <p>The <code>&lt;/</code> sequence as string data must
84     be escaped as:
85     <pre class="html example">
86     <code>&amp;lt;/</code></pre>
87     </p>
88     </div>
89    
90 wakaba 1.4 <div class="section tokenize-error" id="bare-stago"><h3>A <code>&lt;</code> character is not followed
91     by tag name or by a <code>!</code> character.</h3>
92 wakaba 1.6 <p>A <code>&lt;</code> (<code>U+003C</code>
93     <code class="charname">LESS-THAN SIGN</code>) character which is not part
94     of any markup appears in the input stream.</p>
95 wakaba 1.4
96     <p>The <code>&lt;</code> character as a data character must
97     be escaped as:
98     <pre class="html example">
99 wakaba 1.6 <code>&amp;lt;</code></pre>
100 wakaba 1.4 </p>
101     </div>
102    
103 wakaba 1.3 <div class="section tokenize-error" id="bare-nero"><h3>The decimal representation of the code position
104     of a character must be specified after <code>&amp;#</code>.</h3>
105     <p>An <code>&amp;</code> (<code>U+0026</code>
106     <code class="charname">AMPERSAND</code>) character immediately
107     followed by a <code>#</code> (<code>U+0023</code>
108     <code>NUMBER SIGN</code>) character which
109     is not part of any reference appears in the input stream.
110     The document is non-conforming.</p>
111    
112     <p>The string <code>&amp;#</code> must be the first two characters
113     of a reference:
114     <dl>
115     <dt>Numeric character reference</dt>
116     <dd><pre class="html example">
117     <code>&amp;#<var>d</var>;</code></pre>
118     where <var>d</var> is the decimal representation of
119     the code point of the character to be referenced.</dd>
120     <dt>Hexadecimal character reference</dt>
121     <dd><pre class="html example">
122     <code>&amp;#x<var>h</var>;</code></pre>
123     where <var>h</var> is the hexadecimal representation
124     of the code point of the character to be referenced.</dd>
125     </dl>
126     </p>
127    
128     <p>To represent <code>&amp;#</code> as data characters, use
129 wakaba 1.6 a named entity reference for the <code>&amp;</code> character:
130 wakaba 1.3 <pre class="html example">
131     <code>&amp;amp;#</code></pre>
132     </p>
133     </div>
134    
135     <div class="section tokenize-error" id="bare-hcro"><h3>The hexadecimal representation of the code position
136     of a character must be specified after <code>&amp;#x</code>.</h3>
137     <p>The string <code>&amp;#x</code> or <code>&amp;#X</code> which
138     is not part of any reference appears in the input stream.
139     The document is non-conforming.</p>
140    
141     <p>The string <code>&amp;#x</code> or <code>&amp;#X</code> must
142     be the first three characters of a hexadecimal reference:
143     <pre class="html example">
144     <code>&amp;#x<var>h</var>;</code></pre>
145     where <var>h</var> is the hexadecimal representation
146     of the code point of the character to be referenced.</p>
147    
148     <p>To represent <code>&amp;#x</code> as data characters, use
149 wakaba 1.6 a named entity reference for the <code>&amp;</code> character:
150 wakaba 1.3 <pre class="html example">
151     <code>&amp;amp;#x</code></pre>
152     </p>
153     </div>
154    
155 wakaba 1.7 <div class="section tokenize-error" id="bogus-end-tag"><h3>A <code>&lt;/</code> string is not followed
156     by a tag name.</h3>
157     <p>There is a <code>&lt;</code> (<code>U+003C</code>
158     <code class="charname">LESS-THAN SIGN</code>) character
159     immediately followed by a <code>/</code> (<code>U+005F</code>
160     <code>SOLIDUS</code>) character, which is not part
161     of any end tag, in the input stream. The document
162     is non-conforming.</p>
163    
164     <p>The <code>&lt;/</code> sequence not followed by a
165     tag name is parsed as an opening of bogus comment.</p>
166    
167     <p>The <code>&lt;/</code> sequence as string data must
168     be escaped as:
169     <pre class="html example">
170     <code>&amp;lt;/</code></pre>
171     </p>
172     </div>
173    
174 wakaba 1.4 <div class="section tokenize-error" id="dash-in-comment"><h3>There is a <code>--</code> sequence
175     in a comment.</h3>
176     <p>There is a <code>-</code> (<code>U+002D</code>
177     <code class="charname">HYPHEN-MINUS</code>) character
178     at the end of the comment or a <code>--</code> sequence
179     in the comment. The document is non-conforming.</p>
180    
181     <p>Comments cannot contain a string <code>--</code>, as in XML.
182     Unlike SGML, there cannot be more than one comments
183     (where <i>comment</i> is an SGML term) in the comment
184     declaration.</p>
185     </div>
186    
187 wakaba 1.6 <div class="section tokenize-error" id="duplicate-attribute"><h3>There are two attributes with name
188     <code><var>$0</var></code>.</h3>
189 wakaba 1.3 <p>There are more than one attributes with the same
190     name in a tag. The document is non-conforming.</p>
191 wakaba 1.1
192     <p>The <code>motion</code> attribute is not part of the HTML standard.
193     Use <code>img</code> element with animation GIF instead.</p>
194     </div>
195    
196     <div class="section tokenize-error" id="nestc"><h3>Void element syntax (<code>/&gt;</code>) cannot be
197     used for this element.</h3>
198 wakaba 1.3 <p>Void element syntax (<code>/&gt;</code>) must not be used
199     for the element. The document is non-conforming.</p>
200    
201     <p>The void element syntax can only be
202 wakaba 1.1 used for <code>base</code>, <code>link</code>, <code>meta</code>,
203     <code>hr</code>, <code>br</code>, <code>img</code>,
204     <code>embed</code>, <code>param</code>, <code>area</code>,
205 wakaba 1.3 <code>col</code>, and <code>input</code> elements.</p>
206 wakaba 1.1
207 wakaba 1.3 <p>Note that, unlike in XML, the void element syntax has
208 wakaba 1.1 no effect in HTML.</p>
209     </div>
210    
211 wakaba 1.5
212     <div class="section tokenize-error" id="pio"><h3>Processing instruction
213     (<code>&lt;?<var>...</var>?&gt;</code>) cannot be used.</h3>
214     <p>Processing instructions (<code>&lt;?<var>...</var>?&gt;</code>),
215     including XML declaration (<code>&lt;?xml <var>...</var>?&gt;</code>)
216     and XML style sheet <abbr title="processing instruction">PI</abbr>
217     (<code>&lt;xml-stylesheet <var>...</var>?&gt;</code>), are not allowed
218     in the HTML syntax. The document is non-conforming.</p>
219    
220     <p>If it is necessary to embed a processing instruction
221     in the HTML document, you must use the XML syntax instead.</p>
222    
223     <p>In the HTML syntax, XML declaration is not necessary.</p>
224    
225     <p>Instead of XML style sheet,
226     <abbr title="processing instruction">PI</abbr>s, you must
227     use the HTML <code>link</code> element whose <code>rel</code>
228 wakaba 1.6 attribute is set to <code>stylesheet</code> (or
229     <code>alternate stylesheet</code> for an aleternate style sheet).</p>
230 wakaba 1.5
231     <p>Web browsers will parse processing instructions as bogus
232     comments. Some legacy Web browsers, such as IE:mac and
233     some mobile browsers, will display processing instructions
234     as string.</p>
235     </div>
236    
237 wakaba 1.1 </section>
238    
239 wakaba 1.2 <section id="html5-parse-errors">
240     <h2>HTML5 Parse Errors in Tree Construction Stage</h2>
241    
242     <div class="section parse-error" id="after-head"><h3>The <code><var>$0</var></code> element cannot be
243     inserted between <code>head</code> and <code>body</code> elements.</h3>
244 wakaba 1.3 <p>A start tag appears after the <code>head</code> element is closed
245 wakaba 1.2 but before the <code>body</code> element is opened.
246     The document is non-conforming.</p>
247     </div>
248    
249 wakaba 1.4 <div class="section parse-error" id="DOCTYPE-in-the-middle"><h3>A <code>DOCTYPE</code> appears after any
250     element or data character has been seen.</h3>
251     <p>A <code>DOCTYPE</code> appears after any element or data character
252     has been seen. The document is non-conforming.</p>
253    
254     <p>The <code>DOCTYPE</code> must be placed before any
255     tag, reference, or data character. Only white space characters
256     and comments can be inserted before the <code>DOCTYPE</code>.</p>
257     </div>
258    
259 wakaba 1.5 <div class="section parse-error" id="in-a:a"><h3>Anchor cannot be nested.</h3>
260     <p>HTML <code>a</code> elements cannot be nested.
261     The document is non-conforming.</p>
262    
263     <p>In the HTML syntax, a start tag of the <code>a</code>
264     implies the end tag of any opening <code>a</code> element.</p>
265     </div>
266    
267 wakaba 1.4 <div class="section parse-error" id="in-body"><h3>Tag <code>&lt;<var>$0</var>&gt;</code>
268 wakaba 1.6 is not allowed in a <code>body</code> element.</h3>
269 wakaba 1.4 <p>The start or end tag of an element, which
270     cannot be a descendant of <code>body</code> element, appears
271     in the input stream while the <code>body</code> element has been opened.
272     The document is non-conforming.</p>
273     </div>
274    
275 wakaba 1.6 <div class="section parse-error" id="in-head:head"><h3>Start tag <code>&lt;<var>head</var>&gt;</code>
276     is not allowed in the <code>head</code> element.</h3>
277     <p>There is a start tag <code>&lt;head&gt;</code> in the
278     <code>&lt;head&gt;</code> element. The document is non-conforming.</p>
279    
280     <p>In an HTML document there must not be more than
281     one <code>head</code> element, therefore no more than one
282     start tag <code>&lt;head&gt;</code> can appear in the input stream.</p>
283     </div>
284    
285 wakaba 1.3 <div class="section parse-error" id="in-table"><h3>Tag <code>&lt;<var>$0</var>&gt;</code>
286 wakaba 1.6 is not allowed in a <code>table</code> element.</h3>
287 wakaba 1.4 <p>The start or end tag of an element, which
288     cannot be a child of <code>table</code> element, appears
289     in the input stream while the <code>table</code> element has been opened
290     but no other element has been opened. The document is non-conforming.</p>
291 wakaba 1.3
292     <p>In <code>table</code>, only table related elements
293     are allowed; any other element must be contained in
294     <code>td</code> or <code>th</code> element to form
295     a part of the table, or <code>caption</code> element to create
296     a table caption.</p>
297     </div>
298    
299     <div class="section parse-error" id="in-table:#character"><h3>Data character is not allowed in
300     <code>table</code>.</h3>
301     <p>A data character appears in <code>table</code>. The document
302     is non-conforming.</p>
303    
304     <p>In <code>table</code>, only table related elements
305     are allowed; any other element and data character must be contained in
306     <code>td</code> or <code>th</code> element to form
307     a part of the table, or <code>caption</code> element to create
308     a table caption.</p>
309     </div>
310    
311     <div class="section parse-error" id="missing-start-tag:tr"><h3>Start tag of <code>tr</code>
312     element is missing.</h3>
313     <p>Start tag of a <code>tr</code> element, which is <em>not</em>
314     optional, is missing. The document is non-conforming.</p>
315    
316     <p>In a table section, a <code>&lt;tr&gt;</code> start tag
317     must occur before any <code>&lt;td&gt;</code> or
318     <code>&lt;th&gt;</code> start tag. Though the HTML5 parser
319     implies the <code>&lt;tr&gt;</code> start tag before
320     these start tags, it must be explicitly specified.</p>
321     </div>
322    
323 wakaba 1.6 <div class="section parse-error" id="no-DOCTYPE"><h3>This document does not start with a
324 wakaba 1.3 <code>DOCTYPE</code>.</h3>
325     <p>The document does not start with a <code>DOCTYPE</code>.
326     The document is non-conforming.</p>
327    
328     <p>An HTML document must start by a <code>DOCTYPE</code>:
329     <pre class="html example">
330     <code>&lt;!DOCTYPE HTML&gt;</code></pre>
331     </p>
332    
333     <p>Only white space characters and comments are allowed
334     before the <code>DOCTYPE</code>.</p>
335     </div>
336 wakaba 1.2
337     <div class="section parse-error" id="not-closed"><h3>Element <code><var>$0</var></code> is not
338 wakaba 1.3 closed.</h3>
339     <p>End tag of an element is not found before, for example,
340     an end tag of another element appears or
341     the end of the document. The document is non-conforming.</p>
342     </div>
343 wakaba 1.2
344 wakaba 1.6 <div class="section parse-error" id="not-first-start-tag"><h3>This <code>&lt;html&gt;</code> tag is not
345     the first start tag.</h3>
346     <p>There is a start tag of the <code>html</code> element
347     that it not the first start tag in the input stream.
348     The document is non-conforming.</p>
349    
350     <p>In an HTML document, there cannot be more than one
351     <code>html</code> element and therefore there cannot be
352     more than one <code>&lt;html&gt;</code> tag. In addition,
353     nothing can be placed before the <code>&lt;html&gt;</code> tag
354     except a <code>DOCTYPE</code>, white space characters,
355     and comments.</p>
356     </div>
357    
358 wakaba 1.2 <div class="section parse-error" id="not-HTML5"><h3>This document is written in an old version of
359 wakaba 1.3 HTML.</h3>
360     <p>The document contains a <code>DOCTYPE</code> declaration
361 wakaba 1.6 that is different from HTML5 <code>DOCTYPE</code> (i.e.
362     <code>&lt;!DOCTYPE HTML&gt;</code>). The document is non-conforming.</p>
363 wakaba 1.3
364     <p>The document might or might not be conformant to
365     some version of HTML. However, conformance to any HTML
366     specification other than HTML5 provides for no practical
367     convenience, since Web borwsers will parse any
368     HTML document (roughly) as defined in HTML5.</p>
369     </div>
370 wakaba 1.2
371     <div class="section parse-error" id="unmatched-end-tag"><h3>Element <code><var>$0</var></code> is not
372 wakaba 1.4 opened.</h3>
373     <p>An end tag appears though no element with the same name
374     has been opened. The document is non-conforming.</p>
375    
376     <p>For any end tag in HTML document, there must be a
377     corresponding start tag.</p>
378     </div>
379 wakaba 1.2
380     </section>
381    
382 wakaba 1.1 <section id="element-content-model-errors">
383     <h2>Element Content Model Errors</h2>
384    
385     <div class="section content-model-error" id="character-not-allowed"><h3>Data character is not allowed in this
386     context.</h3>
387 wakaba 1.3 <p>A data character appears where it is not allowed in this
388 wakaba 1.1 context. The document is non-conforming.</p>
389    
390     <p>Possible causes:
391 wakaba 1.6 <ul>
392     <li><p>A data character cannot be a child
393     of certain sectioning elements such as <code>body</code>,
394     <code>section</code>, and <code>blockquote</code>.</p>
395    
396     <p>Any inline-level content must be put
397     in e.g. paragraph element such as <code>p</code>.</p></li>
398     <li><p>Though some elements such as <code>div</code>,
399     <code>li</code>, and <code>td</code> allow
400     <em>either one</em> of block-level or inline-level content
401     is allowed. If there is a block-level content,
402     any inline-level content must be put
403     in e.g. paragraph element such as <code>p</code>.</p></li>
404     </ul>
405 wakaba 1.1 </p>
406     </div>
407    
408     <div class="section content-model-error" id="child-element-missing"><h3>There must be a <code><var>$0</var></code>
409     element as a child of this element.</h3>
410     <p>The content model of the element is so defined that it
411     must contain a <code><var>$0</var></code> child element.
412 wakaba 1.3 The document is non-conforming.</p>
413 wakaba 1.1
414     <p>For example:
415     <ul>
416     <li>The <code>head</code> element must contain exactly one
417     <code>title</code> child element.</li>
418     <li><a href="#child-element-missing:td%7Cth">The <code>tr</code>
419     element must contain one or more <code>td</code> or <code>th</code>
420     child element.</a></li>
421     </ul>
422     </p>
423     </div>
424    
425     <div class="section content-model-error" id="child-element-missing:td|th"><h3>There must be a <code>td</code>
426     or <code>th</code> element as a child of this element.</h3>
427     <p>The <code>tr</code> element must contain at least one
428 wakaba 1.3 <code>td</code> or <code>th</code> child element. The document
429     is non-conforming.</p>
430 wakaba 1.1 </div>
431    
432     <div class="section content-model-error" id="element-not-allowed"><h3>This element is not allowed in this
433     context.</h3>
434 wakaba 1.3 <p>An element appears where it is not allowed. The document
435 wakaba 1.1 is non-conforming.</p>
436    
437 wakaba 1.3 <p><strong>Note</strong>: The conformance checker does
438     <em>not</em> support form elements yet.</p>
439    
440 wakaba 1.1 <p>Possible causes:
441 wakaba 1.6 <dl class="switch">
442     <dt>If the element with the error is an inline-level element,
443     such as <code>a</code>, <code>progress</code>, or <code>img</code></dt>
444 wakaba 1.1 <dd><p>An inline-level element cannot be a child
445     of certain sectioning elements such as <code>body</code>,
446     <code>section</code>, and <code>blockquote</code>.</p>
447    
448     <p>Any inline-level content must be put
449     in e.g. paragraph element such as <code>p</code>.</p></dd>
450 wakaba 1.6 <dt>If the element with the error is a block-level element,
451     such as <code>div</code>, <code>h<var>n</var></code>, or
452     <code>section</code></dt>
453 wakaba 1.1 <dd><p>Though some elements such as <code>div</code>,
454     <code>li</code>, and <code>td</code> allow
455     <em>either one</em> of block-level or inline-level content
456     is allowed. If there is a block-level content,
457     any inline-level content must be put
458     in e.g. paragraph element such as <code>p</code>.</p></dd>
459 wakaba 1.6 <dt>If the element with the error is a <code>noscript</code> element</dt>
460     <dd>The <code>noscript</code> element is allowed only in the context
461     where a block-level or inline-level content is expected
462     and in the <code>head</code> element.
463     It cannot be used in e.g. <code>ul</code>, <code>table</code>,
464     or <code>select</code>.</dd>
465     <dt>If the element with the error is the <code>html</code> element
466     that is the root element of an XHTML document</dt>
467 wakaba 1.1 <dd><p>In an XHTML document, the root <code>html</code>
468     element must have an <code>xmlns</code> attribute
469     whose value is set to
470     <code>http://www.w3.org/1999/xhtml</code>.</p></dd>
471 wakaba 1.8 <dt>If the element with the error is <code>blink</code>,
472     <code>center</code>, or <code>marquee</code> element</dt>
473     <dd>These elements are not part of the HTML standard.
474     Use CSS for styling control.</dd>
475 wakaba 1.1 </dl>
476     </p>
477     </div>
478    
479 wakaba 1.6 <div class="section content-model-error" id="ps-element-missing"><h3>There is no <code><var>$0</var></code>
480     element before this element.</h3>
481     <p>There must be an element before another element, but there
482     is not. The document is non-conforming.</p>
483    
484     <p>For example, there must be a <code>dt</code> element
485     before any <code>dd</code> element.</p>
486     </div>
487    
488 wakaba 1.2 </section>
489    
490 wakaba 1.3 <section id="attribute-errors">
491     <h2>Attribute Errors</h2>
492    
493     <div class="section attribute-error" id="attribute-missing"><h3>Required attribute <code><var>$0</var></code>
494     is not specified.</h3>
495     <p>A required attribute is not specified. The document
496     is non-conforming.</p>
497    
498     <p>Some attribute is defined as <i>required</i>.
499     For example, any <code>img</code> element must have
500     <code>alt</code> and <code>src</code> attributes specified.
501     Without required attributes specified, user agents
502     cannot provide the full functionality of the element
503     to the user.</p>
504     </div>
505    
506 wakaba 1.8 <div class="section attribute-error" id="attribute-not-allowed"><h3>Attribute
507     <code><var>{local-name}</var></code> is not allowed for
508     <code><var>{element-local-name}</var></code> element.</h3>
509     <p>An attribute is specified where it is not allowed.
510     The document is non-conforming.</p>
511    
512     <dl>
513     <dt>HTML <code>meta</code> element</dt>
514     <dd>For HTML <code>meta</code> element, <em>only one</em> of
515     <code>name</code>, <code>http-equiv</code>, or <code>charset</code>
516     attribute is allowed.</dd>
517     </dl>
518     </div>
519    
520 wakaba 1.3 <div class="section attribute-error" id="in-HTML:xml:lang"><h3>The <code>xml:lang</code> attribute is not
521     allowed in HTML document.</h3>
522     <p>The <code>xml:lang</code> attribute is not allowed in
523     HTML document. The document is non-conforming.</p>
524    
525 wakaba 1.4 <p>The <code>lang</code> attribute in the <code>null</code>
526     namespace for HTML elements is defined as conforming <em>only</em> for
527 wakaba 1.3 XML document.</p>
528    
529     <p>To specify natural language information in HTML document,
530     use <code>lang</code> attribute instead.</p>
531 wakaba 1.6
532     <p>XHTML 1.0 Appendix C was encouraged to specify both
533     <code>lang</code> and <code>xml:lang</code> attributes with
534     the same value. Such a duplication has <em>no effect</em> in practice.
535     Use only one of <code>lang</code> (in HTML) or <code>xml:lang</code> (in
536     XML).</p>
537    
538 wakaba 1.3 <!-- @@ ISSUE: xml:lang in non-HTML element in DOM5 HTML created
539     from an HTML document? -->
540     </div>
541    
542     <div class="section attribute-error" id="in-XML:charset"><h3>The <code>charset</code> attribute is not
543     allowed in XML document.</h3>
544     <p>The <code>charset</code> attribute of a
545     <code>meta</code> element is not allowed in XML document.
546     The document is non-conforming.</p>
547    
548     <p>To specify the character encoding used for serialization,
549     if necessary, use XML declaration instead:
550     <pre class="xml example">
551     <code>&lt;?xml version=&quot;1.0&quot; encoding=&quot;<var>encoding-name</var>&quot;?&gt;</code></pre>
552     </p>
553     </div>
554    
555     <div class="section attribute-error" id="in-XML:lang"><h3>The <code>lang</code> attribute is not
556     allowed in XML document.</h3>
557     <p>The HTML <code>lang</code> attribute is not allowed in
558     XML document. The document is non-conforming.</p>
559    
560     <p>The <code>lang</code> attribute in <code>null</code>
561 wakaba 1.4 namespace for HTML elements is defined as conforming <em>only</em> for
562 wakaba 1.3 HTML document.</p>
563    
564     <p>To specify natural language information in XML document,
565     use <code>xml:lang</code> attribute instead.</p>
566     </div>
567    
568     <div class="section attribute-error" id="in-XML:xmlns"><h3>The <code>xmlns</code> attribute
569     in the <code>null</code> namespace is not allowed in
570     XHTML document. The document is non-conforming.</h3>
571     <p>The <code>xmlns</code> attribute in the <code>null</code>
572     namespace is not allowed in XHTML document.</p>
573    
574     <p>This error should not occur in conformance-checking
575     static documents.</p>
576     </div>
577    
578     </section>
579    
580 wakaba 1.2 <section id="attribute-value-errors">
581     <h2>Attribute Value Errors</h2>
582    
583 wakaba 1.3 <div class="section attribute-value-error" id="enumerated:invalid"><h3>This attribute only allow a limited set of
584 wakaba 1.6 values and the specified value <code><var>{@}</var></code> is not one
585 wakaba 1.8 of them.</h3>
586     <p>For this attribute only several values are allowed and the
587     value of the attribute is not one of them. The document
588     is non-conforming.</p>
589    
590     <dl>
591     <dt>HTML <code>meta</code> element, <code>http-equiv</code> attribute</dt>
592     <dd><p>Only <code>Default-Style</code> and <code>Refresh</code>
593     is allowed.</p>
594     <p>Value <code>Content-Type</code> is obsolete; for charset
595     declaration, the <code>charset</code> attribute can be used as:
596     <pre class="html example">
597     <code>&lt;meta charset=&quot;<var>charset-name</var>&quot;&gt;</code></pre>
598     ... where <var>charset-name</var> is a name of the character encoding
599     of the document, such as <code>utf-8</code>.</p>
600     <p>Values <code>Content-Style-Type</code> and
601     <code>Content-Script-Type</code> are currently not allowed.</p>
602     <p>Value <code>Keywords</code> is not allowed. Use
603     <code>name</code> attribute instead of <code>http-equiv</code>
604     attribute.</p>
605     <p>Values <code>Expires</code>, <code>Pragma</code>,
606     and <code>Cache-Control</code> are not allowed;
607     use <em>real</em> HTTP header fields for cache control.</p></dd>
608     </dl>
609     </div>
610 wakaba 1.2
611 wakaba 1.3 <div class="section attribute-value-error" id="duplicate-ID"><h3>This identifier has already been
612     assigned to another element.</h3></div>
613    
614 wakaba 1.4 <div class="section attribute-value-error" id="link-type:bad-context"><h3>The link type <code><var>$0</var></code>
615     cannot be specified for this element.</h3>
616     <p>The specified link type cannot be used for the element.
617     The document is non-conforming.</p>
618    
619     <p>Link types are associated with limited set of elements.
620     They cannot be used with other elements.</p>
621    
622     <p>For example, link type <code>bookmark</code>
623     can be used with <code>a</code> or <code>area</code> element,
624     while it cannot be used with <code>link</code> element.</p>
625     </div>
626    
627     <div class="section attribute-value-error" id="link-type:non-conforming"><h3>The link type <code><var>$0</var></code>
628     is non-conforming.</h3>
629 wakaba 1.6 <p>The specified link type is non-conforming, and therefore
630     the document is non-conforming.</p>
631    
632     <dl>
633     <dt>Link type <code>contents</code></dt>
634     <dd>Use link type <code>index</code>.</dd>
635     <dt>Link type <code>copyright</code></dt>
636     <dd>Use link type <code>license</code>.</dd>
637     <dt>Link type <code>home</code></dt>
638     <dd>Use link type <code>index</code>.</dd>
639     <dt>Link type <code>start</code></dt>
640     <dd>Use link type <code>first</code>.</dd>
641     <dt>Link type <code>toc</code></dt>
642     <dd>Use link type <code>index</code>.</dd>
643     </dl>
644     </div>
645    
646     <div class="section attribute-value-error" id="reserved-browsing-context-name"><h3>Browsing context name
647     <code><var>{@}</var></code> is reserved.</h3>
648     <p>The specified browsing context name is reserved.
649     The document is non-conforming.</p>
650 wakaba 1.4
651 wakaba 1.6 <p>Names of browsing contexts starting with <code>_</code>
652     (<code>U+005F</code> <code class="charname">LOW LINE</code>)
653     are reserved so that it must not be used.</p>
654    
655     <p>Old version of HTML, non-HTML markup languages, and
656     Web browsers define or implements special reserved
657     browsing context names <code>_blank</code>,
658     <code>_main</code>, and <code>_replace</code>.
659     However, they are <em>not</em> conforming attribute values.</p>
660 wakaba 1.4 </div>
661    
662 wakaba 1.2 </section>
663    
664 wakaba 1.4 <section id="attribute-value-warnings">
665     <h2>Attribute Value Warnings</h2>
666    
667     <div class="section attribute-value-warning should" id="s:link-type:proposed"><h3>Link type <code><var>$0</var></code>
668     is proposed but not accepted yet; it <em>should not</em> be
669     used until it has been accepted.</h3>
670     <p>The link type is in the <i>proposed</i> status; it
671     <em>should not</em> be used until it has been
672     accepted.</p>
673    
674     <p><strong>Warning</strong>: The data served to the
675     conforming checker might be out of date; it might have already
676     been accepted or rejected, depending on which the document
677     might be conforming or non-conforming. See WHATWG Wiki
678     for the latest information.</p>
679     </div>
680    
681     </section>
682    
683 wakaba 1.2 <section id="table-model-errors">
684     <h2>Table Model Errors</h2>
685    
686 wakaba 1.3 <div class="section table-model-error" id="table:colspan-creates-column-with-no-anchored-cell"><h3>This <code>colspan</code> attribute
687     results in creating a table column that does not contain
688     any cell anchored to it.</h3></div>
689    
690 wakaba 1.2 <div class="section table-model-error" id="table:no-cell-in-last-row"><h3>The table has no cell (<code>td</code> or
691     <code>th</code>) in the last row.</h3></div>
692    
693 wakaba 1.6 <div class="section table-model-error" id="table:rowspan-extends-table"><h3>This <code>rowspan</code> attribute
694     results in creating a table row that does not contain
695     any cell anchored to it.</h3>
696     <p>The <code>rowspan</code> attribute value of the cell
697     is so specified that it extends a table in the row axis.
698     However, the extended row does not contain any cell by itself.
699     The document is non-conforming.</p>
700    
701     <p>For example, the table below is non-conforming:
702     <pre class="html non-conforming example">
703     <code>&lt;table&gt;
704     &lt;tbody&gt;
705     &lt;tr&gt;&lt;td rowspan=2&gt;&lt;/td&gt;&lt;/tr&gt;
706     &lt;/tbody&gt;
707     &lt;/table&gt;</code></pre>
708     ... is non-conforming, since the second row contains only
709     a cell that spans the first and the second rows.</p>
710     </div>
711    
712 wakaba 1.2 </section>
713    
714     <section id="imt-warnings">
715     <h2>Internet Media Type Warnings</h2>
716 wakaba 1.1
717 wakaba 1.6 <div class="section should" id="s:IMT:obsolete-subtype"><h3><code><var>{@}</var></code>: An <em>obsolete</em>
718     subtype is used.</h3></div>
719 wakaba 1.2
720 wakaba 1.6 <div class="section should" id="s:IMT:private-subtype"><h3><code><var>{@}</var></code>: A private
721     (<code>x-</code> or <code>x.</code>) subtype is used.</h3></div>
722 wakaba 1.2
723 wakaba 1.6 <div class="section should" id="s:IMT:unregistered-subtype"><h3><code><var>{@}</var></code>: The subtype is
724     not registered to IANA.</h3></div>
725 wakaba 1.2
726     </section>
727    
728     <section id="uri-errors">
729     <h2>URI (or IRI) Errors</h2>
730    
731 wakaba 1.6 <div class="section must" id="m:URI::syntax-error"><h3>The specified value is syntactically not an IRI
732     reference.</h3>
733     <p>The specified value does not satisfy the syntactical requirements
734     for IRI references. The document is non-conforming.</p>
735    
736     <p>Possible causes:
737     <ul>
738     <li>The string might contain one or more white space characters.
739     Especially, the <code> </code> (<code>U+0020</code>
740     <code class="charname">SPACE</code>) character cannot be
741     used in IRI references.</li>
742     </ul>
743     </p>
744     </div>
745 wakaba 1.2
746     </section>
747    
748 wakaba 1.3 <section id="uri-warnings">
749     <h2>URI (or IRI) Warnings</h2>
750    
751     <div class="section should" id="s:URI::dot-segment"><h3>Dot-segment (<code>.</code> or
752     <code>..</code>) should not occur in an absolute reference.</h3>
753     <p>Dot-segment (<code>.</code> or <code>..</code>) should
754     not occur in an absolute reference.</p>
755    
756     <p>In relative references, dot-segments are used to represent
757     the current (<code>.</code>) or the parent (<code>..</code>)
758     hierarchy of the path. Though they are also allowed
759     in absolute references, it should be resolved to the
760     canonical form before it has been published.</p>
761     </div>
762 wakaba 1.2
763     <div class="section should" id="s:URI::empty-path"><h3>This IRI should explicitly end with
764     <code>/</code>.</h3></div>
765 wakaba 1.1
766 wakaba 1.4 <div class="section should" id="s:URI::lowercase-hexadecimal-digit"><h3>Hexadecimal digit in percent-encoding
767     should be in lowercase.</h3>
768 wakaba 1.5 <p>The hexadecimal digit in percent-encoding string in the IRI
769 wakaba 1.4 is in lowercase. Though the IRI <em>is</em> conforming,
770     it should be in uppercase.</p>
771     </div>
772    
773     <div class="section should" id="s:URI::percent-encoded-unreserved"><h3>An unreserved character is
774     percent-encoded.</h3>
775     <p>An unreserved character is percent-encoded in the IRI.
776     Though it <em>is</em> conforming, it should be in the
777     decoded (or bare) form.</p>
778     </div>
779    
780 wakaba 1.6 <div class="section should" id="s:URI::uppercase-scheme-name"><h3>URI scheme name is in uppercase.</h3>
781     <p>The scheme part of the IRI is written in uppercase letter.</p>
782    
783     <p>Uppercase scheme names are not required to be processed
784     correctly.</p>
785     <!-- @@
786     RFC 3986 3.1.
787     > Although schemes are case-
788     insensitive, the canonical form is lowercase and documents that
789     specify schemes must do so with lowercase letters.
790    
791     > An implementation ... should only produce lowercase scheme names for
792     consistency.
793     -->
794     </div>
795    
796 wakaba 1.1 </section>
797    
798     <section id="unsupported-messages">
799     <h2><i>Unsupported</i> Messages</h2>
800    
801     <div class="section unsupported" id="unsupported:attribute"><h3>This attribute is not supported by the
802     conformance checker; <em>it might or might not be conforming</em>.</h3>
803     <p>The conformant checker does not support the attribute.
804     It cannot determine whether the document is conforming or not.</p>
805     </div>
806    
807     <div class="section unsupported" id="unsupported:element"><h3>This element is not supported by the
808     conformance checker; <em>it might or might not be conforming</em>.</h3>
809     <p>The conformant checker does not support the element.
810     It cannot determine whether the document is conforming or not.</p>
811     </div>
812    
813 wakaba 1.4 <div class="section unsupported" id="unsupported:link-type"><h3>The link type <code><var>$0</var></code> is not
814     standardized or registered at the time of the release of the conformance
815     checker; <em>it is non-conforming unless it has now been
816     registered</em>.</h3>
817 wakaba 1.1 <p>The <code>rel</code> attribute is defined as a list of link types.
818     Some common link types are defined in the HTML5 specification.
819     Additional link types can be registered to the WHATWG Wiki.
820     use of any other link type is non-conforming.</p>
821    
822     <p>The specified link type is not part of the standard or registry
823     when the database used by the conformance cheker is created.
824     The link type might have been added to the registry since then.
825     In such case it might be conforming. Otherwise, the
826     document is non-conforming.</p>
827 wakaba 1.8
828     <dl>
829     <dt>Link types <code>shortcut icon</code></dt>
830     <dd>Link type <code>shortcut</code> is not registered.
831     Use only <code>icon</code> for linking to so-called favicon.</dd>
832     </dl>
833 wakaba 1.1 </div>
834    
835 wakaba 1.4 <div class="section unsupported" id="unsupported:event-handler"><h3>Conformance checking for event handler attribute
836     is not supported; <em>it might or might not be conforming.</em></h3></div>
837    
838     <div class="section unsupported" id="unsupported:language-tag"><h3>Conformance checking for language tag
839     is not supported; <em>it might or might not be conforming.</em></h3></div>
840    
841     <div class="section unsupported" id="unsupported:media-query"><h3>Conformance checking for media query
842     is not supported; <em>it might or might not be conforming.</em></h3></div>
843    
844     <div class="section unsupported" id="unsupported:script"><h3>Conformance checking for script
845     language <code><var>$0</var></code> is not supported;
846     <em>it might or might not be conforming.</em></h3></div>
847    
848     <div class="section unsupported" id="unsupported:style"><h3>Conformance checking for style
849     language <code><var>$0</var></code> is not supported;
850     <em>it might or might not be conforming.</em></h3></div>
851    
852 wakaba 1.1 </section>
853    
854 wakaba 1.3
855 wakaba 1.2
856 wakaba 1.1 <section id="license">
857     <h2>License of This Document</h2>
858    
859     <p>Copyright 2007 <a href="http://suika.fam.cx/~wakaba/who?">Wakaba</a></p>
860     <p>This library is free software; you can redistribute it
861     and/or modify it under the same terms as Perl itself.</p>
862     </section>
863    
864 wakaba 1.8 <!-- $Date: 2007/08/11 13:54:55 $ -->
865 wakaba 1.1 </body>
866     </html>

admin@suikawiki.org
ViewVC Help
Powered by ViewVC 1.1.24