test/html-webhacc/error-description.en.html.u8

<!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">
<head>
<title xml:lang="en">Description of Errors — 
Web Document Conformance Checker (BETA)</title>
<link href="cc-style" rel="stylesheet">
<link href="#license" rel="license">
</head>
<body>
<h1>Description of Errors</h1>

<section id="html5-tokenize-error">
<h2>HTML5 Parse Errors in Tokenization Stage</h2>

<div class="section parse-error" id="after-html"><h3>Tag <code>&lt;<var>$0</var>&gt;</code>
  is not allowed after the end tag <code>&lt;/html&gt;</code>.</h3>
    <p>The start or end tag of an element appears after the
    <code>html</code> element has been closed.  The document is
    non-conforming.</p>

    <p>Any content of the document other than comments
    must be put into the <code>html</code> element.</p>
  </div>

<div class="section tokenize-error" id="bare-ero"><h3>The <code>&amp;</code> character must
  introduce a reference.</h3>
    <p>An <code>&amp;</code> (<code>U+0026</code>
    <code class="charname">AMPERSAND</code>) character which
    is not part of any reference appears in the input stream.
    The document is non-conforming.</p>

    <p>The <code>&amp;</code> character must
    be the first character of a reference:
      <dl>
      <dt>Named entity reference</dt>
          <dd><pre class="html example">
<code>&amp;<var>entity-name</var>;</code></pre>
          where <var>entity-name</var> is the name of the
          character entity to be referenced.</dd>
      <dt>Numeric character reference</dt>
          <dd><pre class="html example">
<code>&amp;#<var>d</var>;</code></pre>
          where <var>d</var> is the decimal representation of
          the code position of the character to be referenced.</dd>
      <dt>Hexadecimal character reference</dt>
          <dd><pre class="html example">
<code>&amp;#x<var>h</var>;</code></pre>
          where <var>h</var> is the hexadecimal representation
          of the code position of the character to be referenced.</dd>
      </dl>
    </p>

    <p>To represent <code>&amp;</code> as a data character, use
    named entity reference:
      <pre class="html example">
<code>&amp;amp;</code></pre>
    </p>
  </div>

<div class="section tokenize-error" id="bare-stago"><h3>A <code>&lt;</code> character is not followed
  by tag name or by a <code>!</code> character.</h3>
    <p>A <code>&lt;</code> (<code>U+003C</code> <code class="charname">LESS-THAN
    SIGN</code>) character which is not part of any markup appears
    in the input stream.</p>

    <p>The <code>&lt;</code> character as a data character must
    be escaped as:
    <pre class="html example">
<code>&lt;lt;</code></pre>
    </p>
  </div>

<div class="section tokenize-error" id="bare-nero"><h3>The decimal representation of the code position
  of a character must be specified after <code>&amp;#</code>.</h3>
    <p>An <code>&amp;</code> (<code>U+0026</code>
    <code class="charname">AMPERSAND</code>) character immediately
    followed by a <code>#</code> (<code>U+0023</code>
    <code>NUMBER SIGN</code>) character which
    is not part of any reference appears in the input stream.
    The document is non-conforming.</p>

    <p>The string <code>&amp;#</code> must be the first two characters
    <code>NUMBER SIGN</code>) character must be the first two characters
    of a reference:
      <dl>
      <dt>Numeric character reference</dt>
          <dd><pre class="html example">
<code>&amp;#<var>d</var>;</code></pre>
          where <var>d</var> is the decimal representation of
          the code point of the character to be referenced.</dd>
      <dt>Hexadecimal character reference</dt>
          <dd><pre class="html example">
<code>&amp;#x<var>h</var>;</code></pre>
          where <var>h</var> is the hexadecimal representation
          of the code point of the character to be referenced.</dd>
      </dl>
    </p>

    <p>To represent <code>&amp;#</code> as data characters, use
    named entity reference:
      <pre class="html example">
<code>&amp;amp;#</code></pre>
    </p>
  </div>

