Parent Directory
| 
Revision Log
++ ChangeLog 15 Aug 2008 16:02:36 -0000 2008-08-16 Wakaba <wakaba@suika.fam.cx> * error-description-source.xml: Error entries for Whatpm::URIChecker and Whatpm::LangTag error types are added. ++ html/WebHACC/Language/ChangeLog 15 Aug 2008 16:03:42 -0000 2008-08-16 Wakaba <wakaba@suika.fam.cx> * HTML.pm (generate_syntax_error_section): Remove |input_encoding| attribute value if the input is specified by direct input. ++ html/WebHACC/ChangeLog 15 Aug 2008 16:03:08 -0000 2008-08-16 Wakaba <wakaba@suika.fam.cx> * Result.pm (add_error): Pass |value| argument, if any, to the |nl_text| for error type texts.
| 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.20 | <section id="character-encoding-layer"> |
| 12 | <h2>Character Encoding Layer Errors</h2> | ||
| 13 | |||
| 14 | <div class="section error-category-charset" id="m:illegal-octets-error"><h3>An illegal octet in the input stream.</h3></div> | ||
| 15 | </section> | ||
| 16 | |||
| 17 | wakaba | 1.15 | <section id="html5-character-encoding"> |
| 18 | <h2>HTML5 Character Encoding Errors</h2> | ||
| 19 | |||
| 20 | wakaba | 1.26 | <div class="section " id="disallowed-character-encoding"><h3>Character encoding <code><var>{text}</var></code> |
| 21 | wakaba | 1.15 | is not allowed for <abbr>HTML</abbr> document.</h3> |
| 22 | <p>The character encoding used for the document is not allowed | ||
| 23 | for <abbr>HTML</abbr> document. The document is non‐conforming.</p> | ||
| 24 | </div> | ||
| 25 | |||
| 26 | wakaba | 1.26 | <div class="section " id="bad-character-encoding"><h3>Character encoding <code><var>{text}</var></code> |
| 27 | wakaba | 1.15 | should not be used for <abbr>HTML</abbr> document.</h3> |
| 28 | <p>The character encoding used for the document is not recommended | ||
| 29 | for <abbr>HTML</abbr> document. The document is non‐conforming | ||
| 30 | unless there is any good reason to use that encoding.</p> | ||
| 31 | </div> | ||
| 32 | |||
| 33 | wakaba | 1.26 | <div class="section " id="non-utf-8-character-encoding"><h3>Use of UTF-8 is encouraged (this document |
| 34 | is encoded in <code><var>{text}</var></code>).</h3> | ||
| 35 | wakaba | 1.15 | <p>Use of UTF-8 as the character encoding of the document is encouraged, |
| 36 | wakaba | 1.20 | though the use of another character encoding is still conforming.</p> |
| 37 | wakaba | 1.15 | </div> |
| 38 | |||
| 39 | wakaba | 1.26 | <div class="section " id="character-encoding-unchecked"><h3>Conformance for character encoding requirements |
| 40 | cannot be checked, since the input is not a byte stream.</h3> | ||
| 41 | wakaba | 1.16 | <p>The conformance checker cannot detect whether the input document |
| 42 | met the requirements on character encoding, since the document | ||
| 43 | is not inputed as a serialized byte sequence. The document is | ||
| 44 | not conforming if it is not encoded in an appropriate character | ||
| 45 | encoding with appropriate labeling.</p> | ||
| 46 | </div> | ||
| 47 | |||
| 48 | wakaba | 1.26 | <div class="section " id="no-character-encoding-declaration"><h3>There is no character encoding |
| 49 | wakaba | 1.15 | declaration.</h3> |
| 50 | <p>The document does not contain a character encoding | ||
| 51 | declaration. Unless the character encoding is explicitly | ||
| 52 | wakaba | 1.16 | specified in lower‐level protocol, e.g. in <abbr>HTTP</abbr>, |
| 53 | wakaba | 1.15 | or is implied by <abbr>BOM</abbr>, there must be a character |
| 54 | encoding declaration. The document is non‐conforming.</p> | ||
| 55 | |||
| 56 | <p>The long character encoding declaration syntax | ||
| 57 | wakaba | 1.21 | <code class="html bad example"><meta http-equiv="Content-Type" content="text/html; charset=<var>charset-name</var>"></code> |
| 58 | wakaba | 1.15 | is obsolete. The new syntax is:</p> |
| 59 | <pre class="html example"> | ||
| 60 | wakaba | 1.21 | <code><meta charset="<var>charset-name</var>"></code></pre> |
| 61 | wakaba | 1.15 | |
| 62 | <p>Note that the <code>encoding</code> declaration in <abbr>XML</abbr> | ||
| 63 | declaration has no effect for <abbr>HTML</abbr> document.</p> | ||
| 64 | </div> | ||
| 65 | |||
| 66 | wakaba | 1.26 | <div class="section " id="non-ascii-superset"><h3>No character encoding metadata is found |
| 67 | wakaba | 1.16 | in lower‐level protocol nor is there <abbr>BOM</abbr>, while |
| 68 | wakaba | 1.26 | character encoding <code><var>{text}</var></code> |
| 69 | wakaba | 1.15 | is not a superset of <abbr>ASCII</abbr>.</h3> |
| 70 | <p>The document is not labeled with character encoding name | ||
| 71 | wakaba | 1.16 | in lower‐level protocol, e.g. in <abbr>HTTP</abbr>, and |
| 72 | wakaba | 1.15 | the document is not begin with <abbr>BOM</abbr>. In addition, |
| 73 | the character encoding of the document is not a superset of | ||
| 74 | <abbr>ASCII</abbr>. The document is non‐conforming.</p> | ||
| 75 | |||
| 76 | <p>Unless there is a <abbr>BOM</abbr>, the character encoding | ||
| 77 | for the document must be specified in e.g. <abbr>HTTP</abbr>‐level, | ||
| 78 | as:</p> | ||
| 79 | <pre class="http example"> | ||
| 80 | <code>Content-Type: text/html; charset=<var>charset-name</var></code></pre> | ||
| 81 | |||
| 82 | <p>Existence of <abbr>HTML</abbr> character encoding declaration, i.e. | ||
| 83 | wakaba | 1.21 | <code class="html example"><meta charset="<var>charset-name</var>"></code>, |
| 84 | wakaba | 1.15 | does not allow to omit <code>charset</code> parameter |
| 85 | for <abbr>HTML</abbr> document encoded in non‐<abbr>ASCII</abbr> | ||
| 86 | compatible encoding.</p> | ||
| 87 | |||
| 88 | <p>Character encodings <code>Shift_JIS</code>, <code>Windows-31J</code>, | ||
| 89 | and <code>ISO-2022-JP</code> are <em>not</em> a superset of | ||
| 90 | <abbr>ASCII</abbr> for the purpose of <abbr>HTML</abbr> conformance.</p> | ||
| 91 | </div> | ||
| 92 | |||
| 93 | wakaba | 1.25 | <div class="section " id="sniffing:chardet"><h3>Character encoding of this document is sniffed |
| 94 | as <code><var>{text}</var></code> (Sniffed because no explicit specification | ||
| 95 | for the character encoding of this document is found in the transfer | ||
| 96 | procotol headers).</h3></div> | ||
| 97 | |||