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