<div class="section tokenize-error" id="bare-hcro"><h3>The hexadecimal representation of the code position
  of a character must be specified after <code>&amp;#x</code>.</h3>
   <p>The string <code>&amp;#x</code> or <code>&amp;#X</code> which
   is not part of any reference appears in the input stream.
    The document is non-conforming.</p>

    <p>The string <code>&amp;#x</code> or <code>&amp;#X</code> must
    be the first three characters of a hexadecimal reference:
      <pre class="html example">
<code>&amp;#x<var>h</var>;</code></pre>
    where <var>h</var> is the hexadecimal representation
    of the code point of the character to be referenced.</p>

    <p>To represent <code>&amp;#x</code> as data characters, use
    named entity reference:
      <pre class="html example">
<code>&amp;amp;#x</code></pre>
    </p>
  </div>

<div class="section tokenize-error" id="dash-in-comment"><h3>There is a <code>--</code> sequence
  in a comment.</h3>
    <p>There is a <code>-</code> (<code>U+002D</code>
    <code class="charname">HYPHEN-MINUS</code>) character 
    at the end of the comment or a <code>--</code> sequence
    in the comment.  The document is non-conforming.</p>

    <p>Comments cannot contain a string <code>--</code>, as in XML.
    Unlike SGML, there cannot be more than one comments
    (where <i>comment</i> is an SGML term) in the comment
    declaration.</p>
  </div>

<div class="section tokenize-error" id="duplicate-attribute"><h3>There are two attributes with same name.</h3>
    <p>There are more than one attributes with the same
    name in a tag.  The document is non-conforming.</p>

    <p>The <code>motion</code> attribute is not part of the HTML standard.
    Use <code>img</code> element with animation GIF instead.</p>
  </div>

<div class="section tokenize-error" id="nestc"><h3>Void element syntax (<code>/&gt;</code>) cannot be
  used for this element.</h3>
    <p>Void element syntax (<code>/&gt;</code>) must not be used
    for the element.  The document is non-conforming.</p>

    <p>The void element syntax can only be
    used for <code>base</code>, <code>link</code>, <code>meta</code>,
    <code>hr</code>, <code>br</code>, <code>img</code>, 
    <code>embed</code>, <code>param</code>, <code>area</code>,
    <code>col</code>, and <code>input</code> elements.</p>

    <p>Note that, unlike in XML, the void element syntax has
    no effect in HTML.</p>
  </div>

</section>

<section id="html5-parse-errors">
<h2>HTML5 Parse Errors in Tree Construction Stage</h2>

<div class="section parse-error" id="after-head"><h3>The <code><var>$0</var></code> element cannot be
  inserted between <code>head</code> and <code>body</code> elements.</h3>
    <p>A start tag appears after the <code>head</code> element is closed
    but before the <code>body</code> element is opened.
    The document is non-conforming.</p>
  </div>

<div class="section parse-error" id="DOCTYPE-in-the-middle"><h3>A <code>DOCTYPE</code> appears after any
  element or data character has been seen.</h3>
    <p>A <code>DOCTYPE</code> appears after any element or data character
    has been seen.  The document is non-conforming.</p>
    
    <p>The <code>DOCTYPE</code> must be placed before any
    tag, reference, or data character.  Only white space characters
    and comments can be inserted before the <code>DOCTYPE</code>.</p>
  </div>

<div class="section parse-error" id="in-body"><h3>Tag <code>&lt;<var>$0</var>&gt;</code>
  is not allowed in <code>body</code>.</h3>
    <p>The start or end tag of an element, which 
    cannot be a descendant of <code>body</code> element, appears
    in the input stream while the <code>body</code> element has been opened.
    The document is non-conforming.</p>
  </div>

<div class="section parse-error" id="in-table"><h3>Tag <code>&lt;<var>$0</var>&gt;</code>
  is not allowed in <code>table</code>.</h3>
    <p>The start or end tag of an element, which
    cannot be a child of <code>table</code> element, appears
    in the input stream while the <code>table</code> element has been opened
    but no other element has been opened.  The document is non-conforming.</p>

    <p>In <code>table</code>, only table related elements
    are allowed; any other element must be contained in
    <code>td</code> or <code>th</code> element to form 
    a part of the table, or <code>caption</code> element to create
    a table caption.</p>
  </div>

