1 |
wakaba |
1.1 |
<!DOCTYPE html> |
2 |
|
|
<html xmlns="http://www.w3.org/1999/xhtml" |
3 |
|
|
xmlns:d="http://suika.fam.cx/~wakaba/archive/2007/wdcc-desc/" |
4 |
|
|
id="error-description"> |
5 |
|
|
<head> |
6 |
|
|
<title xml:lang="en">Description of Errors — |
7 |
|
|
Web Document Conformance Checker (BETA)</title> |
8 |
|
|
<link rel="stylesheet" href="cc-style"/> |
9 |
|
|
<link rel="license" href="#license"/> |
10 |
|
|
</head> |
11 |
|
|
<body> |
12 |
|
|
<h1>Description of Errors</h1> |
13 |
|
|
|
14 |
|
|
<section id="html5-parse-errors"> |
15 |
|
|
<h2>HTML5 Parse Errors</h2> |
16 |
|
|
|
17 |
|
|
<d:item name="after head" |
18 |
|
|
class="parse-error"> |
19 |
|
|
<d:message xml:lang="en">The <code><var>$0</var></code> element cannot be |
20 |
|
|
inserted between <code>head</code> and <code>body</code> elements.</d:message> |
21 |
|
|
<d:desc xml:lang="en"> |
22 |
|
|
<p>A start tag occurs after the <code>head</code> element is closed |
23 |
|
|
but before the <code>body</code> element is opened. |
24 |
|
|
The document is non-conforming.</p> |
25 |
|
|
</d:desc> |
26 |
|
|
</d:item> |
27 |
|
|
|
28 |
|
|
<d:item name="duplicate attribute" |
29 |
|
|
class="tokenize-error"> |
30 |
|
|
<d:message xml:lang="en">There are two attributes with same name.</d:message> |
31 |
|
|
<d:desc xml:lang="en"> |
32 |
|
|
<p>Attributes must be unique in an element. Specifying |
33 |
|
|
attributes with same name more than once is non-conforming.</p> |
34 |
|
|
|
35 |
|
|
<p>The <code>motion</code> attribute is not part of the HTML standard. |
36 |
|
|
Use <code>img</code> element with animation GIF instead.</p> |
37 |
|
|
</d:desc> |
38 |
|
|
</d:item> |
39 |
|
|
|
40 |
|
|
<d:item name="nestc" |
41 |
|
|
class="tokenize-error"> |
42 |
|
|
<d:message xml:lang="en">Void element syntax (<code>/></code>) cannot be |
43 |
|
|
used for this element.</d:message> |
44 |
|
|
<d:desc xml:lang="en"> |
45 |
|
|
<p>The void element syntax <code>/></code> syntax can only be |
46 |
|
|
used for <code>base</code>, <code>link</code>, <code>meta</code>, |
47 |
|
|
<code>hr</code>, <code>br</code>, <code>img</code>, |
48 |
|
|
<code>embed</code>, <code>param</code>, <code>area</code>, |
49 |
|
|
<code>col</code>, and <code>input</code> elements. |
50 |
|
|
For any other elements, using that syntax is non-conforming.</p> |
51 |
|
|
|
52 |
|
|
<p>Unlike XML, the void element syntax (<code>/></code>) has |
53 |
|
|
no effect in HTML.</p> |
54 |
|
|
</d:desc> |
55 |
|
|
</d:item> |
56 |
|
|
|
57 |
|
|
</section> |
58 |
|
|
|
59 |
|
|
<section id="element-content-model-errors"> |
60 |
|
|
<h2>Element Content Model Errors</h2> |
61 |
|
|
|
62 |
|
|
<d:item name="character not allowed" |
63 |
|
|
class="content-model-error"> |
64 |
|
|
<d:message xml:lang="en">Data character is not allowed in this |
65 |
|
|
context.</d:message> |
66 |
|
|
<d:desc xml:lang="en"> |
67 |
|
|
<p>A data character occurs where it is not allowed in this |
68 |
|
|
context. The document is non-conforming.</p> |
69 |
|
|
|
70 |
|
|
<p>Possible causes: |
71 |
|
|
<dl> |
72 |
|
|
<dt>If the erred element is an inline-level element (such |
73 |
|
|
as <code>a</code> or <code>span</code>)</dt> |
74 |
|
|
<dd><p>A data character cannot be a child |
75 |
|
|
of certain sectioning elements such as <code>body</code>, |
76 |
|
|
<code>section</code>, and <code>blockquote</code>.</p> |
77 |
|
|
|
78 |
|
|
<p>Any inline-level content must be put |
79 |
|
|
in e.g. paragraph element such as <code>p</code>.</p></dd> |
80 |
|
|
<dt>If the erred element is a block-level element (such as |
81 |
|
|
<code>div</code> or <code>h<var>n</var></code>)</dt> |
82 |
|
|
<dd><p>Though some elements such as <code>div</code>, |
83 |
|
|
<code>li</code>, and <code>td</code> allow |
84 |
|
|
<em>either one</em> of block-level or inline-level content |
85 |
|
|
is allowed. If there is a block-level content, |
86 |
|
|
any inline-level content must be put |
87 |
|
|
in e.g. paragraph element such as <code>p</code>.</p></dd> |
88 |
|
|
</dl> |
89 |
|
|
</p> |
90 |
|
|
</d:desc> |
91 |
|
|
</d:item> |
92 |
|
|
|
93 |
|
|
<d:item name="child element missing" |
94 |
|
|
class="content-model-error"> |
95 |
|
|
<d:message xml:lang="en">There must be a <code><var>$0</var></code> |
96 |
|
|
element as a child of this element.</d:message> |
97 |
|
|
<d:desc xml:lang="en"> |
98 |
|
|
<p>The content model of the element is so defined that it |
99 |
|
|
must contain a <code><var>$0</var></code> child element. |
100 |
|
|
Without such an element, the document is non-conforming.</p> |
101 |
|
|
|
102 |
|
|
<p>For example: |
103 |
|
|
<ul> |
104 |
|
|
<li>The <code>head</code> element must contain exactly one |
105 |
|
|
<code>title</code> child element.</li> |
106 |
|
|
<li><a href="#child-element-missing:td%7Cth">The <code>tr</code> |
107 |
|
|
element must contain one or more <code>td</code> or <code>th</code> |
108 |
|
|
child element.</a></li> |
109 |
|
|
</ul> |
110 |
|
|
</p> |
111 |
|
|
</d:desc> |
112 |
|
|
</d:item> |
113 |
|
|
|
114 |
|
|
<d:item name="child element missing:td|th" |
115 |
|
|
class="content-model-error"> |
116 |
|
|
<d:message xml:lang="en">There must be a <code>td</code> |
117 |
|
|
or <code>th</code> element as a child of this element.</d:message> |
118 |
|
|
<d:desc xml:lang="en"> |
119 |
|
|
<p>The <code>tr</code> element must contain at least one |
120 |
|
|
<code>td</code> or <code>th</code> child element. Without |
121 |
|
|
such an element, the document is non-conforming.</p> |
122 |
|
|
</d:desc> |
123 |
|
|
</d:item> |
124 |
|
|
|
125 |
|
|
<d:item name="element not allowed" |
126 |
|
|
class="content-model-error"> |
127 |
|
|
<d:message xml:lang="en">This element is not allowed in this |
128 |
|
|
context.</d:message> |
129 |
|
|
<d:desc xml:lang="en"> |
130 |
|
|
<p>An element occurs where it is not allowed. The document |
131 |
|
|
is non-conforming.</p> |
132 |
|
|
|
133 |
|
|
<p>Possible causes: |
134 |
|
|
<dl> |
135 |
|
|
<dt>If the erred element is an inline-level element (such |
136 |
|
|
as <code>a</code> or <code>span</code>)</dt> |
137 |
|
|
<dd><p>An inline-level element cannot be a child |
138 |
|
|
of certain sectioning elements such as <code>body</code>, |
139 |
|
|
<code>section</code>, and <code>blockquote</code>.</p> |
140 |
|
|
|
141 |
|
|
<p>Any inline-level content must be put |
142 |
|
|
in e.g. paragraph element such as <code>p</code>.</p></dd> |
143 |
|
|
<dt>If the erred element is a block-level element (such as |
144 |
|
|
<code>div</code> or <code>h<var>n</var></code>)</dt> |
145 |
|
|
<dd><p>Though some elements such as <code>div</code>, |
146 |
|
|
<code>li</code>, and <code>td</code> allow |
147 |
|
|
<em>either one</em> of block-level or inline-level content |
148 |
|
|
is allowed. If there is a block-level content, |
149 |
|
|
any inline-level content must be put |
150 |
|
|
in e.g. paragraph element such as <code>p</code>.</p></dd> |
151 |
|
|
<dt>If the erred element is the root <code>html</code> element</dt> |
152 |
|
|
<dd><p>In an XHTML document, the root <code>html</code> |
153 |
|
|
element must have an <code>xmlns</code> attribute |
154 |
|
|
whose value is set to |
155 |
|
|
<code>http://www.w3.org/1999/xhtml</code>.</p></dd> |
156 |
|
|
</dl> |
157 |
|
|
</p> |
158 |
|
|
</d:desc> |
159 |
|
|
</d:item> |
160 |
|
|
|
161 |
|
|
enumerated:invalid;attribute-error;This attribute only allow a limited set of values and the specified value is not one of them. |
162 |
|
|
no DOCTYPE;parse-error;This document does not start with the <code>DOCTYPE</code> declaration. |
163 |
|
|
not HTML5;parse-error;This document is written in an old version of HTML. |
164 |
|
|
not closed;parse-error;Element <code>$0</code> is not closed. |
165 |
|
|
unmatched end tag;parse-error;Element <code>$0</code> is not opened. |
166 |
|
|
|
167 |
|
|
table:no cell in last row;table-model-error;The table has no cell (<code>td</code> or <code>th</code>) in the last row. |
168 |
|
|
|
169 |
|
|
s:IMT:obsolete subtype;should;An <em>obsolete</em> subtype is used. |
170 |
|
|
s:IMT:private subtype;should;A private (<code>x-</code> or <code>x.</code>) subtype is used. |
171 |
|
|
s:IMT:unregistered subtype;should;The subtype is not registered to IANA. |
172 |
|
|
|
173 |
|
|
s:URI::empty path;should;This IRI should explicitly end with <code>/</code>. |
174 |
|
|
m:URI::syntax error;must;This IRI is not syntactically valid. |
175 |
|
|
|
176 |
|
|
</section> |
177 |
|
|
|
178 |
|
|
<section id="unsupported-messages"> |
179 |
|
|
<h2><i>Unsupported</i> Messages</h2> |
180 |
|
|
|
181 |
|
|
<d:item name="unsupported:attribute" |
182 |
|
|
class="unsupported"> |
183 |
|
|
<d:message xml:lang="en">This attribute is not supported by the |
184 |
|
|
conformance checker; <em>it might or might not be conforming</em>.</d:message> |
185 |
|
|
<d:desc xml:lang="en"> |
186 |
|
|
<p>The conformant checker does not support the attribute. |
187 |
|
|
It cannot determine whether the document is conforming or not.</p> |
188 |
|
|
</d:desc> |
189 |
|
|
</d:item> |
190 |
|
|
|
191 |
|
|
<d:item name="unsupported:element" |
192 |
|
|
class="unsupported"> |
193 |
|
|
<d:message xml:lang="en">This element is not supported by the |
194 |
|
|
conformance checker; <em>it might or might not be conforming</em>.</d:message> |
195 |
|
|
<d:desc xml:lang="en"> |
196 |
|
|
<p>The conformant checker does not support the element. |
197 |
|
|
It cannot determine whether the document is conforming or not.</p> |
198 |
|
|
</d:desc> |
199 |
|
|
</d:item> |
200 |
|
|
|
201 |
|
|
<d:item name="unsupported:link type" |
202 |
|
|
class="unsupported"> |
203 |
|
|
<d:message xml:lang="en">The link type <code>$0</code> is not standardized |
204 |
|
|
or registered at the time of the release of the conformance checker; |
205 |
|
|
<em>it is non-conforming unless it has now been registered</em>.</d:message> |
206 |
|
|
<d:desc xml:lang="en"> |
207 |
|
|
<p>The <code>rel</code> attribute is defined as a list of link types. |
208 |
|
|
Some common link types are defined in the HTML5 specification. |
209 |
|
|
Additional link types can be registered to the WHATWG Wiki. |
210 |
|
|
use of any other link type is non-conforming.</p> |
211 |
|
|
|
212 |
|
|
<p>The specified link type is not part of the standard or registry |
213 |
|
|
when the database used by the conformance cheker is created. |
214 |
|
|
The link type might have been added to the registry since then. |
215 |
|
|
In such case it might be conforming. Otherwise, the |
216 |
|
|
document is non-conforming.</p> |
217 |
|
|
</d:desc> |
218 |
|
|
</d:item> |
219 |
|
|
|
220 |
|
|
</section> |
221 |
|
|
|
222 |
|
|
<section id="license"> |
223 |
|
|
<h2>License of This Document</h2> |
224 |
|
|
|
225 |
|
|
<p>Copyright 2007 <a href="http://suika.fam.cx/~wakaba/who?">Wakaba</a></p> |
226 |
|
|
<p>This library is free software; you can redistribute it |
227 |
|
|
and/or modify it under the same terms as Perl itself.</p> |
228 |
|
|
</section> |
229 |
|
|
|
230 |
|
|
<!-- $Date:$ --> |
231 |
|
|
</body> |
232 |
|
|
</html> |