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

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

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

revision 1.2 by wakaba, Mon Jul 16 08:38:48 2007 UTC revision 1.32 by wakaba, Fri Aug 15 14:11:13 2008 UTC
# Line 11  Web Document Conformance Checker (BETA)< Line 11  Web Document Conformance Checker (BETA)<
11  <body>  <body>
12  <h1>Description of Errors</h1>  <h1>Description of Errors</h1>
13    
14    <section id="character-encoding-layer">
15    <h2>Character Encoding Layer Errors</h2>
16    
17    <d:item name="illegal-octets-error" class="error-category-charset" level="m">
18      <d:message xml:lang="en">An illegal octet in the input stream.</d:message>
19    </d:item>
20    </section>
21    
22    <section id="html5-character-encoding">
23    <h2>HTML5 Character Encoding Errors</h2>
24    
25    <d:item name="disallowed character encoding"
26        modules="ContentChecker">
27      <d:message xml:lang="en">Character encoding <code><var>{text}</var></code>
28      is not allowed for <abbr>HTML</abbr> document.</d:message>
29      <d:desc xml:lang="en">
30        <p>The character encoding used for the document is not allowed
31        for <abbr>HTML</abbr> document.  The document is non‐conforming.</p>
32      </d:desc>
33    </d:item>
34    
35    <d:item name="bad character encoding"
36        modules="ContentChecker">
37      <d:message xml:lang="en">Character encoding <code><var>{text}</var></code>
38      should not be used for <abbr>HTML</abbr> document.</d:message>
39      <d:desc xml:lang="en">
40        <p>The character encoding used for the document is not recommended
41        for <abbr>HTML</abbr> document.  The document is non‐conforming
42        unless there is any good reason to use that encoding.</p>
43      </d:desc>
44    </d:item>
45    
46    <d:item name="non-utf-8 character encoding"
47        modules="ContentChecker">
48      <d:message xml:lang="en">Use of UTF-8 is encouraged (this document
49      is encoded in <code><var>{text}</var></code>).</d:message>
50      <d:desc xml:lang="en">
51        <p>Use of UTF-8 as the character encoding of the document is encouraged,
52        though the use of another character encoding is still conforming.</p>
53      </d:desc>
54    </d:item>
55    
56    <d:item name="character encoding unchecked"
57        modules="ContentChecker">
58      <d:message xml:lang="en">Conformance for character encoding requirements
59      cannot be checked, since the input is not a byte stream.</d:message>
60      <d:desc xml:lang="en">
61        <p>The conformance checker cannot detect whether the input document
62        met the requirements on character encoding, since the document
63        is not inputed as a serialized byte sequence.  The document is
64        not conforming if it is not encoded in an appropriate character
65        encoding with appropriate labeling.</p>
66      </d:desc>
67    </d:item>
68    
69    <d:item name="no character encoding declaration"
70        modules="ContentChecker">
71      <d:message xml:lang="en">There is no character encoding
72      declaration.</d:message>
73      <d:desc xml:lang="en">
74        <p>The document does not contain a character encoding
75        declaration.  Unless the character encoding is explicitly
76        specified in lower‐level protocol, e.g. in <abbr>HTTP</abbr>,
77        or is implied by <abbr>BOM</abbr>, there must be a character
78        encoding declaration.  The document is non‐conforming.</p>
79    
80        <p>The long character encoding declaration syntax
81        <code class="html bad example">&lt;meta http-equiv="Content-Type" content="text/html; charset=<var>charset-name</var>"></code>
82        is obsolete.  The new syntax is:</p>
83        <pre class="html example"><code>&lt;meta charset="<var>charset-name</var>"></code></pre>
84    
85        <p>Note that the <code>encoding</code> declaration in <abbr>XML</abbr>
86        declaration has no effect for <abbr>HTML</abbr> document.</p>
87      </d:desc>
88    </d:item>
89    
90    <d:item name="non ascii superset"
91        modules="ContentChecker">
92      <d:message xml:lang="en">No character encoding metadata is found
93      in lower‐level protocol nor is there <abbr>BOM</abbr>, while
94      character encoding <code><var>{text}</var></code>
95      is not a superset of <abbr>ASCII</abbr>.</d:message>
96      <d:desc xml:lang="en">
97        <p>The document is not labeled with character encoding name
98        in lower‐level protocol, e.g. in <abbr>HTTP</abbr>, and
99        the document is not begin with <abbr>BOM</abbr>.  In addition,
100        the character encoding of the document is not a superset of
101        <abbr>ASCII</abbr>.  The document is non‐conforming.</p>
102    
103        <p>Unless there is a <abbr>BOM</abbr>, the character encoding
104        for the document must be specified in e.g. <abbr>HTTP</abbr>‐level,
105        as:</p>
106        <pre class="http example"><code>Content-Type: text/html; charset=<var>charset-name</var></code></pre>
107    
108        <p>Existence of <abbr>HTML</abbr> character encoding declaration, i.e.
109        <code class="html example">&lt;meta charset="<var>charset-name</var>"></code>,
110     &nb