Parent Directory
| 
Revision Log
++ ChangeLog 18 May 2008 07:23:53 -0000 * LICENSE: Note on icons/*.png are added. * icons/: New directory. * cc-style.css: Rules for background images on error category are added. 2008-05-18 Wakaba <wakaba@suika.fam.cx>
| 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 | wakaba | 1.23 | <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 | wakaba | 1.16 | <section id="html5-character-encoding"> |
| 23 | <h2>HTML5 Character Encoding Errors</h2> | ||
| 24 | |||
| 25 | <d:item name="character encoding" class="format-charset must" level="m"> | ||
| 26 | <d:message xml:lang="en">Character encoding <code><var>$0</var></code> | ||
| 27 | is not allowed for <abbr>HTML</abbr> document.</d:message> | ||
| 28 | <d:desc xml:lang="en"> | ||
| 29 | <p>The character encoding used for the document is not allowed | ||
| 30 | for <abbr>HTML</abbr> document. The document is non‐conforming.</p> | ||
| 31 | </d:desc> | ||
| 32 | </d:item> | ||
| 33 | |||
| 34 | <d:item name="character encoding" class="format-charset should" | ||
| 35 | level="s"> | ||
| 36 | <d:message xml:lang="en">Character encoding <code><var>$0</var></code> | ||
| 37 | should not be used for <abbr>HTML</abbr> document.</d:message> | ||
| 38 | <d:desc xml:lang="en"> | ||
| 39 | <p>The character encoding used for the document is not recommended | ||
| 40 | for <abbr>HTML</abbr> document. The document is non‐conforming | ||
| 41 | unless there is any good reason to use that encoding.</p> | ||
| 42 | </d:desc> | ||
| 43 | </d:item> | ||
| 44 | |||
| 45 | <d:item name="character encoding" class="format-charset warning" | ||
| 46 | level="w"> | ||
| 47 | <d:message xml:lang="en">Use of UTF-8 is encouraged.</d:message> | ||
| 48 | <d:desc xml:lang="en"> | ||
| 49 | <p>Use of UTF-8 as the character encoding of the document is encouraged, | ||
| 50 | wakaba | 1.21 | though the use of another character encoding is still conforming.</p> |
| 51 | wakaba | 1.16 | </d:desc> |
| 52 | </d:item> | ||
| 53 | |||
| 54 | wakaba | 1.17 | <d:item name="character encoding" class="format-charset unsupported" |
| 55 | level="unsupported"> | ||
| 56 | <d:message xml:lang="en">Conformance for character encoding requirements | ||
| 57 | cannot be checked.</d:message> | ||
| 58 | <d:desc xml:lang="en"> | ||
| 59 | <p>The conformance checker cannot detect whether the input document | ||
| 60 | met the requirements on character encoding, since the document | ||
| 61 | is not inputed as a serialized byte sequence. The document is | ||
| 62 | not conforming if it is not encoded in an appropriate character | ||
| 63 | encoding with appropriate labeling.</p> | ||
| 64 | </d:desc> | ||
| 65 | </d:item> | ||
| 66 | |||
| 67 | wakaba | 1.16 | <d:item name="no character encoding declaration" class="format-charset error" |
| 68 | level="m"> | ||
| 69 | <d:message xml:lang="en">There is no character encoding | ||
| 70 | declaration.</d:message> | ||
| 71 | <d:desc xml:lang="en"> | ||
| 72 | <p>The document does not contain a character encoding | ||
| 73 | declaration. Unless the character encoding is explicitly | ||
| 74 | wakaba | 1.17 | specified in lower‐level protocol, e.g. in <abbr>HTTP</abbr>, |
| 75 | wakaba | 1.16 | or is implied by <abbr>BOM</abbr>, there must be a character |
| 76 | encoding declaration. The document is non‐conforming.</p> | ||
| 77 | |||
| 78 | <p>The long character encoding declaration syntax | ||
| 79 | <code class="html bad example"><meta http-equiv="Content-Type" content="text/html; charset=<var>charset-name</var>"></code> | ||
| 80 | is obsolete. The new syntax is:</p> | ||
| 81 | <pre class="html example"><code><meta charset="<var>charset-name</var>"></code></pre> | ||
| 82 | |||
| 83 | <p>Note that the <code>encoding</code> declaration in <abbr>XML</abbr> | ||
| 84 | declaration has no effect for <abbr>HTML</abbr> document.</p> | ||
| 85 | </d:desc> | ||
| 86 | </d:item> | ||
| 87 | |||
| 88 | <d:item name="non ascii superset" class="format-charset error" | ||
| 89 | level="m"> | ||
| 90 | <d:message xml:lang="en">No character encoding metadata is found | ||
| 91 | wakaba | 1.17 | in lower‐level protocol nor is there <abbr>BOM</abbr>, while |
| 92 | wakaba | 1.16 | character encoding <code><var>$0</var></code> |
| 93 | is not a superset of <abbr>ASCII</abbr>.</d:message> | ||
| 94 | <d:desc xml:lang="en"> | ||
| 95 | <p>The document is not labeled with character encoding name | ||
| 96 | wakaba | 1.17 | in lower‐level protocol, e.g. in <abbr>HTTP</abbr>, and |
| 97 | wakaba | 1.16 | the document is not begin with <abbr>BOM</abbr>. In addition, |
| 98 | the character encoding of the document is not a superset of | ||
| 99 | <abbr>ASCII</abbr>. The document is non‐conforming.</p> | ||
| 100 | |||
| 101 | <p>Unless there is a <abbr>BOM</abbr>, the character encoding | ||
| 102 | for the document must be specified in e.g. <abbr>HTTP</abbr>‐level, | ||
| 103 | as:</p> | ||
| 104 | <pre class="http example"><code>Content-Type: text/html; charset=<var>charset-name</var></code></pre> | ||
| 105 | |||
| 106 | <p>Existence of <abbr>HTML</abbr> character encoding declaration, i.e. | ||
| 107 | <code class="html example"><meta charset="<var>charset-name</var>"></code>, | ||
| 108 |