<div class="section parse-error" id="in-table:#character"><h3>Data character is not allowed in 
  <code>table</code>.</h3>
    <p>A data character appears in <code>table</code>.  The document
    is non-conforming.</p>

    <p>In <code>table</code>, only table related elements
    are allowed; any other element and data character must be contained in
    <code>td</code> or <code>th</code> element to form 
    a part of the table, or <code>caption</code> element to create
    a table caption.</p>
  </div>

<div class="section parse-error" id="missing-start-tag:tr"><h3>Start tag of <code>tr</code>
  element is missing.</h3>
    <p>Start tag of a <code>tr</code> element, which is <em>not</em>
    optional, is missing.  The document is non-conforming.</p>

    <p>In a table section, a <code>&lt;tr&gt;</code> start tag
    must occur before any <code>&lt;td&gt;</code> or
    <code>&lt;th&gt;</code> start tag.  Though the HTML5 parser
    implies the <code>&lt;tr&gt;</code> start tag before
    these start tags, it must be explicitly specified.</p>
  </div>

<div class="section parse-error" id="no-DOCTYPE"><h3>This document does not start with the
  <code>DOCTYPE</code>.</h3>
    <p>The document does not start with a <code>DOCTYPE</code>.
    The document is non-conforming.</p>

    <p>An HTML document must start by a <code>DOCTYPE</code>:
      <pre class="html example">
<code>&lt;!DOCTYPE HTML&gt;</code></pre>
    </p>

    <p>Only white space characters and comments are allowed
    before the <code>DOCTYPE</code>.</p>
  </div>

<div class="section parse-error" id="not-closed"><h3>Element <code><var>$0</var></code> is not
  closed.</h3>
    <p>End tag of an element is not found before, for example,
    an end tag of another element appears or
    the end of the document.  The document is non-conforming.</p>
  </div>

<div class="section parse-error" id="not-HTML5"><h3>This document is written in an old version of 
  HTML.</h3>
    <p>The document contains a <code>DOCTYPE</code> declaration
    that is different from HTML5 <code>DOCTYPE</code> (i.e. <code>&lt;!DOCTYPE 
    HTML&gt;</code>).  The document is non-conforming.</p>

    <p>The document might or might not be conformant to
    some version of HTML.  However, conformance to any HTML
    specification other than HTML5 provides for no practical
    convenience, since Web borwsers will parse any
    HTML document (roughly) as defined in HTML5.</p>
  </div>

<div class="section parse-error" id="unmatched-end-tag"><h3>Element <code><var>$0</var></code> is not
  opened.</h3>
    <p>An end tag appears though no element with the same name
    has been opened.  The document is non-conforming.</p>

    <p>For any end tag in HTML document, there must be a
    corresponding start tag.</p>
  </div>

</section>

<section id="element-content-model-errors">
<h2>Element Content Model Errors</h2>

<div class="section content-model-error" id="character-not-allowed"><h3>Data character is not allowed in this
  context.</h3>
    <p>A data character appears where it is not allowed in this
    context.  The document is non-conforming.</p>

    <p>Possible causes:
      <dl>
      <dt>If the erred element is an inline-level element (such
      as <code>a</code> or <code>span</code>)</dt>
          <dd><p>A data character cannot be a child
          of certain sectioning elements such as <code>body</code>,
          <code>section</code>, and <code>blockquote</code>.</p>

          <p>Any inline-level content must be put
          in e.g. paragraph element such as <code>p</code>.</p></dd>
      <dt>If the erred element is a block-level element (such as
      <code>div</code> or <code>h<var>n</var></code>)</dt>
          <dd><p>Though some elements such as <code>div</code>,
          <code>li</code>, and <code>td</code> allow
          <em>either one</em> of block-level or inline-level content
          is allowed.  If there is a block-level content, 
          any inline-level content must be put
          in e.g. paragraph element such as <code>p</code>.</p></dd>
      </dl>
    </p>
  </div>

