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> |