/[pub]/test/html-webhacc/error-description-source.xml
Suika

Contents of /test/html-webhacc/error-description-source.xml

Parent Directory Parent Directory | Revision Log Revision Log

Revision 1.42 - (hide annotations) (download) (as text)
Sun Aug 31 13:28:12 2008 UTC (17 years, 10 months ago) by wakaba
Branch: MAIN
Changes since 1.41: +107 -13 lines
File MIME type: text/xml 
++ ChangeLog	31 Aug 2008 13:28:00 -0000
2008-08-31  Wakaba  <wakaba@suika.fam.cx>

	* error-description-source.xml: More error descriptions.
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 wakaba 1.36 <base href="cc/"/>
7     <title xml:lang="en">Description of Errors &#x2014; WebHACC (β)</title>
8 wakaba 1.37 <title xml:lang="ja">誤りの説明 &#x2014; WebHACC (β)</title>
9 wakaba 1.36 <link rel="stylesheet" href="../cc-style"/>
10 wakaba 1.1 <link rel="license" href="#license"/>
11     </head>
12     <body>
13 wakaba 1.36 <header>
14     <h1><a href="../cc-about"><abbr title="Web Hypertext Application Conformance Checker (β)"><img src="../icons/title" alt="WebHACC"/></abbr></a></h1>
15     <h2>Description of Errors</h2>
16     </header>
17    
18     <d:cat name="WebHACC:Title">
19     <d:text xml:lang="en">WebHACC (β)</d:text>
20     </d:cat>
21    
22     <d:cat name="WebHACC:Heading">
23     <d:text xml:lang="en">
24     <a href="../error-description#WebHACC:Heading" rel="help"><abbr title="Web Hypertext Application Conformance Checker (β)"><img src="../icons/title" alt="WebHACC"/></abbr></a>
25     </d:text>
26     <d:text xml:lang="ja">
27     <a href="../error-description#WebHACC:Heading" rel="help"><abbr title="Web ハイパーテキスト応用適合性検査器 (β)"><img src="../icons/title" alt="WebHACC"/></abbr></a>
28     </d:text>
29     <d:desc xml:lang="en">
30     <p><a href="./#input"><abbr title="Web Hypertext Application Conformance Checker">WebHACC</abbr></a>
31     is a <em>conformance checker</em> (or validator) for Web documents,
32     supporting <a href="../standards">latest Web standards</a> including
33     <a href="http://whatwg.org/html5"><abbr title="Hypertext Markup Language">HTML</abbr>5</a>,
34     <a href="urn:ietf:rfc:4287">Atom 1.0</a>,
35     <a href="http://www.w3.org/Style/CSS/current-work"><abbr title="Cascading Style Sheets">CSS</abbr>3</a>.</p>
36    
37     <p><strong><a href="./#input">Check your document</a></strong>, or
38     <a href="../cc-about">learn more about
39     <abbr title="Web Hypertext Application Conformance Checker">WebHACC</abbr></a>.</p>
40     </d:desc>
41     <d:desc xml:lang="ja">
42     <p><a href="./#input"><abbr title="Web ハイパーテキスト応用適合性検査器">WebHACC</abbr></a>
43     は、 Web 文書のための<em>適合性検査器</em> (妥当性検証器) です。
44     <a href="http://whatwg.org/html5"><abbr title="Hypertext Markup Language">HTML</abbr>5</a>、
45     <a href="urn:ietf:rfc:4287">Atom 1.0</a>、
46     <a href="http://www.w3.org/Style/CSS/current-work"><abbr title="Cascading Style Sheets">CSS</abbr>3</a>
47     などの<a href="../standards">最新の Web 標準</a>に対応しています。</p>
48    
49     <p><strong><a href="./#input">文書を検査する</a></strong></p>
50    
51     <p><a href="../cc-about"><abbr title="Web ハイパーテキスト応用適合性検査器">WebHACC</abbr>
52     の詳細</a></p>
53     </d:desc>
54     </d:cat>
55 wakaba 1.1
56 wakaba 1.23 <section id="character-encoding-layer">
57     <h2>Character Encoding Layer Errors</h2>
58    
59     <d:item name="illegal-octets-error" class="error-category-charset" level="m">
60     <d:message xml:lang="en">An illegal octet in the input stream.</d:message>
61     </d:item>
62     </section>
63    
64 wakaba 1.16 <section id="html5-character-encoding">
65     <h2>HTML5 Character Encoding Errors</h2>
66    
67 wakaba 1.30 <d:item name="disallowed character encoding"
68     modules="ContentChecker">
69     <d:message xml:lang="en">Character encoding <code><var>{text}</var></code>
70 wakaba 1.16 is not allowed for <abbr>HTML</abbr> document.</d:message>
71     <d:desc xml:lang="en">
72     <p>The character encoding used for the document is not allowed
73     for <abbr>HTML</abbr> document. The document is non‐conforming.</p>
74     </d:desc>
75     </d:item>
76    
77 wakaba 1.30 <d:item name="bad character encoding"
78     modules="ContentChecker">
79     <d:message xml:lang="en">Character encoding <code><var>{text}</var></code>
80 wakaba 1.16 should not be used for <abbr>HTML</abbr> document.</d:message>
81     <d:desc xml:lang="en">
82     <p>The character encoding used for the document is not recommended
83     for <abbr>HTML</abbr> document. The document is non‐conforming
84     unless there is any good reason to use that encoding.</p>
85     </d:desc>
86     </d:item>
87    
88 wakaba 1.30 <d:item name="non-utf-8 character encoding"
89     modules="ContentChecker">
90     <d:message xml:lang="en">Use of UTF-8 is encouraged (this document
91     is encoded in <code><var>{text}</var></code>).</d:message>
92 wakaba 1.16 <d:desc xml:lang="en">
93     <p>Use of UTF-8 as the character encoding of the document is encouraged,
94 wakaba 1.21 though the use of another character encoding is still conforming.</p>
95 wakaba 1.16 </d:desc>
96     </d:item>
97    
98 wakaba 1.30 <d:item name="character encoding unchecked"
99     modules="ContentChecker">
100 wakaba 1.17 <d:message xml:lang="en">Conformance for character encoding requirements
101 wakaba 1.30 cannot be checked, since the input is not a byte stream.</d:message>
102 wakaba 1.17 <d:desc xml:lang="en">
103     <p>The conformance checker cannot detect whether the input document
104     met the requirements on character encoding, since the document
105     is not inputed as a serialized byte sequence. The document is
106     not conforming if it is not encoded in an appropriate character
107     encoding with appropriate labeling.</p>
108     </d:desc>
109     </d:item>
110    
111 wakaba 1.30 <d:item name="no character encoding declaration"
112     modules="ContentChecker">
113 wakaba 1.16 <d:message xml:lang="en">There is no character encoding
114     declaration.</d:message>
115     <d:desc xml:lang="en">
116     <p>The document does not contain a character encoding
117     declaration. Unless the character encoding is explicitly
118 wakaba 1.17 specified in lower‐level protocol, e.g. in <abbr>HTTP</abbr>,
119 wakaba 1.16 or is implied by <abbr>BOM</abbr>, there must be a character
120     encoding declaration. The document is non‐conforming.</p>
121    
122     <p>The long character encoding declaration syntax
123     <code class="html bad example">&lt;meta http-equiv="Content-Type" content="text/html; charset=<var>charset-name</var>"></code>
124     is obsolete. The new syntax is:</p>
125     <pre class="html example"><code>&lt;meta charset="<var>charset-name</var>"></code></pre>
126    
127     <p>Note that the <code>encoding</code> declaration in <abbr>XML</abbr>
128     declaration has no effect for <abbr>HTML</abbr> document.</p>
129     </d:desc>
130     </d:item>
131    
132 wakaba 1.30 <d:item name="non ascii superset"
133     modules="ContentChecker">
134 wakaba 1.16 <d:message xml:lang="en">No character encoding metadata is found
135 wakaba 1.17 in lower‐level protocol nor is there <abbr>BOM</abbr>, while
136 wakaba 1.30 character encoding <code><var>{text}</var></code>
137 wakaba 1.16 is not a superset of <abbr>ASCII</abbr>.</d:message>
138     <d:desc xml:lang="en">
139     <p>The document is not labeled with character encoding name
140 wakaba 1.17 in lower‐level protocol, e.g. in <abbr>HTTP</abbr>, and
141 wakaba 1.16 the document is not begin with <abbr>BOM</abbr>. In addition,
142     the character encoding of the document is not a superset of
143     <abbr>ASCII</abbr>. The document is non‐conforming.</p>
144    
145     <p>Unless there is a <abbr>BOM</abbr>, the character encoding
146     for the document must be specified in e.g. <abbr>HTTP</abbr>‐level,
147     as:</p>
148     <pre class="http example"><code>Content-Type: text/html; charset=<var>charset-name</var></code></pre>
149    
150     <p>Existence of <abbr>HTML</abbr> character encoding declaration, i.e.
151     <code class="html example">&lt;meta charset="<var>charset-name</var>"></code>,
152     does not allow to omit <code>charset</code> parameter
153     for <abbr>HTML</abbr> document encoded in non‐<abbr>ASCII</abbr>
154     compatible encoding.</p>
155    
156     <p>Character encodings <code>Shift_JIS</code>, <code>Windows-31J</code>,
157     and <code>ISO-2022-JP</code> are <em>not</em> a superset of
158     <abbr>ASCII</abbr> for the purpose of <abbr>HTML</abbr> conformance.</p>
159     </d:desc>
160     </d:item>
161    
162 wakaba 1.29 <d:item name="sniffing:chardet"
163     modules="HTML::Parser">
164     <d:message xml:lang="en">Character encoding of this document is sniffed
165     as <code><var>{text}</var></code> (Sniffed because no explicit specification
166     for the character encoding of this document is found in the transfer
167     procotol headers).</d:message>
168     </d:item>
169    
170     <d:item name="sniffing:default"
171     modules="HTML::Parser">
172     <d:message xml:lang="en">Character encoding of this document is defaulted
173     to <code><var>{text}</var></code> because no explicit specification
174     for the character encoding of this document is found in the transfer
175     procotol headers.</d:message>
176     </d:item>
177    
178     <d:item name="chardecode:fallback"
179     modules="HTML::Parser">
180     <d:message xml:lang="en">Since no decoder for the document character
181     encoding is found, decoder for the character encoding
182     <code><var>{text}</var></code> is used. Checking results might be
183     <em>wrong</em>.</d:message>
184     </d:item>
185    
186     <d:item name="chardecode:no error"
187     modules="HTML::Parser">
188     <d:message xml:lang="en">Conformance error checking for the character
189     encoding <code><var>{text}</var></code> is not supported.</d:message>
190     </d:item>
191    
192     <d:item name="charset label:matching"
193     modules="HTML::Parser">
194     <d:message xml:lang="en">Sniffed character encoding
195     <code><var>{text}</var></code> is same as the character encoding specified
196     in the character encoding declaration. This is <em>not</em> an
197     error.</d:message>
198     </d:item>
199    
200     <d:item name="charset label detected"
201     modules="HTML::Parser">
202 wakaba 1.16 <d:message xml:lang="en">While parsing the document as
203 wakaba 1.29 <code><var>{text}</var></code>, a character encoding declaration specifying
204     a different character encoding is found. The document
205 wakaba 1.16 is reparsed.</d:message>
206     <d:desc xml:lang="en">
207     <p>While parsing a document in a character encoding,
208     a character encoding declaration which declares the character
209     encoding of the document as another character encoding is found.
210     The occurence of this warning itself does not make the document
211     non‐conforming. However, the failure of the first attempt to
212 wakaba 1.21 to detect the character encoding might be a result of non‐conformance
213 wakaba 1.16 of the document.</p>
214    
215     <p>The document will be reparsed from the beginning. Some error
216     or warning might be reported again.</p>
217    
218     <p>These are suggestions to avoid this warning:</p>
219