<div class="section content-model-error" id="child-element-missing"><h3>There must be a <code><var>$0</var></code>
  element as a child of this element.</h3>
    <p>The content model of the element is so defined that it
    must contain a <code><var>$0</var></code> child element.
    The document is non-conforming.</p>

    <p>For example:
      <ul>
      <li>The <code>head</code> element must contain exactly one
      <code>title</code> child element.</li>
      <li><a href="#child-element-missing:td%7Cth">The <code>tr</code>
      element must contain one or more <code>td</code> or <code>th</code>
      child element.</a></li>
      </ul>
    </p>
  </div>

<div class="section content-model-error" id="child-element-missing:td|th"><h3>There must be a <code>td</code>
  or <code>th</code> element as a child of this element.</h3>
    <p>The <code>tr</code> element must contain at least one
    <code>td</code> or <code>th</code> child element.  The document
    is non-conforming.</p>
  </div>

<div class="section content-model-error" id="element-not-allowed"><h3>This element is not allowed in this 
  context.</h3>
    <p>An element appears where it is not allowed.  The document
    is non-conforming.</p>

    <p><strong>Note</strong>: The conformance checker does
    <em>not</em> support form elements yet.</p>

    <p>Possible causes:
      <dl>
      <dt>If the erred element is an inline-level element (such
      as <code>a</code> or <code>span</code>)</dt>
          <dd><p>An inline-level element cannot be a child
          of certain sectioning elements such as <code>body</code>,
          <code>section</code>, and <code>blockquote</code>.</p>

          <p>Any inline-level content must be put
          in e.g. paragraph element such as <code>p</code>.</p></dd>
      <dt>If the erred element is a block-level element (such as
      <code>div</code> or <code>h<var>n</var></code>)</dt>
          <dd><p>Though some elements such as <code>div</code>,
          <code>li</code>, and <code>td</code> allow
          <em>either one</em> of block-level or inline-level content
          is allowed.  If there is a block-level content, 
          any inline-level content must be put
          in e.g. paragraph element such as <code>p</code>.</p></dd>
      <dt>If the erred element is the root <code>html</code> element</dt>
          <dd><p>In an XHTML document, the root <code>html</code>
          element must have an <code>xmlns</code> attribute
          whose value is set to 
          <code>http://www.w3.org/1999/xhtml</code>.</p></dd>
      </dl>
    </p>
  </div>

</section>

<section id="attribute-errors">
<h2>Attribute Errors</h2>

<div class="section attribute-error" id="attribute-missing"><h3>Required attribute <code><var>$0</var></code>
  is not specified.</h3>
    <p>A required attribute is not specified.  The document
    is non-conforming.</p>

    <p>Some attribute is defined as <i>required</i>.
    For example, any <code>img</code> element must have
    <code>alt</code> and <code>src</code> attributes specified.
    Without required attributes specified, user agents 
    cannot provide the full functionality of the element
    to the user.</p>
  </div>

<div class="section attribute-error" id="in-HTML:xml:lang"><h3>The <code>xml:lang</code> attribute is not 
  allowed in HTML document.</h3>
    <p>The <code>xml:lang</code> attribute is not allowed in
    HTML document.  The document is non-conforming.</p>

    <p>The <code>lang</code> attribute in the <code>null</code>
    namespace for HTML elements is defined as conforming <em>only</em> for
    XML document.</p>

    <p>To specify natural language information in HTML document,
    use <code>lang</code> attribute instead.</p>
    <!-- @@ ISSUE: xml:lang in non-HTML element in DOM5 HTML created
         from an HTML document? -->
  </div>

<div class="section attribute-error" id="in-XML:charset"><h3>The <code>charset</code> attribute is not 
  allowed in XML document.</h3>
    <p>The <code>charset</code> attribute of a
    <code>meta</code> element is not allowed in XML document.
    The document is non-conforming.</p>

    <p>To specify the character encoding used for serialization,
    if necessary, use XML declaration instead:
      <pre class="xml example">
<code>&lt;?xml version=&quot;1.0&quot; encoding=&quot;<var>encoding-name</var>&quot;?&gt;</code></pre>
    </p>
  </div>

<div class="section attribute-error" id="in-XML:lang"><h3>The <code>lang</code> attribute is not 
  allowed in XML document.</h3>
    <p>The HTML <code>lang</code> attribute is not allowed in
    XML document.  The document is non-conforming.</p>

    <p>The <code>lang</code> attribute in <code>null</code>
    namespace for HTML elements is defined as conforming <em>only</em> for
    HTML document.</p>

    <p>To specify natural language information in XML document,
    use <code>xml:lang</code> attribute instead.</p>
  </div>

<div class="section attribute-error" id="in-XML:xmlns"><h3>The <code>xmlns</code> attribute 
  in the <code>null</code> namespace is not allowed in
  XHTML document.  The document is non-conforming.</h3>
    <p>The <code>xmlns</code> attribute in the <code>null</code>
    namespace is not allowed in XHTML document.</p>

    <p>This error should not occur in conformance-checking 
    static documents.</p>
  </div>

</section>

<section id="attribute-value-errors">
<h2>Attribute Value Errors</h2>

<div class="section attribute-value-error" id="enumerated:invalid"><h3>This attribute only allow a limited set of 
  values and the specified value is not one of them.</h3></div>

<div class="section attribute-value-error" id="duplicate-ID"><h3>This identifier has already been
  assigned to another element.</h3></div>

<div class="section attribute-value-error" id="link-type:bad-context"><h3>The link type <code><var>$0</var></code>
  cannot be specified for this element.</h3>
    <p>The specified link type cannot be used for the element.
    The document is non-conforming.</p>

    <p>Link types are associated with limited set of elements.
    They cannot be used with other elements.</p>

    <p>For example, link type <code>bookmark</code>
    can be used with <code>a</code> or <code>area</code> element,
    while it cannot be used with <code>link</code> element.</p>
  </div>

<div class="section attribute-value-error" id="link-type:non-conforming"><h3>The link type <code><var>$0</var></code>
  is non-conforming.</h3>
    <p>The specified link type is non-conforming.  The entire document
    is non-conforming.</p>

    <p>For example, in place of non-conforming link type <code>copyright</code>
    you must use link type <code>license</code>.</p>
  </div>

<div class="section attribute-value-error" id="reserved-browsing-context-name"><h3>This browsing context name is reserved.</h3></div>

</section>

<section id="attribute-value-warnings">
<h2>Attribute Value Warnings</h2>

<div class="section attribute-value-warning should" id="s:link-type:proposed"><h3>Link type <code><var>$0</var></code>
  is proposed but not accepted yet; it <em>should not</em> be
  used until it has been accepted.</h3>
    <p>The link type is in the <i>proposed</i> status; it
    <em>should not</em> be used until it has been
    accepted.</p>

    <p><strong>Warning</strong>: The data served to the
    conforming checker might be out of date; it might have already
    been accepted or rejected, depending on which the document
    might be conforming or non-conforming.  See WHATWG Wiki
    for the latest information.</p>
  </div>

</section>

<section id="table-model-errors">
<h2>Table Model Errors</h2>

<div class="section table-model-error" id="table:colspan-creates-column-with-no-anchored-cell"><h3>This <code>colspan</code> attribute
  results in creating a table column that does not contain
  any cell anchored to it.</h3></div>

<div class="section table-model-error" id="table:no-cell-in-last-row"><h3>The table has no cell (<code>td</code> or
  <code>th</code>) in the last row.</h3></div>

</section>

<section id="imt-warnings">
<h2>Internet Media Type Warnings</h2>

<div class="section should" id="s:IMT:obsolete-subtype"><h3>An <em>obsolete</em> subtype is used.</h3></div>

<div class="section should" id="s:IMT:private-subtype"><h3>A private (<code>x-</code> or <code>x.</code>)
  subtype is used.</h3></div>

<div class="section should" id="s:IMT:unregistered-subtype"><h3>The subtype is not registered to IANA.</h3></div>

</section>

<section id="uri-errors">
<h2>URI (or IRI) Errors</h2>

<div class="section must" id="m:URI::syntax-error"><h3>This string is not an IRI syntactically.</h3></div>

</section>

<section id="uri-warnings">
<h2>URI (or IRI) Warnings</h2>

<div class="section should" id="s:URI::dot-segment"><h3>Dot-segment (<code>.</code> or
  <code>..</code>) should not occur in an absolute reference.</h3>
    <p>Dot-segment (<code>.</code> or <code>..</code>) should
    not occur in an absolute reference.</p>

    <p>In relative references, dot-segments are used to represent
    the current (<code>.</code>) or the parent (<code>..</code>) 
    hierarchy of the path.  Though they are also allowed
    in absolute references, it should be resolved to the
    canonical form before it has been published.</p>
  </div>

<div class="section should" id="s:URI::empty-path"><h3>This IRI should explicitly end with
  <code>/</code>.</h3></div>

<div class="section should" id="s:URI::lowercase-hexadecimal-digit"><h3>Hexadecimal digit in percent-encoding
  should be in lowercase.</h3>
    <p>Hexadecimal digit in percent-encoding string in the IRI
    is in lowercase.  Though the IRI <em>is</em> conforming,
    it should be in uppercase.</p>
  </div>

<div class="section should" id="s:URI::percent-encoded-unreserved"><h3>An unreserved character is 
  percent-encoded.</h3>
    <p>An unreserved character is percent-encoded in the IRI.
    Though it <em>is</em> conforming, it should be in the 
    decoded (or bare) form.</p>
  </div>

</section>

<section id="unsupported-messages">
<h2><i>Unsupported</i> Messages</h2>

<div class="section unsupported" id="unsupported:attribute"><h3>This attribute is not supported by the
  conformance checker; <em>it might or might not be conforming</em>.</h3>
    <p>The conformant checker does not support the attribute.
    It cannot determine whether the document is conforming or not.</p>
  </div>

<div class="section unsupported" id="unsupported:element"><h3>This element is not supported by the
  conformance checker; <em>it might or might not be conforming</em>.</h3>
    <p>The conformant checker does not support the element.
    It cannot determine whether the document is conforming or not.</p>
  </div>

<div class="section unsupported" id="unsupported:link-type"><h3>The link type <code><var>$0</var></code> is not
  standardized or registered at the time of the release of the conformance
  checker; <em>it is non-conforming unless it has now been
  registered</em>.</h3>
    <p>The <code>rel</code> attribute is defined as a list of link types.
    Some common link types are defined in the HTML5 specification.
    Additional link types can be registered to the WHATWG Wiki.
    use of any other link type is non-conforming.</p>

    <p>The specified link type is not part of the standard or registry
    when the database used by the conformance cheker is created.
    The link type might have been added to the registry since then.
    In such case it might be conforming.  Otherwise, the
    document is non-conforming.</p>
  </div>

<div class="section unsupported" id="unsupported:event-handler"><h3>Conformance checking for event handler attribute
  is not supported; <em>it might or might not be conforming.</em></h3></div>

<div class="section unsupported" id="unsupported:language-tag"><h3>Conformance checking for language tag
  is not supported; <em>it might or might not be conforming.</em></h3></div>

<div class="section unsupported" id="unsupported:media-query"><h3>Conformance checking for media query
  is not supported; <em>it might or might not be conforming.</em></h3></div>

<div class="section unsupported" id="unsupported:script"><h3>Conformance checking for script
  language <code><var>$0</var></code> is not supported;
  <em>it might or might not be conforming.</em></h3></div>

<div class="section unsupported" id="unsupported:style"><h3>Conformance checking for style
  language <code><var>$0</var></code> is not supported;
  <em>it might or might not be conforming.</em></h3></div>

</section>


<section id="license">
<h2>License of This Document</h2>

<p>Copyright 2007 <a href="http://suika.fam.cx/~wakaba/who?">Wakaba</a></p>
<p>This library is free software; you can redistribute it
and/or modify it under the same terms as Perl itself.</p>
</section>

<!-- $Date: 2007/07/16 10:55:11 $ -->
</body>
</html>