diff options
Diffstat (limited to 'htdocs')
36 files changed, 2080 insertions, 1119 deletions
diff --git a/htdocs/about.html b/htdocs/about.html index e1adc4e..cb62817 100755 --- a/htdocs/about.html +++ b/htdocs/about.html @@ -1,11 +1,12 @@ -<!--#set var="revision" value="\$Id: about.html,v 1.23 2003-05-24 20:32:45 link Exp $" ---><!--#set var="date" value="\$Date: 2003-05-24 20:32:45 $" +<!--#set var="revision" value="\$Id: about.html,v 1.24 2004-05-09 15:56:49 link Exp $" +--><!--#set var="date" value="\$Date: 2004-05-09 15:56:49 $" --><!--#set var="title" value="About the W3C Markup Validation Service" --><!--#set var="relroot" value="./" --><!--#include virtual="header.html" --> - <div> - <h2 id="skip">About This Service</h2> +<div class="doc"> + <div><a id="skip" name="skip"></a> + <h2>About The W3C Markup Validation Service</h2> <!-- @@@TODO: bring this paragraph up to date --> <p> <a href="./">The @@ -22,7 +23,7 @@ </p> <ul> <li><a title="Source Code for The W3C Markup Validation Service" - href="http://validator.w3.org/source/">Source code availability</a>.</li> + href="source/">Source code availability</a>.</li> <li><a href="todo.html">The TODO list for The <acronym title="World Wide Web Consortium">W3C</acronym> Markup Validation Service</a>.</li> @@ -35,9 +36,9 @@ </div> <div id="others"> - <h2>Other resources</h2> + <h3>Other resources</h3> <div> - <h3>Documentation & Specifications</h3> + <h4>Documentation & Specifications</h4> <ul> <li><a href="http://www.w3.org/MarkUp/"><acronym title="World Wide Web Consortium">W3C</acronym>'s @@ -56,7 +57,7 @@ </ul> </div> <div> - <h3>Online Tools & Other Validators</h3> + <h4>Online Tools & Other Validators</h4> <ul> <li>The <a href="http://www.htmlhelp.com/tools/validator/"><acronym @@ -75,8 +76,7 @@ title="HyperText Markup Language">HTML</acronym> using <a href="http://www.w3.org/People/Raggett/tidy/"><acronym title="HyperText Markup Language">HTML</acronym> tidy</a> - (or use Site Valet's <a href="http://valet.webthing.com/tidy/">web - interface to tidy</a>.)</li> + </li> <li>Validate your <a href="http://www.w3.org/Style/CSS/"><acronym title="Cascading Style Sheets">CSS</acronym></a> using the <a href="http://jigsaw.w3.org/css-validator/"><acronym @@ -101,7 +101,7 @@ </div> <div id="credits"> - <h2>Credits</h2> + <h3>Credits</h3> <p> The <a href="http://lists.w3.org/Archives/Public/www-html/1994Jul/0015">first @@ -176,7 +176,7 @@ </li> </ul> </div> - +</div> <!--#include virtual="footer.html" --> </body> </html> diff --git a/htdocs/accesskeys.html b/htdocs/accesskeys.html index d28df7a..5361395 100755 --- a/htdocs/accesskeys.html +++ b/htdocs/accesskeys.html @@ -1,9 +1,9 @@ -<!--#set var="revision" value="\$Id: accesskeys.html,v 1.4 2003-02-24 23:33:18 ville Exp $" ---><!--#set var="date" value="\$Date: 2003-02-24 23:33:18 $" +<!--#set var="revision" value="\$Id: accesskeys.html,v 1.5 2004-05-09 15:56:49 link Exp $" +--><!--#set var="date" value="\$Date: 2004-05-09 15:56:49 $" --><!--#set var="title" value="Accesskeys Legend For The W3C Markup Validation Service" --><!--#set var="relroot" value="./" --><!--#include virtual="header.html" --> - +<div class="doc"> <div id="skip" class="intro"> <p> The following accesskeys are implemented throughout the @@ -52,7 +52,7 @@ </dl> </div> </div> - +</div> <!--#include virtual="footer.html" --> </body> </html> diff --git a/htdocs/base.css b/htdocs/base.css index 5f78685..2a72685 100644 --- a/htdocs/base.css +++ b/htdocs/base.css @@ -4,14 +4,16 @@ Copyright 2000 W3C (MIT, INRIA, Keio). All Rights Reserved. See http://www.w3.org/Consortium/Legal/ipr-notice.html#Copyright - $Id: base.css,v 1.31 2003-05-24 20:32:45 link Exp $ + $Id: base.css,v 1.32 2004-05-09 15:56:49 link Exp $ */ @import url(results.css); /* CSS for validation results. */ @import url(navbar.css); /* CSS for navigation menu. */ @import url(tips.css); /* CSS for Quality Tips. */ +@import url(docs.css); /* CSS for the Documentation. */ -body { + +html, body { line-height: 120%; color: black; background: white; @@ -19,6 +21,52 @@ body { font-family: "Bitstream Vera Sans", sans-serif; font-style: normal; text-decoration: none; + margin: 0; + padding: 0; + border: 0; +} + +div#main { + padding-top: 1em; +/* margin-right: 7.6em; */ /* no need for this without the righthand bar */ + margin: 0; +} + +div#main p, div#main dt { + padding-left: 1em; + padding-right: 1em; +} + +dt { + margin-top: 1em; +} + +/* Fieldsets in general */ +fieldset { +/* max-width: 80%; */ + margin-left: 1em; + margin-right: 1em; +} + +/* The front-page fieldsets */ +fieldset.front { + background: inherit; + border: 1px dotted #053188; +} + +fieldset.front legend { + color: #053188; + font-variant: small-caps; + padding: .1ex .5ex; +} + +.intro { + font-style: italic; + text-align: justify; +} + +a:link, a:visited { + color: blue; } a:hover { @@ -31,8 +79,8 @@ a:active { background-color: yellow; } -acronym:hover, abbrev:hover {cursor: help} -abbrev[title], acronym[title], span[title] { +acronym:hover, abbr:hover {cursor: help} +abbr[title], acronym[title], span[title], strong[title] { border-bottom: thin dotted; cursor: help; } @@ -44,14 +92,13 @@ pre, code, tt { } a:link img, a:visited img {border-style: none} -a img {color: white} /* The only way to hide the border in NS 4.x */ +a img {color: black} /* The only way to hide the border in NS 4.x */ ul.toc { list-style: none; } ol li { - max-width: 75ex; padding: .1em; } @@ -76,11 +123,8 @@ h2 a {color: black} /* These are usually targets and not links */ h3 a {color: black} /* These are usually targets and not links */ img {vertical-align: middle} -h1#title { - background-color: #eee; - border-bottom: 1px solid black; - padding: .25em; -} + +a.formoptions {text-decoration: none; color: black; border-bottom: 1px dotted #0000DD} /* done vs. tbc for the TODO list */ .done { text-decoration: line-through; } @@ -91,50 +135,43 @@ address img { } address { - padding-top: .5em; padding-right: 1em; padding-left: 1em; - padding-bottom: .5em; - margin-top: 3em;; + margin-top: 3em; border-top: 1px solid black; background-color: #eee; clear: right; } +address { + background-image: url(images/footer); + background-repeat: no-repeat; + background-attachment: scroll; + height: 50px; + background-position: center; +} + p.copyright { - margin-top: 5em; - padding-top: .5em; - font-size: xx-small; - max-width: 75ex; - text-align: justify; + margin-top: 5em; + padding-top: .5em; + font-size: xx-small; + max-width: 85ex; + text-align: justify; text-transform: uppercase; - margin-left: auto; - margin-right: auto; - font-family: monospace; + margin-left: auto; + margin-right: auto; + font-family: monospace; + color: #888; + line-height: 120%; } -p.jumpbar { - text-align: left; +p.copyright a { + color: #88f; text-decoration: none; - margin-left: auto; - margin-right: auto; - padding: 1ex; - background-color: #eee; - border-left: 1px solid black; - border-right: 1px solid black; -} - -p.jumpbar a:hover { - background: #ccc; -} - -.nsnote { - display: none; } .stb {clear: left} - div.colophon { margin-left: 2em; font-style: italic; @@ -152,58 +189,115 @@ h1 { font-weight: bold; font-style: normal; text-decoration: none; - color: #053188 + color: #053188; +} +#banner h1 {font-size: 1.3em; +display: inline} + +#banner { +background-image: url(images/header); +background-repeat: no-repeat; +background-attachment: scroll; +height: 50px; +background-position: right; +margin:0; padding:0; +border-bottom: 1px solid black; +} + +#banner #versioninfo { + font-size: small; + color: #053188; + +} + +h1#title { +/* background-color: #eee; + border-bottom: 1px solid black; + padding: .25em;*/ + padding: 0; + margin: 0; + color: #053188; +} + +/* Used for beta releases. */ +#versioninfo em { + color: red; } h2 { font-family: sans-serif; font-size-adjust: .53; - font-size: 1.75em; - font-weight: 500; + font-size: 1.5em; + text-align: center; + font-weight: bold; font-style: normal; text-decoration: none; + margin-top : 2em; + margin-bottom : 1em; + line-height: 120%; } h3 { font-family: sans-serif; font-size-adjust: .53; - font-size: 1.58em; - font-weight: 500; - font-style: italic; + font-size: 1.3em; + background-color: #eee; + text-indent: 2em; + padding: .2em; + border-top: 1px dotted black; + font-weight: normal; + font-style: normal; text-decoration: none; } h4 { font-family: sans-serif; font-size-adjust: .53; - font-size: 1.33em; - font-weight: 500; + font-size: 1.1em; + font-weight: 600; font-style: normal; - text-decoration: none; + text-decoration: underline; } h5, dt { font-family: sans-serif; font-size-adjust: .53; - font-size: 1.17em; - font-weight: 500; + font-size: 1em; + font-weight: bold; font-style: normal; text-decoration: none; - margin-top: 1em; + text-indent: .5em; + margin:0; } - + h6 { font-family: sans-serif; font-size-adjust: .53; + color: #666; + text-indent: 1em; font-size: 1em; - font-weight: 500; - font-style: normal; + font-style: italic; + margin:0; text-decoration: none; } -/* documentation - table of contents */ -#toc { - border-bottom : 2px dotted black; +/* comma tools table */ + +td.comma-desc { + background: #ffeecc; + border : 1px solid black; + font-family: sans-serif +} + +td.comma-shortcut { + background: #e7e7ff; + border : 1px solid black; + font-family: monospace; +} + +td.comma-tool { + background: #e7e7ff; + border: 1px solid black; } kbd { diff --git a/htdocs/config/tips.cfg b/htdocs/config/tips.cfg index 3d9fb3d..5de5a1e 100644 --- a/htdocs/config/tips.cfg +++ b/htdocs/config/tips.cfg @@ -5,36 +5,21 @@ # the link to it. Will appear in Validation Results pages. To disable # just comment out or delete all lines in this file. # -# $Id: tips.cfg,v 1.7 2003-09-18 16:19:40 dom Exp $ +# $Id: tips.cfg,v 1.8 2004-05-09 15:56:49 link Exp $ # -http://www.w3.org/2001/06tips/good-titles = \ - <strong><title></strong>: \ - the most important element of a quality Web page. - -http://www.w3.org/2001/06tips/noClickHere = \ - Don't use "click here" as link text! - -http://www.w3.org/2001/06tips/Use_h1_for_Title = \ - Use h1 for title! - -http://www.w3.org/2001/06tips/reback = \ - Use standard redirects: don't break the back button! - -# http://www.w3.org/2001/06tips/Doctype = \ -# Don't forget to add a doctype! - -# http://www.w3.org/Provider/Style/URI = \ -# Cool URIs don't change! - -http://www.w3.org/2001/06tips/altAttribute = \ - Use the <code>alt</code> attribute - -http://www.w3.org/2003/07/30-color = \ - If You Pick One Color, Pick Them All - -http://www.w3.org/2003/07/30-font-size = \ - Care With Font Size - -http://www.w3.org/2001/06tips/use-links = \ - Use <link>s in your document
\ No newline at end of file +http://www.w3.org/QA/Tips/good-titles = <strong><title></strong>: the most important element of a quality Web page. +http://www.w3.org/QA/Tips/noClickHere = Don't use "click here" as link text! +http://www.w3.org/QA/Tips/Use_h1_for_Title = Use <h1> for top-level heading +http://www.w3.org/QA/Tips/reback = Use standard redirects: don't break the back button! +http://www.w3.org/QA/Tips/altAttribute = Use the <code>alt</code> attribute +http://www.w3.org/QA/Tips/color = If You Pick One Color Pick Them All +http://www.w3.org/QA/Tips/font-size = Care With Font Size +http://www.w3.org/QA/Tips/use-links = Use <link>s in your document +http://www.w3.org/QA/Tips/iso-date = Use international date format +http://www.w3.org/QA/Tips/png-gif = GIF or PNG +http://www.w3.org/QA/Tips/headings = Use headings to structure your document +http://www.w3.org/QA/Tips/uri-choose = Choose URIs wisely +http://www.w3.org/QA/Tips/uri-manage = Managing URIs +http://www.w3.org/QA/Tips/beyond-validation = Beyond Validation +http://www.w3.org/QA/Tips/goodclassnames = Use <code>class</code> with semantics in mind diff --git a/htdocs/config/validator.conf b/htdocs/config/validator.conf index 0f530e5..eb14659 100644 --- a/htdocs/config/validator.conf +++ b/htdocs/config/validator.conf @@ -1,7 +1,7 @@ # # Main Configuration File for the W3C Markup Validation Service. # -# $Id: validator.conf,v 1.9 2003-11-12 21:20:37 ville Exp $ +# $Id: validator.conf,v 1.10 2004-05-09 15:56:49 link Exp $ # # See 'perldoc Config::General' for the syntax, and be aware that the # 'SplitPolicy' is 'equalsign', ie. keys and values are separated by '\s*=\s*'. @@ -14,7 +14,7 @@ DEBUG = 0 Maintainer = www-validator@w3.org # -# The "Home Page" for the service. +# The "Home Page" for the service. Make sure this ends with a slash. Home_Page = http://validator.w3.org/ # @@ -27,15 +27,17 @@ Element_Ref_URI = http://www.htmlhelp.com/reference/html40/ # # The SGML Library Path. -SGML_Library = /usr/local/validator/htdocs/sgml-lib +#SGML Library = /usr/local/validator/htdocs/sgml-lib +SGML Library = /home/link/Work/w3.org/validator-HEAD/htdocs/sgml-lib # # The SGML Parser to use. Defaults to /usr/bin/onsgmls. -#SGML_Parser = /usr/bin/onsgmls +SGML Parser = /usr/bin/onsgmls # # Location of template files #Template_Path = /usr/local/validator/share/templates/en_US +Template_Path = /home/link/Work/w3.org/validator-HEAD/share/templates/en_US # # Mapping tables etc... diff --git a/htdocs/detailed-form.html b/htdocs/detailed-form.html index f2d7fd5..5f74110 100755 --- a/htdocs/detailed-form.html +++ b/htdocs/detailed-form.html @@ -1,79 +1,71 @@ <tr> <th><label for="charset">Encoding:</label></th> - <td colspan="2"> + <td> <select id="charset" name="charset"> - <option value="(detect automatically)">(detect automatically)</option> - <option value="utf-8 (Unicode, worldwide)">utf-8 (Unicode, worldwide)</option> - <option value="utf-16 (Unicode, worldwide)">utf-16 (Unicode, worldwide)</option> - <option value="iso-8859-1 (Western Europe)">iso-8859-1 (Western Europe)</option> - <option value="iso-8859-2 (Central Europe)">iso-8859-2 (Central Europe)</option> - <option value="iso-8859-3 (Southern Europe)">iso-8859-3 (Southern Europe)</option> - <option value="iso-8859-4 (Baltic Rim)">iso-8859-4 (Baltic Rim)</option> - <option value="iso-8859-5 (Cyrillic)">iso-8859-5 (Cyrillic)</option> - <option value="iso-8859-6-i (Arabic)">iso-8859-6-i (Arabic)</option> - <option value="iso-8859-7 (Greek)">iso-8859-7 (Greek)</option> - <option value="iso-8859-8-i (Hebrew)">iso-8859-8-i (Hebrew)</option> - <option value="iso-8859-9 (Turkish)">iso-8859-9 (Turkish)</option> - <option value="iso-8859-10 (Latin 6)">iso-8859-10 (Latin 6)</option> - <option value="iso-8859-13 (Latin 7)">iso-8859-13 (Latin 7)</option> - <option value="iso-8859-14 (Celtic)">iso-8859-14 (Celtic)</option> - <option value="iso-8859-15 (Latin 9)">iso-8859-15 (Latin 9)</option> - <option value="us-ascii (basic English)">us-ascii (basic English)</option> - <option value="euc-jp (Japanese, Unix)">euc-jp (Japanese, Unix)</option> - <option value="shift_jis (Japanese, Win/Mac)">shift_jis (Japanese, Win/Mac)</option> - <option value="iso-2022-jp (Japanese, email)">iso-2022-jp (Japanese, email)</option> - <option value="euc-kr (Korean)">euc-kr (Korean)</option> - <option value="gb2312 (Chinese, simplified)">gb2312 (Chinese, simplified)</option> - <option value="gb18030 (Chinese, simplified)">gb18030 (Chinese, simplified)</option> - <option value="big5 (Chinese, traditional)">big5 (Chinese, traditional)</option> - <option value="tis-620 (Thai)">tis-620 (Thai)</option> - <option value="koi8-r (Russian)">koi8-r (Russian)</option> - <option value="koi8-u (Ukrainian)">koi8-u (Ukrainian)</option> - <option value="macintosh (MacRoman)">macintosh (MacRoman)</option> - <option value="windows-1250 (Central Europe)">windows-1250 (Central Europe)</option> - <option value="windows-1251 (Cyrillic)">windows-1251 (Cyrillic)</option> - <option value="windows-1252 (Western Europe)">windows-1252 (Western Europe)</option> - <option value="windows-1253 (Greek)">windows-1253 (Greek)</option> - <option value="windows-1254 (Turkish)">windows-1254 (Turkish)</option> - <option value="windows-1255 (Hebrew)">windows-1255 (Hebrew)</option> - <option value="windows-1256 (Arabic)">windows-1256 (Arabic)</option> - <option value="windows-1257 (Baltic Rim)">windows-1257 (Baltic Rim)</option> + <option value="(detect automatically)" selected="selected">(detect automatically)</option> + <option value="utf-8">utf-8 (Unicode, worldwide)</option> + <option value="utf-16">utf-16 (Unicode, worldwide)</option> + <option value="iso-8859-1">iso-8859-1 (Western Europe)</option> + <option value="iso-8859-2">iso-8859-2 (Central Europe)</option> + <option value="iso-8859-3">iso-8859-3 (Southern Europe)</option> + <option value="iso-8859-4">iso-8859-4 (North European)</option> + <option value="iso-8859-5">iso-8859-5 (Cyrillic)</option> + <option value="iso-8859-6">iso-8859-6 (Arabic)</option> + <option value="iso-8859-7">iso-8859-7 (Greek)</option> + <option value="iso-8859-8">iso-8859-8 (Hebrew, visual)</option> + <option value="iso-8859-8-i">iso-8859-8-i (Hebrew, logical)</option> + <option value="iso-8859-9">iso-8859-9 (Turkish)</option> + <option value="iso-8859-10">iso-8859-10 (Latin 6)</option> + <option value="iso-8859-13">iso-8859-13 (Baltic Rim)</option> + <option value="iso-8859-14">iso-8859-14 (Celtic)</option> + <option value="iso-8859-15">iso-8859-15 (Latin 9)</option> + <option value="us-ascii">us-ascii (basic English)</option> + <option value="euc-jp">euc-jp (Japanese, Unix)</option> + <option value="shift_jis">shift_jis (Japanese, Win/Mac)</option> + <option value="iso-2022-jp">iso-2022-jp (Japanese, email)</option> + <option value="euc-kr">euc-kr (Korean)</option> + <option value="gb2312">gb2312 (Chinese, simplified)</option> + <option value="gb18030">gb18030 (Chinese, simplified)</option> + <option value="big5">big5 (Chinese, traditional)</option> + <option value="tis-620">tis-620 (Thai)</option> + <option value="koi8-r">koi8-r (Russian)</option> + <option value="koi8-u">koi8-u (Ukrainian)</option> + <option value="iso-ir-111">iso-ir-111 (Cyrillic KOI-8)</option> + <option value="macintosh">macintosh (MacRoman)</option> + <option value="windows-1250">windows-1250 (Central Europe)</option> + <option value="windows-1251">windows-1251 (Cyrillic)</option> + <option value="windows-1252">windows-1252 (Western Europe)</option> + <option value="windows-1253">windows-1253 (Greek)</option> + <option value="windows-1254">windows-1254 (Turkish)</option> + <option value="windows-1255">windows-1255 (Hebrew)</option> + <option value="windows-1256">windows-1256 (Arabic)</option> + <option value="windows-1257">windows-1257 (Baltic Rim)</option> </select> </td> + <td><label for="fbc"><input id="fbc" name="fbc" type="checkbox" value="1" /> Use Fallback instead of Override</label></td> </tr> <tr> - <th><label for="doctype">Type:</label></th> - <td colspan="2"> - <select id="doctype" name="doctype"> - <option value="Inline">(detect automatically)</option> - <option>XHTML 1.1</option> - <option>XHTML Basic 1.0</option> - <option>XHTML 1.0 Strict</option> - <option>XHTML 1.0 Transitional</option> - <option>XHTML 1.0 Frameset</option> - <option>HTML 4.01 Strict</option> - <option>HTML 4.01 Transitional</option> - <option>HTML 4.01 Frameset</option> - <option>HTML 3.2</option> - <option>HTML 2.0</option> - </select> + <th><label for="doctype">Doctype:</label></th> + <td> +<!--#include virtual="doctype-select.html" --> </td> + <td><label for="fbd"><input id="fbd" name="fbd" type="checkbox" value="1" /> Use Fallback instead of Override</label></td> </tr> <tr> - <th rowspan="3">Options:</th> + <th rowspan="4">Options (<a title="Explanation for these options" href="docs/users.html#Options">Help</a>):</th> <td><label for="ss"><input id="ss" name="ss" type="checkbox" value="1" /> Show Source</label></td> - <td><label for="sp"><input id="sp" name="sp" type="checkbox" value="1" /> Show Parse Tree</label></td> + <td><label for="outline"><input id="outline" name="outline" type="checkbox" value="1" /> Show Outline</label></td> </tr> <tr> - <td><label for="outline"><input id="outline" name="outline" type="checkbox" value="1" /> Show Outline</label></td> + <td><label for="sp"><input id="sp" name="sp" type="checkbox" value="1" /> Show Parse Tree</label></td> <td><label for="noatt"><input id="noatt" name="noatt" type="checkbox" value="1" /> ...exclude attributes</label></td> </tr> <tr> <td><label for="No200"><input id="No200" name="No200" type="checkbox" value="1" /> Validate error pages</label></td> <td><label for="verbose"><input id="verbose" name="verbose" type="checkbox" value="1" checked="checked" /> Verbose Output</label></td> </tr> +<!-- <tr> - <td></td> - <td><input type="submit" value="Validate this page" /></td> - <td></td> + <td colspan="2"><label for="fussy"><input id="fussy" name="fussy" type="checkbox" value="0" /> Fussy Parsing</label></td> </tr> +--> diff --git a/htdocs/detailed.html b/htdocs/detailed.html index 3f27ac1..76e1497 100755 --- a/htdocs/detailed.html +++ b/htdocs/detailed.html @@ -1,10 +1,10 @@ -<!--#set var="revision" value="\$Id: detailed.html,v 1.16 2003-05-24 20:32:45 link Exp $" ---><!--#set var="date" value="\$Date: 2003-05-24 20:32:45 $" +<!--#set var="revision" value="\$Id: detailed.html,v 1.17 2004-05-09 15:56:49 link Exp $" +--><!--#set var="date" value="\$Date: 2004-05-09 15:56:49 $" --><!--#set var="title" value="The W3C Markup Validation Service" --><!--#set var="relroot" value="./" --><!--#include virtual="header.html" --> - <p id="skip"> + <p><a id="skip" name="skip"></a> This form allows you to enter a <acronym title="Universal Resource Identifier">URI</acronym> and have it validated. If you want to validate a file on @@ -12,6 +12,7 @@ Upload Interface</a>. </p> <div> + <fieldset><legend>Validate by URI</legend> <form method="get" action="check"> <table> <tr><th><label title="Address of page to Validate" @@ -25,6 +26,7 @@ </tr> </table> </form> + </fieldset> </div> <!--#include virtual="footer.html" --> </body> diff --git a/htdocs/dev/tests/index.html b/htdocs/dev/tests/index.html index 5b8cce1..11aa4bc 100755 --- a/htdocs/dev/tests/index.html +++ b/htdocs/dev/tests/index.html @@ -1,5 +1,5 @@ -<!--#set var="revision" value="\$Id: index.html,v 1.44 2003-05-24 20:32:46 link Exp $" ---><!--#set var="date" value="\$Date: 2003-05-24 20:32:46 $" +<!--#set var="revision" value="\$Id: index.html,v 1.45 2004-05-09 15:56:50 link Exp $" +--><!--#set var="date" value="\$Date: 2004-05-09 15:56:50 $" --><!--#set var="title" value="The W3C Markup Validation Service: Tests" --><!--#set var="relroot" value="../../" --><!--#include virtual="../../header.html" --> @@ -74,8 +74,13 @@ <div id="errors"> <h2>Error conditions & strange cases</h2> <ul> - <li><a href="../../check/referer">/check/referer</a></li> - <li><a href="../../check?uri=http://www.w3.org/MarkUp">redirect</a></li> + <li><a href="../../check/referer">/check/referer</a> (deprecated)</li> + <li><a href="../../check/referer;verbose=1">/check/referer;verbose=1</a> (unsupported)</li> + <li><a href="../../check/referer;verbose=1;No200=1">/check/referer;verbose=1;No200=1</a> (unsupported)</li> + <li><a href="../../check?uri=referer">/check?uri=referer</a></li> + <li><a href="../../check?uri=referer;verbose=1">/check?uri=referer;verbose=1</a></li> + <li><a href="../../check?uri=referer;verbose=1;No200=1">/check?uri=referer;verbose=1;No200=1</a></li> + <li><a href="../../check?uri=http://www.w3.org/MarkUp">Directory Redirect</a></li> <li><a href="../../check">script invoked with no parameters</a></li> <li><a href="../../check?uri=">uri parameter is empty</a></li> <li><a href="../../check?uri=www.w3.org/">uri is missing http://</a></li> @@ -94,7 +99,7 @@ <li><a href="../../check?uri=http://validator.w3.org/dev/tests/shorttags.html">SHORTTAGS and -wunclosed..</a></li> <li><a href="../../check?uri=http://www.w3.org/1999/09/SVG-access/computer.svg">image/svg</a></li> <li><a href="../../check?uri=http://validator.w3.org/dev/tests/REC-SVG-1_0-minimal.svg">SVG 1.0 Rec. minimal document</a></li> - <li><a href="../../check?uri=http://www.oasis-open.org/committees/xmltest/xmlconf-19990712.xml;ss">xmlconf-19990712.xml</a></li> + <li><a href="../../check?uri=http://www.oasis-open.org/committees/xmltest/xmlconf-19990712.xml;ss">xmlconf-19990712.xml</a></li> </ul> </div> diff --git a/htdocs/dev/tests/outline.html b/htdocs/dev/tests/outline.html new file mode 100644 index 0000000..2146273 --- /dev/null +++ b/htdocs/dev/tests/outline.html @@ -0,0 +1,36 @@ +<?xml version="1.0" encoding="UTF-8"?> +<!DOCTYPE html + PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" + "http://www.w3.org/TR/1999/PR-xhtml1-19991210/DTD/xhtml1-strict.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en"> + <head><title>Headings Nesting/Outline Test</title></head> + <body> +<!-- From 1 to 6... --> + <h1>Level #1 (1 to 6)</h1> + <h2>Level #2 (1 to 6)</h2> + <h3>Level #3 (1 to 6)</h3> + <h4>Level #4 (1 to 6)</h4> + <h5>Level #5 (1 to 6)</h5> + <h6>Level #6 (1 to 6)</h6> +<!-- ...and back again. --> + <h6>Level #6 (6 to 1)</h6> + <h5>Level #5 (6 to 1)</h5> + <h4>Level #4 (6 to 1)</h4> + <h3>Level #3 (6 to 1)</h3> + <h2>Level #2 (6 to 1)</h2> + <h1>Level #1 (6 to 1)</h1> +<!-- Skipping from 1 to 6. --> + <h1>Level #1 (skip up)</h1> + <h6>Level #6 (skip up)</h6> +<!-- Skipping from 6 to 1. --> + <h6>Level #6 (skip down)</h6> + <h1>Level #1 (skip down)</h1> +<!-- Climb down to 6 and leave it for autoclose. --> + <h1>Level #1 (1 to 6)</h1> + <h2>Level #2 (1 to 6)</h2> + <h3>Level #3 (1 to 6)</h3> + <h4>Level #4 (1 to 6)</h4> + <h5>Level #5 (1 to 6)</h5> + <h6>Level #6 (1 to 6)</h6> + </body> +</html> diff --git a/htdocs/dev/tests/shorttags.html b/htdocs/dev/tests/shorttags.html index fe333fa..16e3f4e 100755 --- a/htdocs/dev/tests/shorttags.html +++ b/htdocs/dev/tests/shorttags.html @@ -1,7 +1,7 @@ <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN"> <html> <head> - <title>SHORTTAGS Test</title> + <title/SHORTTAGS Test/ </head> <body> <div<p> diff --git a/htdocs/docs.css b/htdocs/docs.css new file mode 100644 index 0000000..6d0c2de --- /dev/null +++ b/htdocs/docs.css @@ -0,0 +1,88 @@ +/* + Documentation Style Sheet for the W3C Markup Validation Service. + + Copyright 2003 W3C (MIT, INRIA, Keio). All Rights Reserved. + See <http://www.w3.org/Consortium/Legal/ipr-notice.html#Copyright> + + $Id: docs.css,v 1.2 2004-05-09 15:56:49 link Exp $ +*/ + +/* + Please Note: + Every selector in this stylesheet should require a parent element with the + class ".doc" to avoid namespace clashes. Currently the class is set on a + "div" element, but there is no reason to limit it to that. i.e. use the + ".doc" selector as parent, not "div.doc". +*/ + + +/* Margins common (relative) to multiple block elements. */ +.doc h4, .doc h5, .doc p, .doc pre, .doc ul, .doc table +{ + margin-left: 1em; + /* margin-right: 20%; */ +margin-right: 1em; +} + +/* Set line height to 1.5x to allow for various inline decoration. */ +.doc { + line-height: 150%; +} + +/* documentation - table of contents */ +#toc { + font-size: .8em; +} + +.doc div#toc ul { + margin-left: 0; + margin-right: 0; +} + +/* documentation - error explanations */ +dl#expl dt code { /* headings for an error */ + white-space: normal; + font-weight: bold; +} + +dl#expl dt { + border-top: 1px dashed black; + margin-top: 2em; + margin-bottom: 1em; +} + +.doc dd { + margin-right: 0; /* no need for the extra margin if we nicely put the text of the dd in a paragraph */ +} +.doc var { /* headings for an error */ + color: #006; +} + +/* A snippet of code used inline. */ +.doc code { + white-space: normal; + font-weight: bold; + color: #006; + display: inline; + padding-left: .2em; + padding-right: .2em; + background: #eef; + color: #337; + font-family: "Bitstream Vera Sans Mono", monospace; + border: 1px dotted #ccf; +} + +.doc code.block { + display: block; + padding: 1em; + white-space: pre; + margin-top: 1em; + margin-bottom: 1em; + margin-right: 3em; +} + +.doc code samp { + font-weight: normal; + color: black; + font-style: italic; +} diff --git a/htdocs/docs/devel.html b/htdocs/docs/devel.html index cb0cd2d..25a4eae 100755 --- a/htdocs/docs/devel.html +++ b/htdocs/docs/devel.html @@ -1,198 +1,68 @@ -<!--#set var="revision" value="\$Id: devel.html,v 1.15 2003-05-24 20:32:46 link Exp $" ---><!--#set var="date" value="\$Date: 2003-05-24 20:32:46 $" +<!--#set var="revision" value="\$Id: devel.html,v 1.16 2004-05-09 15:56:50 link Exp $" +--><!--#set var="date" value="\$Date: 2004-05-09 15:56:50 $" --><!--#set var="title" value="Developer Documentation for The W3C Markup Validation Service" --><!--#set var="relroot" value="../" --><!--#include virtual="../header.html" --> - <p id="skip"> - The W3C Markup Validation Service consists of an SGML Parser, an SGML - catalog, a CGI program and it's configuration files. In addition it - relies on a moderately large set of Perl modules for it's operation. - </p> +<div class="doc"> +<h2>Installation and development information <br />for the W3C Markup Validator</h2> + +<h3 id="TableOfContents">Table of Contents</h3> + + <div id="toc"> + <ul> + <li><a href="#participate">Participate</a></li> + <li><a href="devel-frame">Development Framework</a> + <ul> + <li><a href="#bug">Bugs and Issue Tracking</a></li> + <li><a href="#test">Test suite</a></li> + <li><a href="#todo">TODO</a></li> + </ul> + </li> + </ul> + </div> + <p> - This document tries to draw a road map of the prerequisites and what the - different parts of the system do. It is intended for system - administrators and people interested in helping developing the validator. - This is not end user documentation. See the - <a href="users.html">User Manual</a> for usage instructions. + <a id="skip" name="skip"></a> + This document is an overview of how developers can modify the Markup Validator, and how to contribute + to the development of the project. It is intended for system administrators and developers. + <strong>This is not end user documentation</strong>. See the <a href="users.html">User Manual</a> for usage instructions. </p> + + <h3><a id="participate" name="participate"></a>Participating in the development of the Markup Validator</h3> + <p>The Markup Validator is managed as an open source project by a <a href="http://www.w3.org/QA/Tools/qa-dev">team + of volunteer developers and people from the W3C Team</a>.</p> + <p> Help on this project is always welcome, usually as <a href="../feedback.html">feedback</a>, + but developers may also be interested in working directly on the code, which is certainly encouraged.</p> - <div id="prereq" class="stb"> - <h2>Prerequisites</h2> - <p> - Apart from a properly configured web server, the Validator needs a - SGML parser -- that does all the hard work -- and several Perl - modules used by the "check" CGI script. - </p> - <p> - The SGML parser we're currently using is <code>OpenSP 1.5</code>, - which can be found on the - <a href="http://openjade.sourceforge.net/">OpenJade home page</a>. - </p> - <p> - The canonical list of Perl modules we use can be found in the source - for the "check" CGI script. There is a bunch of lines that of the form - "use Foo::Bar" where each "Foo::Bar" represents a module. Most modules - can be found on <a href="http://www.cpan.org/">CPAN</a> (minimum - versions in parenthesis after the name). The following - list was complete when CVS spit out: - <code>$Date: 2003-05-24 20:32:46 $</code>. <tt>:-)</tt> - </p> - <dl> - <dt><code>CGI (2.81)</code></dt> - <dd> - The all-singing, all-dancing, - everything-<em>and</em>-the-kitchen-sink, Perl CGI library. This - takes care of all those niggly little bits of CGI for us and make - options parsing and file upload a breeze. - </dd> - <dt><code>CGI::Carp</code></dt> - <dd>CGI-aware warn()/die()</dd> - <dt><code>File::Spec</code></dt><dd>Portable filespecs.</dd> - <dt><code>HTML::Parser (3.25)</code></dt> - <dd>Minimal HTML Parser used for preparse and finding metadata.</dd> - <dt><code>LWP::UserAgent (1.90)</code></dt> - <dd> - Gisle Aas' most excellent WWW library for Perl. This is where our - support for downloading pages off the net comes from. - </dd> - <dt><code>Set::IntSpan</code></dt><dd>Efficient Set operations.</dd> - <dt><code>Text::Iconv</code></dt> - <dd> - Perl-native interface to the (g)libc iconv(3) library. Handles - charset conversion issues. - </dd> - <dt><code>Text::Wrap</code></dt> - <dd>Wrap text to a sane width. Needed for source output in results.</dd> - <dt><code>URI::Escape</code></dt> - <dd>Module to handle escaping special characters in URIs.</dd> - </dl> - </div> - <div id="config" class="stb"> - <h2>Configuration Files</h2> - <p> - The validator uses a number of configuration files -- most of which - are really mapping tables of some form -- to avoid having to check in - a new version of the code every time a new version of HTML comes out. - All configuration files can be found in - <code>$CVSROOT/validator/htdocs/config/</code>. - </p> + <p>This document tries to give a general overview of the development framework for the Markup Validator, and + should help developers get a good idea of how the project is managed.</p> + <p>The next steps would certainly be to read about <a href="../source/">source availability</a> and then try + a <a href="install.html">local installation</a> of the validator, if not done yet. We also (obviously) recommend + to get in touch with other developers, either through <a href="../feedback.html">regular means</a>, or on the + IRC channel #validator on irc.freenode.net where many developers and contributors often are.</p> + + <h3><a name="devel-frame" id="devel-frame"></a>Development Framework</h3> + + <h4>Bug and Issue Tracking System</h4> <p> - To really understand what each does you should read the source, but - here is a short description to get you started. + Bug and Issue Tracking for the Validator happens in the <a + href="http://www.w3.org/Bugs/Public/">W3C Public Bugzilla</a> + instance. Developers should feel free to set up an account + and report bugs, enhancement requests, patches, etc. directly there + (end users should continue to send reports and ideas to the + <a href="http://lists.w3.org/Archives/Public/www-validator/">mailing list</a>). </p> - <dl> - <dt>validator.conf</dt> - <dd> - Main configuration file. Gives various parameters (such as the - address of the maintainer and the URL for the "Home Page") and - the locations of the other configuration files and mapping tables. - </dd> - <dt>types.conf</dt> - <dd> - <p> - The main document type database for the Validator. This file - contains information on all the document types we know of. It - lets us map from a Public Identifier to a plain text version - string, lookup an URL for more information on a DOCTYPE, and - check which Content-Types and Namespaces are legal for this - particular DOCTYPE. - </p> - <p>And entry in this file looks like this:</p> -<pre> -<XHTML_1_1> - Name = html - Display = XHTML 1.1 - Info_URL = http://www.w3.org/TR/xhtml11/ - PubID = -//W3C//DTD XHTML 1.1//EN - SysID = http://www.w3.org/TR/2001/REC-xhtml11-20010531/DTD/xhtml11-flat.dtd - Parse_Mode = XML - <Content_Types> - Allowed = application/xhtml+xml - Forbidden = text/html - Preferred = application/xhtml+xml - </Content_Types> - <Namespaces> - Allowed = http://www.w3.org/1999/xhtml - Required = 1 - </Namespaces> - <Badge> - URI = http://www.w3.org/Icons/valid-xhtml11 - Height = 31 - Width = 88 - </Badge> -</XHTML_1_1> -</pre> - <p> - The name used for each section (e.g. "XHTML_1_1") is arbitrary. - The file will be turned inside out and will end up indexed by - the "PubID". This means that you cannot have two entries with - the same PubID. The rest of the parameters are: - </p> - <table class="config"> - <tr><th>Name</th><td>The "Document Type Name" for this document type.</td></tr> - <tr><th>Display</th><td>The pretty text version for the PubID.</td></tr> - <tr><th>Info_URL</th><td>URL for more information on the PubID.</td></tr> - <tr><th>PubID</th><td>The Formal Public Identifier for this document type.</td></tr> - <tr><th>SysID</th><td>A System Identifier for the DTD.</td></tr> - <tr><th>Parse_Mode</th><td>Boolean describing whether to treat this as XML or SGML.</td></tr> - <tr> - <th>Content_Types</th> - <td class="subtable"> - <table> - <tr><th>Allowed</th><td>Allowed Content-Types</td></tr> - <tr><th>Forbidden</th><td>Forbidden Content-Types</td></tr> - <tr><th>Preferred</th><td>Preferred Content-Types</td></tr> - </table> - </td> - </tr> - <tr> - <th>Namespaces</th> - <td class="subtable"> - <table> - <tr><th>Allowed</th><td>Allowed Namespaces</td></tr> - <tr><th>Required</th><td>Boolean describing whether a Namespace is required in this document type.</td></tr> - </table> - </td> - </tr> - <tr> - <th>Badge</th> - <td class="subtable"> - <table> - <tr><th>URI</th><td>URI for a "Valid Foo" badge.</td></tr> - <tr><th>Height</th><td>Height of this image.</td></tr> - <tr><th>Width</th><td>Width of this image.</td></tr> - </table> - </td> - </tr> - </table> - </dd> - <dt>eref.cfg</dt> - <dd> - Contains the mappings from element names to an URI fragment - (relative to a configurable URI) for their definitions. Used - in output when the "Show Source Input" option is enabled. - </dd> - <dt>frag.cfg</dt> - <dd> - Maps error messages to an URI fragment identifier where an - explanation of that error can be found. - </dd> - <dt>type.cfg</dt> - <dd> - Maps MIME/HTTP Content-Types to an internal "document type" which - is used for treating HTML, XML, and XHTML in different ways. - </dd> - <dt>validator.conf</dt> - <dd> - Main configuration file. Gives various parameters (such as the - address of the maintainer and the URL for the "Home Page") and - the locations of the other configuration files and mapping tables. - </dd> - </dl> - </div> - <div id="todo" class="stb"> - <h2>TODO</h2> + <h4><a id="test" name="test"></a>Test suite</h4> + + <p> + Any changes to the service will attempt to maintain + compatibility with a <a href="../dev/tests/">list of test cases</a>. + </p> + <p>We are in the process of turning this (crude) list into a more manageable + testing framework.</p> + + <h4><a id="todo" name="todo"></a>TODO</h4> <p> The TODO list for the Validator is online at <<a href="../todo.html">http://validator.w3.org/todo.html</a>>. @@ -210,19 +80,9 @@ think is a Good Idea®. While extra features are nice, they shouldn't dilute the value of the validator as an objective check. </p> - </div> - <div id="bugzilla" class="stb"> - <h2>Bugs and Issue Tracking</h2> - <p> - Bug and Issue Tracking for the Validator happens in the <a - href="http://www.w3.org/Bugs/Public/">W3C Public Bugzilla</a> - instance. Developers should feel free to set up an account - and report bugs, enhancement requests, patches, etc. directly there - (end users should continue to send stuff to the mailinglist). - </p> - </div> + +</div> <!--#include virtual="../footer.html" --> </body> </html> - diff --git a/htdocs/docs/errors.html b/htdocs/docs/errors.html index b819f13..43606d1 100755 --- a/htdocs/docs/errors.html +++ b/htdocs/docs/errors.html @@ -1,16 +1,18 @@ -<!--#set var="revision" value="\$Id: errors.html,v 1.26 2003-05-24 20:32:46 link Exp $" ---><!--#set var="date" value="\$Date: 2003-05-24 20:32:46 $" +<!--#set var="revision" value="\$Id: errors.html,v 1.27 2004-05-09 15:56:50 link Exp $" +--><!--#set var="date" value="\$Date: 2004-05-09 15:56:50 $" --><!--#set var="title" value="Error Explanations for The W3C Markup Validation Service" --><!--#set var="relroot" value="../" --><!--#include virtual="../header.html" --> - <p id="skip"> +<h2>Explanation of the error messages<br /> for the W3C Markup Validator</h2> + <p> These error explanations were originally written by Scott Bigham, and are used here with his permission. </p> +<h3 id="TableOfContents">Table of Contents</h3> + <div id="toc"> - <h2 id="TableOfContents">Table of Contents</h2> <ul> <li><a href="#undef-id">ID "<var>FOO</var>" already defined</a></li> <li><a href="#unterm-comment-1">entity end not allowed in comment</a></li> @@ -22,7 +24,7 @@ <li><a href="#undef-tag">element "<var>FOO</var>" undefined</a></li> <li><a href="#not-allowed">document type does not allow element "<var>FOO</var>" here</a></li> <li><a href="#not-contained">document type does not allow element "<var>FOO</var>" here; assuming missing "<var>BAR</var>" start-tag</a></li> - <li><a href="#attr-undef">there is no attribute "<var>FOO</var>" for this element (in this HTML version)</a></li> + <li><a href="#attr-undef">there is no attribute "<var>FOO</var>" for this element (in this <abbr title="HyperText Markup Language">HTML</abbr> version)</a></li> <li><a href="#undef-attr-val">"<var>FOO</var>" is not a member of the group specified in the declared value of this attribute</a></li> <li><a href="#bad-attr-char">syntax of attribute value does not conform to declared value</a></li> <li><a href="#attr-bad-name">value of attribute "<var>FOO</var>" invalid: "#" cannot start a name</a></li> @@ -33,7 +35,7 @@ <li><a href="#omitted-content">end tag for "<var>FOO</var>" which is not finished</a></li> <li><a href="#no-start-tag">start tag for "<var>FOO</var>" omitted, but its declaration does not permit this</a></li> <li><a href="#bad-entity">unknown entity "<var>FOO</var>"</a></li> - <li><a href="#bad-char">non SGML character number ###</a></li> + <li><a href="#bad-char">non <abbr title="Standard Generalized Markup Language">SGML</abbr> character number ###</a></li> <li><a href="#bad-pub-id">cannot generate system identifier for entity `HTML'</a></li> <li><a href="#missing-subel">missing a required sub-element of "<var>FOO</var>"</a></li> <li><a href="#start-tag">start tag was here</a></li> @@ -48,9 +50,9 @@ </ul> </div> - <div> - <h2>Listing of errors and their explanation</h2> - <dl> + <div><a name="skip" id="skip"></a> + <h3>Listing of errors and their explanation</h3> + <dl id="expl"> <dt id="undef-id"><code>ID "<var>FOO</var>" already defined</code></dt> <dd> <p> @@ -61,7 +63,7 @@ values of the id attribute as case-sensitive, they must still be case-insensitive unique in the document. See <a href="http://www.w3.org/TR/html4/struct/links.html#h-12.2.1">Section - 12.2.1 Syntax of anchor names</a> in the HTML 4.01 Recommendation + 12.2.1 Syntax of anchor names</a> in the <abbr title="HyperText Markup Language">HTML</abbr> 4.01 Recommendation for further information. </p> </dd> @@ -71,7 +73,7 @@ Unterminated comment. The position indicator points to the very end of the file, where the problem was detected; to find the beginning of the comment, try searching for the last occurrence of - `<code><!--</code>' in the document. + "<code class="inline"><!--</code>" in the document. </p> </dd> <dt id="unterm-comment-2"><code>name start character invalid: only s and comment allowed in comment declaration</code></dt> @@ -79,13 +81,13 @@ <p> Unterminated comments again. This time, you have a case like: </p> - <pre> - <!-- This is the first unterminated comment > + <code class="block"> + <!-- This is the first unterminated comment ><br /> <!-- This is the second one > - </pre> + </code> <p> - The validator (correctly) interprets the `<code>--</code>' in the - second comment as terminating the first comment, and then interprets + The validator (correctly) interprets the "<code class="inline">--</code>" + in the second comment as terminating the first comment, and then interprets the text of the second comment as text between comments, which is not allowed. </p> @@ -94,8 +96,10 @@ <dd> <p> Most likely an invalid comment of the form - <code><!invalid comment></code>; the validator is (correctly) - attempting to interpret it as an <a href="sgml.html#sgml">SGML</a> + "<code class="inline"><!invalid comment></code>"; the validator is + (correctly) attempting to interpret it as an + <a href="sgml.html#sgml"><abbr + title="Standard Generalized Markup Language">SGML</abbr></a> markup declaration. </p> </dd> @@ -105,14 +109,15 @@ You have an attribute whose value needs to be in quotes. If an attribute value contains any character other than letters, digits, hyphens and periods, it must be enclosed in double quotes (single - quotes would also be OK from an <a href="sgml.html#sgml">SGML</a> + quotes would also be OK from an <a href="sgml.html#sgml"><abbr + title="Standard Generalized Markup Language">SGML</abbr></a> standpoint, but some browsers don't recognize them). </p> </dd> - <dt id="attr-char"><code>character "X" not allowed in attribute specification list</code></dt> + <dt id="attr-char"><code>character "<var>X</var>" not allowed in attribute specification list</code></dt> <dd> <p> - The validator has found a character inside an HTML tag that isn't + The validator has found a character inside an <abbr title="HyperText Markup Language">HTML</abbr> tag that isn't allowed there. This usually means you didn't put an attribute value in quotes when necessary. It also probably means that the character in question is not allowed in the value of the attribute at all, or you @@ -123,14 +128,14 @@ You can also get in trouble by forgetting the closing quote on an attribute. For instance: </p> - <pre> - <IMG SRC="http://foo.com/fred.gif> - <IMG SRC="http://foo.com/joe.gif> - </pre> + <code class="block"> + <img src="http://foo.com/fred.gif><br /> + <img src="http://foo.com/joe.gif> + </code> <p> - The validator will (correctly) interpret this as a SRC value of - <code>"http://foo.com/fred.gif> <IMG SRC="</code>, and then - choke on the following `:'. In this case, the position indicator in + The validator will (correctly) interpret this as a <code class="inline">src</code> + value of <code class="inline">"http://example.com/fred.gif> <img src="</code>, and then + choke on the following "<code>:</code>". In this case, the position indicator in the error message may be several lines below the line with the missing quote. </p> @@ -143,38 +148,43 @@ you've forgotten a closing quote on an attribute value. For instance, in: </p> - <pre> - <IMG SRC="fred.gif> - <!-- 50 lines of stuff --> - <IMG SRC="joe.gif"> - </pre> + <code class="block"> + <img src="fred.gif><br /> + <!-- 50 lines of stuff --><br /> + <img src="joe.gif"> + </code> <p> - The SRC value for the first <code><IMG></code> is the entire + The "<code class="inline">src</code>" value for the first + <code class="inline"><img></code> is the entire fifty lines of stuff up to the next double quote, which probably - exceeds the <a href="sgml.html#sgml">SGML</a>-defined length limit for - HTML string literals. Note that the position indicator in the error + exceeds the <a href="sgml.html#sgml"><abbr + title="Standard Generalized Markup Language">SGML</abbr></a>-defined + length limit for <abbr title="HyperText Markup Language">HTML</abbr> + string literals. Note that the position indicator in the error message points to where the attribute value <em>ended</em> — in - this case, the <code>"joe.gif"</code> line. + this case, the <code class="inline">"joe.gif"</code> line. </p> </dd> <dt id="undef-tag"><code>element "<var>FOO</var>" undefined</code></dt> <dd> <p> You've used an unknown tag (represented here by "<var>FOO</var>"). Make sure the - DTD indicated by your DOCTYPE actually includes this element. + <abbr title="Document Type Definition">DTD</abbr> indicated by your + <code class="inline">DOCTYPE</code> actually includes this element. </p> <p> If the tag in question is a frame-related tag you must use the - "Frameset" DTD, and if you use (deprecated) physical markup ("FONT" - and friends) you must use the "Transitional" DTD. + "Frameset" <abbr title="Document Type Definition">DTD</abbr>, + and if you use (deprecated) physical markup ("FONT" + and friends) you must use the "Transitional" <abbr + title="Document Type Definition">DTD</abbr>. </p> </dd> <dt id="not-allowed"><code>document type does not allow element "<var>FOO</var>" here</code></dt> <dd> <p> - Straightforward, but not terribly informative. There are a - <em>lot</em> of different errors that will generate this error - message: + Straightforward, but not terribly informative. There are several + different mistakes that will generate this error message: </p> <ul> <li> @@ -183,53 +193,60 @@ </li> <li> Using a tag in the wrong place. For instance, - <code><TABLE><TD>blah</TABLE></code> will cause - this error. The trick here is that <code><TABLE></code> cannot - <em>directly</em> contain <code><TD></code>'s; it contains - <code><TR></code>'s which contain <code><TD></code>'s. + <code class="inline"><table><td>blah</table></code> + will cause this error. The trick here is that a <code + class="inline"><table></code> element + cannot <em>directly</em> contain <code class="inline"><td></code> + elements; it contains + one or more <code class="inline"><tr></code> elements which in turn + contain <code class="inline"><td></code> elements. The above example should be - <code><TABLE><TR><TD>blah</TABLE></code>. + <code class="inline"><table><tr><td>blah</table></code>. </li> </ul> </dd> - <dt><a id="not-contained" name="not-contained">document type does not allow element "<var>FOO</var>" here; assuming missing "<var>BAR</var>" start-tag</a>"</dt> + <dt><a id="not-contained"><code>document type does not allow element "<var>FOO</var>" here; assuming missing "<var>BAR</var>" start-tag</code></a></dt> <dd> <p> Similar to the <a href="#not-allowed">previous error</a>, but more specific: in this case, you have a "<var>FOO</var>" element that is not contained - in a "<var>BAR</var>" element when "<var>FOO</var>" is not allowed outside of "<var>BAR</var>". Some of the - most common causes of this error are: + in a "<var>BAR</var>" element when "<var>FOO</var>" is not allowed outside of + "<var>BAR</var>". Some of the most common causes of this error are: </p> <ul> <li> - Using the <code>DD</code> element as a fake paragraph indent. - <code>DD</code> is not allowed outside of a <code>DL</code> element. + Using the "<code class="inline"><dd></code>" element as a fake paragraph + indent. "<code class="inline"><dd></code>" is not allowed outside of a + "<code class="inline"><dl></code>" element. </li> <li> - Improper construction of a nested list. An inner UL or OL in a - nested list may not appear directly within an outer UL/OL, but only - within an LI of the outer UL/OL, as in the following example: - <pre> - <OL> - <LI>Obtain the following items: - <UL> - <LI>Ham</LI> - <LI>Bread; one of: - <UL> - <LI>White</LI> - <LI>Rye</LI> - <LI>Whole wheat</LI> - </UL> - </LI> <!-- End of the "Bread" <LI> --> - <LI>Cheese</LI> - </UL> - </LI> <!-- End of the "Obtain" <LI> --> - <LI>Place ham and cheese between two slices of bread</LI> - <LI>Consume the resulting ham-and-cheese sandwich</LI> - </OL> - </pre> + Improper construction of a nested list. An inner "<code + class="inline"><ul></code>" or "<code class="inline"><ol></code>" + in a nested list may not appear directly within an outer + "<code class="inline"><ol></code>" or "<code class="inline"><ul></code>", + but only within an "<code class="inline"><li></code>" of the outer + "<code class="inline"><ol></code>" or "<code class="inline"><ul></code>", as in the following example: + <code class="block"> +<ol><br /> + <li><samp>Obtain the following items:</samp><br /> + <ul><br /> + <li><samp>Ham</samp></li><br /> + <li><samp>Bread; one of:</samp><br /> + <ul><br /> + <li><samp>White</samp></li><br /> + <li><samp>Rye</samp></li><br /> + <li><samp>Whole wheat</samp></li><br /> + </ul><br /> + </li> <!-- End of the "Bread" <li> --><br /> + <li><samp>Cheese</samp></li><br /> + </ul><br /> + </li> <!-- End of the "Obtain" <li> --><br /> + <li><samp>Place ham and cheese between two slices of bread</samp></li><br /> + <li><samp>Consume the resulting ham-and-cheese sandwich</samp></li><br /> +</ol><br /> + </code> <p> - The <code></LI></code> end tags are optional and are only + The "<code class="inline"></li></code>" end tags are optional and are only included above to emphasize how the structure of the nested list is arranged; if you omit them, the parser will infer their presence in the locations shown above. @@ -242,7 +259,7 @@ corresponding end tag is also missing</a>. </p> </dd> - <dt id="attr-undef"><code>there is no attribute "<var>FOO</var>" for this element (in this HTML version)</code></dt> + <dt id="attr-undef"><code>there is no attribute "<var>FOO</var>" for this element</code></dt> <dd> <p> You have used an attribute with an element that is defined not to have @@ -257,80 +274,91 @@ Similar to the <a href="#attr-undef">previous error</a>; this time, you're using an attribute that is defined for the element, but with a value that isn't defined for the attribute. For instance, the Netscape - extension <code><IMG ALIGN=ABSMIDDLE></code> will cause this - error; ABSMIDDLE isn't one of the allowed values for the ALIGN - attribute of <code><IMG></code> (unless, of course, you provided + extension <code class="inline"><img align="absmiddle"></code> will + cause this error; "<code class="inline">absmiddle</code>" is not one of + the allowed values for the "<code class="inline">align</code>" attribute + of <code class="inline"><img></code> (unless, of course, you provided a Netscape document type). </p> <p> - If you're using the Netscape document type, the BORDER attribute of - <code><TABLE></code> can cause this error. + If you're using the Netscape document type, the + "<code class="inline">border</code>" attribute of + "<code class="inline"><table></code>" can cause this error. </p> <p> This error can also be caused, oddly enough, by missing close quotes on attribute values. For instance, given: </p> - <pre> - <IMG SRC="fred.gif> <IMG SRC="joe.gif> - </pre> + <code class="block"> + <img src="fred.png> <img src="joe.png> + </code> <p> - The validator will (correctly) see a SRC attribute of - <code>"fred.gif> <IMG SRC="</code>, and then try to interpret - JOE.GIF as an attribute of <code><IMG></code>. + The validator will (correctly) see a <code class="inline">src</code> attribute of + "<code class="inline">fred.png> <img src=</code>", and then try to + interpret <code class="inline">joe.png</code> as an attribute of + <code class="inline"><img></code>. </p> </dd> <dt id="bad-attr-char"><code>syntax of attribute value does not conform to declared value</code></dt> <dd> <p> Yet another attribute error; this time, the attribute in question was - defined to take a numeric value, or an <a - href="sgml.html#sgml">SGML</a> identifier value, and you used a - character that doesn't match what it was expecting. + defined to take a numeric value, or an <a href="sgml.html#sgml"><abbr + title="Standard Generalized Markup Language">SGML</abbr></a> identifier + value, and you used a character that doesn't match what it was expecting. </p> <p> One potentially annoying source of this error is the - <code>TD WIDTH</code> attribute. Whether intentionally or by oversight, - the HTML 3.2 DTD defines this attribute to have a value type of NUMBER, - which means that <code><TD WIDTH="50%"></code> is not allowed. + <code class="inline">width</code> attribute on the <code class="inline">td</code> + element. Whether intentionally or by oversight, the <abbr + title="HyperText Markup Language">HTML</abbr> 3.2 <abbr + title="Document Type Definition">DTD</abbr> defines this attribute to have a + value type of <code class="inline">NUMBER</code>, which means that + <code class="inline"><td width="50%"></code> is not allowed. </p> </dd> - <dt id="attr-bad-name"><code>value of attribute "<var>FOO</var>" invalid: "#" cannot start a name</code></dt> + <dt id="attr-bad-name"><code>value of attribute "<var>FOO</var>" invalid: "<var>#</var>" cannot start a name</code></dt> <dd> <p> A special case of <a href="#bad-attr-char">the previous error</a>; the - attribute in question is defined to take as value an SGML name token, - which must begin with a letter. + attribute in question is defined to take as value an <abbr + title="Standard Generalized Markup Language">SGML</abbr> + <code class="inline">NMTOKEN</code>, a name token, which must begin with + a letter. </p> </dd> <dt id="bad-abbrev-attr"><code>"<var>FOO</var>" is not a member of a group specified for any attribute</code></dt> <dd> <p> Another attribute error, this time referring to an "abbreviated" - attribute. <a href="sgml.html#sgml">SGML</a> allows you to omit the - name of an attribute if the attribute value is unambiguous. For - instance, <code><IMG ISMAP></code> is actually an abbreviation - of <code><IMG ISMAP=ISMAP></code>. (Technically, this also means - that e.g. <code><P ALIGN=CENTER></code> could be abbreviated to - <code><P CENTER></code>, but it is unlikely that current - browsers will get this right.) The validator has found something that - looks like an abbreviated attribute but doesn't match the value of any - attribute for this element. For instance, a typo like - <code><IMG ISNAP></code> would produce this error. + (minimized) attribute. <a href="sgml.html#sgml"><abbr + title="Standard Generalized Markup Language">SGML</abbr></a> allows + you to omit the name of an attribute if the attribute value is unambiguous. + For instance, "<code class="inline"><img ismap></code>" is actually an + abbreviation of <code class="inline"><img ismap="ismap"></code>. + The validator has found something that looks like an abbreviated attribute + but doesn't match the value of any attribute for this element. For instance, + a typo like "<code class="inline"><img is<em>n</em>ap></code>" would + produce this error. </p> <p> A missing close quote on a previous attribute value can also trigger this error if the next quote it finds is followed by something that looks like an abbreviated attribute; for instance, - <code><IMG SRC="fred.gif><IMG SRC="joe.gif></code> would - produce this error, referring to the "attribute value" <code>JOE.GIF</code>. + </p> + <code class="block"><img src="fred.png><img src="joe.png></code> + <p> + would produce this error, referring to the "attribute value" + <code class="inline">joe.png</code>. </p> </dd> <dt id="attr-missing"><code>required attribute "<var>FOO</var>" not specified</code></dt> <dd> <p> You left off a required attribute of the indicated element. The most - common such omitted attribute is the <code>ALT</code> attribute of the - <code>AREA</code> or <code>IMG</code> element; browsers will typically + common such omitted attribute is the <code class="inline">alt</code> + attribute of the <code class="inline">area</code> or <code + class="inline">img</code> element; browsers will typically use these to build a menu equivalent to your client-side image map if the user has disabled image loading, so you'll want to use a meaningful value here. @@ -339,63 +367,80 @@ <dt id="no-end-tag"><code>end tag for "<var>FOO</var>" omitted, but its declaration does not permit this</code></dt> <dd> <p> - You forgot to close something. "<var>FOO</var>" is the element you forgot to close - (and the next message, `start tag was here' points to the particular - instance of "<var>FOO</var>" in question); the positional indicator points to where - the validator expected you to close the element. There are a few - common ways that this can happen: + You forgot to close something. "<var>FOO</var>" is the element you forgot to + close (and the next message, "<code class="inline">start tag was here</code>" + points to the particular instance of "<var>FOO</var>" in question); the + positional indicator points to where the validator expected you to close the + element. There are a few common ways that this can happen: </p> <ul> <li> - You've put something inside the "<var>FOO</var>" element that isn't allowed - there. For instance, - <code><UL><LI><H4>fake font change</H4></UL></code> - will cause this error, since headers aren't allowed inside <code><UL></code>'s; the - validator assumes that you meant to close the - <code><UL></code> before opening the <code><H4></code>. + <p> + You've put something inside the "<var>FOO</var>" element that isn't allowed + there. For instance, + </p> + <code class="block"> + <ul><li><h4><samp>fake font change</samp></h4></li></ul> + </code> + <p> + will cause this error, since headers aren't allowed inside <code + class="inline"><ul></code> elements; the validator assumes that you + meant to close the <code class="inline"><ul></code> before opening the + <code class="inline"><h4></code>. + </p> </li> <li> Interlocked elements. For instance, - <code><B><I>nope</B></I></code> will cause - this error. HTML requires that you close elements inside-out + <code class="inline"><b><i><samp>nope</samp></b></i></code> will cause + this error. <abbr title="HyperText Markup Language">HTML</abbr> requires that you close elements inside-out — that is, the last element you opened is the first element you should - close. In this example, you'd have to close the - <code><I></code> before the <code><B></code>. + close. In this example, you'd have to close the <code + class="inline"><i></code> before the <code + class="inline"><b></code>. </li> <li> - Unclosed <code><A></code> tags. Yes, even - <code><A NAME="foo"></code> has to have a corresponding - <code></A></code>. Note that an empty - <code><A NAME></code> element won't be recognized by some browsers; be - sure to put at least a word or two inside the - <code><A></code>. + Unclosed <code class="inline"><a></code> tags. Yes, even + <code class="inline"><a name="foo"></code> has to have a corresponding + <code class="inline"></a></code>. Note that an empty + <code class="inline"><a name="foo"></code> element won't be recognized by some + browsers; be sure to put at least a word or two inside the + <code class="inline"><a></code>. </li> <li> Having unadorned text where the validator was expecting a sub-element of "<var>FOO</var>". For instance, - <code><DL>fake indent</DL></code> will produce this error, - since inside a - <code><DL></code>, the validator only expects to see - <code><DT></code>'s and <code><DD></code>'s. + <code class="inline"><dl><samp>fake indent</samp></dl></code> + will produce this error, since inside a + <code class="inline"><dl></code>, the validator only expects to see + <code class="inline"><dt></code> and <code + class="inline"><dd></code> elements (i.e. you can't just put text + in there). </li> <li> - A tag of the form <code><TABLE WIDTH=100%></code>. The - previous error should have been that the `%' was <a - href="#attr-char">"not allowed in attribute specification list"</a>. - What's happening here is that, in trying to get past the `%', the - validator has become confused and thinks the `%' is <em>inside</em> - the <code><TABLE>...</TABLE></code>, thus triggering the - error message for the previous reason. This error will likely be - followed by mistaken complaints that your <code><TR></code>'s - are <a href="#not-allowed">"not allowed here"</a>, plus a complaint - about your <code></TABLE></code> end tag. The solution is to - put the attribute value in quotes; ie. <code><TABLE - WIDTH="100%"></code>. + <p> + A tag of the form <code class="inline"><table width=100%></code>. + The previous error should have been that the "<code class="inline">%</code>" + was "<a href="#attr-char"><code class="inline">not allowed in attribute + specification list</code></a>". + </p> + <p> + What's happening here is that, in trying to get past the "<code + class="inline">%</code>", the validator has become confused and + thinks the "<code class="inline">%</code>" is <em>inside</em> the + <code class="inline"><table>…</table></code>, + thus triggering the error message for the previous reason. This error + will likely be followed by mistaken complaints that your <code + class="inline"><tr></code> elements are "<a + href="#not-allowed"><code class="inline">not allowed here</code></a>", + plus a complaint about your <code class="inline"></table></code> + end tag. The solution is to put the attribute value in quotes; ie. + <code class="inline"><table width="100%"></code>. + </p> </li> </ul> <p> - In general, you should always explicitly close all elements and - quote all attribute values. + <strong>In general, you should always explicitly close all elements and + quote all attribute values!</strong> </p> </dd> <dt id="floating-close"><code>end tag for element "<var>FOO</var>" which is not open</code></dt> @@ -404,33 +449,40 @@ The validator found an end tag, represented here by "<var>FOO</var>", without a corresponding start tag. This frequently occurs in conjunction with the <a href="#no-end-tag">previous error</a>. For instance, given - <code><B><I>nope</B></I></code>, the validator - will insert a <code></I></code> before the - <code></B></code>, and then will find the - <code></I></code> after the <code></B></code> and will - have nothing to match it with. - </p> - <p> - A subtle variation of this is <code><P><H4>fake font - change</H4></P></code>. <code><H4></code>'s aren't - allowed inside <code><P></code>'s, but since HTML allows you to - omit the <code></P></code> end tag for paragraphs, the validator - assumes that you meant <code><P></P><H4>fake font - change</H4></P></code>, in which case the final - <code></P></code> is indeed superfluous. + <code class="inline"><b><i><samp>nope</samp></b></i></code>, + the validator will insert a <code class="inline"></i></code> before the + <code class="inline"></b></code>, and then will find the + <code class="inline"></i></code> after the <code + class="inline"></b></code> and will have nothing to match it with. + </p> + <p> + A subtle variation of this is <code + class="inline"><p><h4><samp>fake font change</samp></h4></p></code>. + <code class="inline"><h4></code> elements are not allowed inside + <code class="inline"><p></code> elements, but since <abbr + title="HyperText Markup Language">HTML</abbr> allows you to + omit the <code class="inline"></p></code> end tag for paragraphs + (unlike <abbr title="eXtensible HyperText Markup Language">XHTML</abbr>), + the validator assumes that you meant <code + class="inline"><p><em></p></em><h4><samp>fake font + change</samp></h4></p></code>, in which case the final + <code class="inline"></p></code> is indeed superfluous. </p> <p> This error can also be caused by incorrectly supplying an end tag for - "empty" elements like <code><HR></code>, <code><BR></code> - or <code><IMG></code>. + "empty" elements like <code class="inline"><hr></code>, + <code class="inline"><br></code> + or <code class="inline"><img></code>. This is why they are written + <code class="inline"><hr /></code>, <code class="inline"><br /></code>, and + <code class="inline"><img /></code> in <abbr title="eXtensible HyperText Markup Language">XHTML</abbr>. </p> </dd> <dt id="omitted-content"><code>end tag for "<var>FOO</var>" which is not finished</code></dt> <dd> <p> - You have a "<var>FOO</var>" element, but you have omitted some required sub-element - of it. For instance, a <code>TABLE</code> with no <code>TR</code>'s - would cause this error. + You have a "<var>FOO</var>" element, but you have omitted some required + sub-element of it. For instance, a <code class="inline">table</code> + with no <code class="inline">tr</code>'s would cause this error. </p> </dd> <dt id="no-start-tag"><code>start tag for "<var>FOO</var>" omitted, but its declaration does not permit this</code></dt> @@ -438,92 +490,103 @@ <p> The validator expected you to start a "<var>FOO</var>" element at the indicated point. This probably means you've put unadorned text somewhere it - isn't allowed; for instance, <code><UL>fake - indent</UL></code> will cause this error. + isn't allowed; for instance, <code class="inline"><ul><samp>fake + indent</samp></ul></code> will cause this error. </p> </dd> <dt id="bad-entity"><code>unknown entity "<var>FOO</var>"</code></dt> <dd> <p> The validator has found an entity (something like - <code>&this;</code>) that it doesn't recognize. There are a few - possibilities: + <code class="inline">&this;</code>) that it doesn't recognize. + There are a few possibilities: </p> <ul> <li> <p> - A reference to a URI that uses <code>&</code> as a separator - between parameters, such as - "<code>http://example.org/prog?x=1&y=2</code>". + A reference to a <abbr title="Uniform Resource Identifier">URI</abbr> + that uses "<code class="inline">&</code>" as a separator between + parameters, such as "<code + class="inline">http://example.com/cgi-bin/prog?x=1&y=2</code>". </p> <p> - To solve this problem, simply replace all the <code>&</code>'s - in attribute values with <code>&amp;</code> (user agents will - convert them back before following the links.) + To solve this problem, simply replace all the <code + class="inline">&</code>'s + in attribute values with <code class="inline">&amp;</code> + (user agents will convert them back before following the links). </p> <p> - Another way to get around this problem is for the author of the CGI + Another way to get around this problem is for the author of the + <abbr title="Common Gateway Interface">CGI</abbr> program to allow a different value to be used between arguments, - like ';' or '|', which would allow the link to be coded as e.g. - <code><a href="http://example.org/prog?x=1;y=2"></code> + like "<code class="inline">;</code>" or "<code class="inline">|</code>", + which would allow the link to be coded as e.g. + <code class="inline"><a href="http://example.com/cgi-bin/prog?x=1;y=2"></code> </p> </li> <li> - An unterminated entity; for instance, <code>this&ampthat</code> - for "this&that", which the validator (correctly) interprets as a - request for the entity <code>&ampthat;</code>. Technically, any + An unterminated entity; for instance, "<code + class="inline">this&ampthat</code>" + for "<code class="inline">this&that</code>", which the validator + (correctly) interprets as a request for the entity "<code + class="inline">&ampthat;</code>". Technically, any non-alphanumeric character (such as a space) will suffice to terminate the entity, but some browsers get this wrong; the safest thing to do is to terminate all entities with a semicolon, turning - our example into <code>this&amp;that</code>. + our example into "<code class="inline">this&amp;that</code>". </li> <li> - The entity <code>&quot;</code> in conjunction with the HTML 3.2 - <code>DOCTYPE</code>. This entity was <a - href="http://lists.w3.org/Archives/Public/www-html/1997Mar/0003.html">accidentally - omitted</a> from the most recent version of the HTML 3.2 DTD. You + The entity <code class="inline">&quot;</code> in conjunction with the + <abbr title="HyperText Markup Language">HTML</abbr> 3.2 <code>DOCTYPE</code>. + This entity was <a + href="http://lists.w3.org/Archives/Public/www-html/1997Mar/0003.html">accidentally + omitted</a> from the most recent version of the <abbr + title="HyperText Markup Language">HTML</abbr> 3.2 <abbr + title="Document Type Definition">DTD</abbr>. You should be able to ignore this error safely, though if you wish, you - can replace <code>&quot;</code> with the equivalent character - entity <code>&#34;</code>. + can replace <code class="inline">&quot;</code> with the equivalent + character entity <code class="inline">&#34;</code>. </li> </ul> </dd> - <dt id="bad-char"><code>non SGML character number ###</code></dt> + <dt id="bad-char"><code>non <abbr title="Standard Generalized Markup Language">SGML</abbr> character number ###</code></dt> <dd> <p> - You've used an illegal character in your text. HTML uses the standard - ISO8859-1 character encoding, and ISO8859-1 leaves undefined 65 - character codes (0 to 31 inclusive and 127 to 159 inclusive); the - validator has found one of these undefined characters in your - document. The character may appear on your browser as a curly quote, - or a trademark symbol, or some other fancy glyph; on a different + You have used an illegal character in your text. + <abbr title="HyperText Markup Language">HTML</abbr> uses the standard + <a href="http://www.unicode.org/">UNICODE Consortium</a> character repertoire, + and it leaves undefined (among others) 65 character codes (0 to 31 inclusive and 127 to 159 + inclusive) that are sometimes used for typographical quote marks and similar in + proprietary character sets. The validator has found one of these undefined + characters in your document. The character may appear on your browser as a + curly quote, or a trademark symbol, or some other fancy glyph; on a different computer, however, it will likely appear as a completely different character, or nothing at all. </p> <p> Your best bet is to replace the character with the nearest equivalent ASCII character, or to use an appropriate <a - href="http://www.w3.org/hypertext/WWW/MarkUp/html3/latin1.html">character - entity</a>. For more information on ISO8859-1, see <a - href="http://ppewww.ph.gla.ac.uk/%7Eflavell/aflavell.html">Alan + href="http://www.w3.org/hypertext/WWW/MarkUp/html3/latin1.html">character + entity</a>. For more information on Character Encoding on the web, see <a + href="http://ppewww.ph.gla.ac.uk/%7Eflavell/aflavell.html">Alan Flavell</a>'s excellent <a - href="http://ppewww.ph.gla.ac.uk/%7Eflavell/iso8859/">ISO8859-1/HTML - reference</a>. + href="http://ppewww.ph.gla.ac.uk/%7Eflavell/charset/">HTML Character Set Issues</a> + reference. </p> <p> This error can also be triggered by formatting characters embedded in documents by some word processors. If you use a word processor to edit - your HTML documents, be sure to use the "Save as ASCII" or similar + your <abbr title="HyperText Markup Language">HTML</abbr> documents, be sure to use the "Save as ASCII" or similar command to save the document without formatting information. </p> </dd> <dt id="bad-pub-id"><code>cannot generate system identifier for entity "HTML"</code></dt> <dd> <p> - Your <code>DOCTYPE</code> declaration contains a public identifier - that the validator doesn't recognize. See the <a - href="sgml.html#doctype">discussion of <code>DOCTYPE</code></a> for an - explanation of what's happening, and what public identifiers the + Your <code class="inline">DOCTYPE</code> declaration contains a public identifier + that the validator does not recognize. See the <a + href="sgml.html#doctype">discussion of <code class="inline">DOCTYPE</code></a> + for an explanation of what's happening, and what public identifiers the validator recognizes. </p> </dd> @@ -531,7 +594,8 @@ <dd> <p> The element "<var>FOO</var>" is defined to <em>require</em> one or more - sub-elements. One example is TR which requires one or more TD or TH + sub-elements. One example is <code class="inline">tr</code> which requires + one or more <code class="inline">td</code> or <code class="inline">th</code> elements. </p> </dd> @@ -546,14 +610,15 @@ <dd> <p> The document contained bare text where an element was expected. - For instance, you must wrap text in <code><p></code> if it - appears directly inside the <code><body></code>. + For instance, you must wrap text in <code class="inline"><p></code> + if it appears directly inside the <code class="inline"><body></code>. </p> <p> This error may also indicate an unquoted attribute value containing - a reserved character (such as "<samp>/</samp>") which terminates the - attribute. The net effect is that the rest of the attribute value - appears to be plain text, outside any element, to an SGML parser. + a reserved character (such as "<code class="inline">/</code>") which + terminates the attribute. The net effect is that the rest of the attribute + value appears to be plain text, outside any element, to an <abbr + title="Standard Generalized Markup Language">SGML</abbr> parser. </p> </dd> <dt id="unkn-att-val"><code> value of attribute "<var>FOO</var>" cannot be "<var>BAR</var>"; must be one of "<var>FOO</var>", "<var>BAR</var>", "<var>BAZ</var>"</code></dt> @@ -576,9 +641,9 @@ <dt id="dup-attr"><code>duplicate specification of attribute "<var>FOO</var>"</code></dt> <dd> <p> - You have specified an attribute more than once. For instance, you've - used the "height" attribute on the "img" element twice on the same - "img" tag. + You have specified an attribute more than once. For instance, you have + used the "<code class="inline">height</code>" attribute twice on the same + "<code class="inline">img</code>" tag. </p> </dd> <dt id="invalid-attr-val"><code>invalid attribute value</code></dt> @@ -603,7 +668,7 @@ <dt id="inval-comment"><code>invalid comment declaration; check your comment syntax</code></dt> <dd> <p> - There is a syntax error in an SGML Comment Declaration. This may be + There is a syntax error in an <abbr title="Standard Generalized Markup Language">SGML</abbr> Comment Declaration. This may be caused by too many or too few hyphens "-" or that you have included an invalid character in the comment. The next message will be "comment declaration started here". @@ -619,7 +684,8 @@ check if this is the case and insert the proper tag. </p> </dd> - </dl> + </dl> + </div> <!--#include virtual="../footer.html" --> </body> </html> diff --git a/htdocs/docs/help.html b/htdocs/docs/help.html index 19f2050..5f5bba9 100755 --- a/htdocs/docs/help.html +++ b/htdocs/docs/help.html @@ -1,16 +1,34 @@ -<!--#set var="revision" value="\$Id: help.html,v 1.14 2003-05-24 20:32:46 link Exp $" ---><!--#set var="date" value="\$Date: 2003-05-24 20:32:46 $" +<!--#set var="revision" value="\$Id: help.html,v 1.15 2004-05-09 15:56:50 link Exp $" +--><!--#set var="date" value="\$Date: 2004-05-09 15:56:50 $" --><!--#set var="title" value="Help for The W3C Markup Validation Service" --><!--#set var="relroot" value="../" --><!--#include virtual="../header.html" --> +<div class="doc"> +<h2>Help and <acronym title="Frequently Asked Questions">FAQ</acronym> for the Markup Validator</h2> + +<p><q cite="http://lists.w3.org/Archives/Public/www-validator/2004Jan/0101.html">Nothing wrong with +the validator here, it just knows HTML better than you do.</q> -- David Dorward, Validator's +mailing-list.</p> + +<h3 id="TableOfContents">Table of contents</h3> <div id="toc"> -<h2 id="TableOfContents">Table of contents</h2> <ul> <li>About the Markup Validator <ul> + <li> + <a href="#clickedandlost">Help me! I clicked on an icon and ended up + on this strange site!</a> + </li> + <li> + <a href="#validation_basics">What is <em>Markup Validation</em>?</a> + </li> + <li> + <a href="#validandquality">Is validation some kind of quality control? + Does "valid" mean "quality approved by W3C"?</a> + </li> <li> - <a href="#what-is-it">What is the Markup Validator and what does it do?</a> + <strong><a href="#what-is-it">What is the Markup Validator and what does it do?</a></strong> </li> <li> <a href="#why-validate">Why validate?</a> @@ -33,7 +51,7 @@ <li>Using this service <ul> <li> - <a href="#manual">How do I use the Markup validator?</a> + <strong><a href="#manual">How do I use the Markup validator?</a></strong> </li> <li> <a href="#errors">What is (are) this (these) error message(s)?</a> @@ -44,22 +62,24 @@ <li> <a href="#cleanup">I don't want error messages, I want you to clean up my page!</a> </li> + <li> + <a href="#icon">My document is valid, can I use your "valid" icon?</a> + </li> </ul> </li> <li>Miscellaneous (Very) Frequently Asked Questions <ul> <li> - <a href="#faq-doctype">No DOCTYPE Declaration Found!</a> + <a href="#faq-doctype"><q>No DOCTYPE Declaration Found!</q></a> </li> <li> - <a href="#faq-charset">The validator is <q>not able to extract - a character encoding</q></a> + <a href="#faq-charset"><q>No Character Encoding Found!</q></a> </li> <li> <a href="#faq-ampersand">The validator complains about "&" in my URLs!</a> </li> <li> - <a href="#faq-javascript">The validator complains about something in my Javascript!</a> + <a href="#faq-javascript">The validator complains about something in my JavaScript!</a> </li> <li> <a href="#faq-linkandmeta">Why doesn't the validator like my <link ... /> @@ -69,15 +89,81 @@ <a href="#faq-typo">I found some nasty typo like <p<a ...> and the validator accepted it!</a> </li> + <li> + <a href="#faq-referer">/check/referer does not work</a> or the validator says it does not support + my <a href="#faq-referer">"undefined" URI scheme</a> + </li> </ul> </li> </ul> </div> -<div id="skip"> -<h2 id="about">About the Markup Validator</h2> - <h3 id="what-is-it">What is the Markup Validator and what does it do?</h3> +<div><a id="skip" name="skip"></a> +<h3 id="about">About the Markup Validator</h3> + <h4 id="clickedandlost">Help me! I clicked on an icon and ended up on this strange site!</h4> + <p>Don't panic!</p> + + <p> + The author of the Web page you come from once used our service + to <em>validate</em> that page, and the page passed validation. + The author was then authorized to use the icon on that page, as + a claim of <em>validity</em>. The icon is used as a link back to + the validation service, so that the author can <em>revalidate</em> + whenever necessary. This is why, by clicking on the icon, you + followed a link to the current <em>validation results</em> for + the page you came from. + </p> + + <p> + The validation result was certainly positive ("this page is valid..."), + but if it wasn't, you would probably do the author of the page where + the icon was a favor if you could warn him/her of this abnormal situation. + </p> + + + <p> + If you are curious about Markup validation you may read this + help document further, or you may simply use the back button + of your Web browser to come back to the page where you found + the "valid" icon. + </p> + + <h4 id="validation_basics">What is <em>Markup Validation</em>?</h4> + <p>Most pages on the World Wide Web are written in computer languages + (such as <acronym title="Hypertext Markup Language">HTML</acronym>) + that allow Web authors to structure text, add multimedia content, and + specify what appearance, or style, the result should have.</p> + + <p>As for every language, these have their own <em>grammar</em>, <em>vocabulary</em> + and <em>syntax</em>, and every document written with these computer languages + are supposed to follow these rules. However, just as texts in a natural language + can include spelling or grammar errors, documents using Markup languages + may (for various reasons) not be following these rules.</p> + + <p>The process of verifying whether a document actually follows the rules for the + language(s) it uses is called <em>validation</em>, and the tool used for that + is a validator. A document that passes this process with success is called + <em>valid</em>. + </p> + + <h4 id="validandquality">Is validation some kind of quality control? + Does "valid" mean "quality approved by W3C"?</h4> + + <p>Validity is one of the quality criteria for a Web page, but there are + many others. In other words, a <em>valid</em> Web page is not necessarily + a good web page, but an <em>invalid</em> Web page has little chance + of being a good web page.</p> + + <p>For that reason, the fact that the W3C Markup Validator says that + one page passes validation does <strong>not</strong> mean that + W3C assesses that it is a good page. It only means that a tool (not + necessarily without flaws) has found the page to comply with a specific + set of rules. No more, no less. This is also why the "valid ..." icons + should never be considered as a "W3C seal of quality".</p> + + + <h4 id="what-is-it">What is the Markup Validator and what does it do?</h4> <p> The Markup Validator is a free tool and service that checks the syntax of (X)HTML documents.</p> @@ -88,7 +174,7 @@ </p> <p><a href="../about.html">Learn more</a> about the Markup Validator.</p> - <h3 id="why-validate">Why should I validate my HTML pages?</h3> + <h4 id="why-validate">Why should I validate my HTML pages?</h4> <p> One of the important maxims of computer programming is: <q>Be conservative in what you produce; be liberal in what you accept.</q> @@ -108,16 +194,19 @@ sure your pages are legal HTML. The best way to do that is by running your documents through one or more HTML validators. </p> - + <p>A <a href="why.html">lengthier answer</a> to this question is + also available on this site if the explanation above did not satisfy + you. + </p> - <h3 id="who-does-validator">Who owns/maintain the Markup Validator?</h3> - <p>The Markup Validator is Maintained at <acronym + <h4 id="who-does-validator">Who owns/maintain the Markup Validator?</h4> + <p>The Markup Validator is maintained at <acronym title="World Wide Web Consortium">W3C</acronym> by W3C staff and - benevolent collaborators, who receive a lot of help from contributors. - (Read the <a href="http://validator.w3.org:8001/about.html#credits">full credits</a>) + benevolent collaborators, who receive a lot of help from contributors + (read the <a href="../about.html#credits">full credits</a>). </p> - <h3 id="others">What other validators are there?</h3> + <h4 id="others">What other validators are there?</h4> <p> We're doing our best to provide clear and reliable results as well as a good interface with the Markup Validator, but for some reason you @@ -137,7 +226,7 @@ </p> - <h3 id="how">How does The Validator work?</h3> + <h4 id="how">How does The Validator work?</h4> <p> The Validator is based on <a href="http://www.jclark.com/">James Clark</a>'s <code><a href="http://www.jclark.com/sp/">nsgmls</a></code> @@ -146,7 +235,7 @@ resulting error list for easier reading. </p> - <h3 id="howto-feedback">How do I send feedback/bug reports about the Markup Validator?</h3> + <h4 id="howto-feedback">How do I send feedback/bug reports about the Markup Validator?</h4> <p>Read the instructions on our <a href="../feedback.html">Feedback page</a>.</p> </div> @@ -154,12 +243,15 @@ <div> -<h2 id="using">Using this service</h2> - - <h3 id="manual">How do I use this service?</h3> - <p> - Most probably, you will want to use the online Markup Validation service. - Read the <a href="users.html">user's manual</a> for further help with this +<h3 id="using">Using this service</h3> + + <h4 id="manual">How do I use this service?</h4> + <p>Most probably, you will want to use the online Markup Validation service. + The simple way to use this service to validate a Web page is to paste its + address into the <a href="../#uri">text area</a> on the + <a href="..">validator's home page</a>, and press the "Check" button.</p> + <p>There are other possible uses and a few usage options, please + read the <a href="users.html">user's manual</a> for further help with this service. </p> <p> @@ -167,14 +259,14 @@ check out our <a href="devel.html">developer's documentation</a>. </p> - <h3 id="errors">What are these error messages?</h3> - <p>The output of the Markup Validator may be hard to decypher for + <h4 id="errors">What are these error messages?</h4> + <p>The output of the Markup Validator may be hard to decipher for newcomers and experts alike, so we are maintaining a <a - href="http://validator.w3.org:8001/docs/errors.html">list of error + href="errors.html">list of error messages and their interpretation</a>, which should help. </p> - <h3 id="munged-doctype">Many error messages? Don't panic.</h3> + <h4 id="munged-doctype">Many error messages? Don't panic.</h4> <p> Don't panic. Did The Validator complain about your <code>DOCTYPE</code> declaration (or lack thereof)? Make sure your @@ -195,16 +287,58 @@ Markup Validator to clean up your HTML documents in no time. </p> - <h3 id="cleanup">I don't want error messages, I want you to clean up my page!</h3> + <h4 id="cleanup">I don't want error messages, I want you to clean up my page!</h4> <p>The Markup Validator can not do this for you. You may want to have a look at tools such as <a href="http://tidy.sourceforge.net">HTML Tidy</a>.</p> + <h4 id="icon">My document is valid, can I use your "valid" icon?</h4> + <h5>Practical use of the icon</h5> + <p> + <img class="inline-badge" src="http://www.w3.org/Icons/valid-xhtml10" alt="Valid XHTML 1.0!" height="31" width="88" /> + Yes. To show readers that one has taken some care to create an + interoperable Web page, a "W3C valid" badge may be displayed + (here, the "valid XHTML 1.0" badge) <strong>on any page + that validates</strong>. + </p> + <p> + We encourage you to use the XHTML code below (or its HTML equivalent), + but you may use a different code to integrate the icon within your web page + as long as the icon is used as a link to revalidate the Web page it is in. + Sample code is as follows: + </p> + <pre> + <p> + <a href="http://validator.w3.org/check/referer"><img + src="http://www.w3.org/Icons/valid-xhtml10" + alt="Valid XHTML 1.0!" height="31" width="88" /></a> + </p> + </pre> + <h5>License and Guidelines for usage of the "valid" icons</h5> + <p>Web content providers are granted the right to use the "W3C valid" logo + on pages that pass validation (though the use of the + <a href="http://validator.w3.org/">W3C Markup Validator</a>) + for the W3C technology represented by the icon, and <strong>only</strong> + on pages that pass validation. + The icon must be used as a link to revalidate the Web page, thus providing + a way to verify the page author's assertion that it passed validation.</p> + + <p>Note that "W3C Valid" icons are not an endorsement by the W3C of the page's + author, the substantive content of the page, nor its design. + Instead, the icons are <strong>only</strong> a mechanism to identify + pages that have been determined to be valid, and to easily + re-validate pages as often as as they are modified.</p> + + <p>Consequently, the use of the badge is in accordance with and governed by + the W3C <a href="http://www.w3.org/Consortium/Legal/trademark-license">Trademark License</a> + and <a href="http://www.w3.org/Consortium/Legal/logo-usage-20000308.html">Logo and Icon usage</a> + policy.</p> + </div> <div> -<h2 id="very-faq">Miscellaneous (Very) Frequently Asked Questions</h2> -<h3 id="faq-doctype">No DOCTYPE Declaration Found!</h3> - <p> +<h3 id="very-faq">Miscellaneous (Very) Frequently Asked Questions</h3> + <h4 id="faq-doctype">No DOCTYPE Declaration Found!</h4> + <p> A DOCTYPE Declaration is mandatory for most current markup languages and without one it is impossible to reliably validate a document. </p> @@ -243,56 +377,106 @@ "<a href="http://htmlhelp.com/tools/validator/doctype.html">Choosing a DOCTYPE</a>". </p> -<h3 id="faq-charset">The validator is <q>not able to extract -a character encoding</q></h3> + <h4 id="faq-charset"><q>No Character Encoding Found! </q></h4> + + <p>An HTML document should be served along with its character encoding.</p> + + <p> Specifying a character encoding is normally done in the web server + configuration file or administration program. The <a + href="http://www.w3.org/"><abbr + title="World Wide Web Consortium">W3C</abbr></a> <a + href="http://www.w3.org/International/"><abbr + title="Internationalization">I18N</abbr> Activity</a> has collected + <a href="http://www.w3.org/International/O-HTTP-charset" + title="A Few Tips On How To Specify The Character Encoding">a few + tips on how to do this</a> in popular web server implementations. +</p> + <p> + <a href="http://www.iana.org/"><abbr + title="Internet Assigned Numbers Authority">IANA</abbr></a> + maintains the list of <a + href="http://www.iana.org/assignments/character-sets">official + names for character sets</a> and the <abbr + title="Web Design Group">WDG</abbr> has some <a + href="http://www.htmlhelp.com/tools/validator/charset.html">information + to help you correctly specify the character encoding</a>. + </p> + <p> + To quickly check whether the document would validate after addressing + the missing character encoding information, you can use the "Encoding" + form control (accesskey "2") earlier in the page to force an encoding + override to take effect. "iso-8859-1" (Western Europe and North America) + and "utf-8" (Universal, but not commonly used in legacy documents) are + common encodings if you are not sure what encoding to choose. + </p> + -<p>An HTML document should be served along with its character encoding.</p> -<p>WDG has some good documentation on -<a href="http://www.htmlhelp.com/tools/validator/charset.html">using -character encodings</a> that will help you fix your document or the way it is served -by adding the proper character encoding information.</p> -<h3 id="faq-ampersand">The validator complains about "&" in my URLs!</h3> + <h4 id="faq-ampersand">The validator complains about "&" in my URLs!</h4> <p>Most probably, you should read the <a href="http://www.htmlhelp.com/tools/validator/problems.html#amp">ampersand section</a> of WDG's excellent "<a href="http://www.htmlhelp.com/tools/validator/problems.html">common validation problem</a>" </p> -<h3 id="faq-javascript">The validator complains about something in my Javascript!</h3> -<p>Most probably, you should read the -<a href="http://www.htmlhelp.com/tools/validator/problems.html#script">script section</a> -of WDG's excellent -"<a href="http://www.htmlhelp.com/tools/validator/problems.html">common validation problem</a>" -</p> + <h4 id="faq-javascript">The validator complains about something in my JavaScript!</h4> + <p>Most probably, you should read the + <a href="http://www.htmlhelp.com/tools/validator/problems.html#script">script section</a> + of WDG's excellent + "<a href="http://www.htmlhelp.com/tools/validator/problems.html">common validation problem</a>" + </p> -<h3 id="faq-linkandmeta">Why doesn't the validator like my -<link ... /> or <meta ... />?</h3> -<p>HTML is based on <a href="sgml.html">SGML</a> and uses an SGML -feature (called SHORTTAG) (note that this is <strong>not</strong> -the case with XHTML).</p> - -<p>With this feature enabled, the "/" in <link ... /> or <meta ... /> -already closes the link (or meta) tag, and the ">" becomes some regular text, - which is not allowed in the <head> element. Since </head><body> -is optional in HTML (again, <strong>not</strong> in XHTML), it is silently inserted, -thus head-only elements like meta and style as well as -"</head>" and "<body>", which may apear only once, become false. -</p> + <h4 id="faq-linkandmeta">Why doesn't the validator like my + <link ... /> or <meta ... />?</h4> + <p>HTML is based on <a href="sgml.html">SGML</a> and uses an SGML + feature (called SHORTTAG) (note that this is <strong>not</strong> + the case with XHTML).</p> + + <p>With this feature enabled, the "/" in <link ... /> or <meta ... /> + already closes the link (or meta) tag, and the ">" becomes some regular text, + which is not allowed in the <head> element. Since </head><body> + is optional in HTML (again, <strong>not</strong> in XHTML), it is silently inserted, + thus head-only elements like meta and style as well as + "</head>" and "<body>", which may appear only once, become false. + </p> -<p>(explanation courtesy of Christoph Päper)</p> + <p>(explanation courtesy of Christoph Päper)</p> -<h3 id="faq-typo">I found some nasty typo like <p<a ...> -and the validator accepted it!</h3> + <h4 id="faq-typo">I found some nasty typo like <p<a ...> + and the validator accepted it!</h4> -<p>This again (as in the <a href="#faq-linkandmeta">previous case</a>) comes from the -SHORTTAG feature in HTML (<strong>not</strong> in XHTML). The typo is actually a -"shorthand markup" and is a valid construct in HTML, even though its use -<a href="http://www.w3.org/TR/html4/appendix/notes.html#h-B.3.7">is not -recommended</a>.</p> + <p>This again (as in the <a href="#faq-linkandmeta">previous case</a>) comes from the + SHORTTAG feature in HTML (<strong>not</strong> in XHTML). The typo is actually a + "shorthand markup" and is a valid construct in HTML, even though its use + <a href="http://www.w3.org/TR/html4/appendix/notes.html#h-B.3.7">is not recommended</a>. + </p> + <h4 id="faq-referer">/check/referer does not work - or - the validator says it does not support + my "undefined" URI scheme</h4> + + <p>Browsers and other Web agents usually send information about the page they come from, in a + <code>Referer</code> header. The validator uses this information for a features that allows + it to validate whatever page the browser last visited. The "valid" icons on some Web page usually + point to the validation of the page using this feature.</p> + + <p>Unfortunately, some zealous "security software" or Web proxies strip the referrer + information from what the browser sends. Without this information the validator is not able to + find what the URI of the document to validate is, and gives the same error message as when it is + given a type of URI it does not understand.</p> + + <p><strong>How to fix</strong>:</p> + <ul> + <li>Check that it is indeed the <code>Referer</code> issue. The validator should have redirected you to + <code>http://validator.w3.org/check?uri=</code>. Otherwise, check the address you have given the validator.</li> + <li>The validator can not fix this issue. You will have to (ask your administrator to) reconfigure + whichever zealous software is stripping this referrer info.</li> + <li>If you have a link on your page using the "/check/referer" feature, you could replace them with the + a link to the validator without this feature, e.g. <code>http://validator.w3.org/check?uri=http://www.example.com</code></li> + <li>If you have no control over the page or annoying software, simply append the address of the page you wanted validated + to the <code>http://validator.w3.org/check?uri=</code> address.</li> + </ul> +</div> </div> - <!--#include virtual="../footer.html" --> </body> </html> diff --git a/htdocs/docs/index.html b/htdocs/docs/index.html index 29b6ad1..c7bdd71 100755 --- a/htdocs/docs/index.html +++ b/htdocs/docs/index.html @@ -1,20 +1,35 @@ -<!--#set var="revision" value="\$Id: index.html,v 1.9 2003-02-24 23:33:19 ville Exp $" ---><!--#set var="date" value="\$Date: 2003-02-24 23:33:19 $" +<!--#set var="revision" value="\$Id: index.html,v 1.10 2004-05-09 15:56:50 link Exp $" +--><!--#set var="date" value="\$Date: 2004-05-09 15:56:50 $" --><!--#set var="title" value="Documentation Index for The W3C Markup Validation Service" --><!--#set var="relroot" value="../" --><!--#include virtual="../header.html" --> - <p id="skip"> - Here you'll find the documentation for The W3C Markup Validation Service. - What little there is of it; - <a href="../feedback.html">additions eagerly accepted</a>!<tt>:-)</tt> +<div class="doc"><a id="skip" name="skip"></a> +<h2>Documentation for the W3C Markup Validator</h2> + <p> + Here you will find the documentation for The W3C Markup Validation Service. + We are constantly working on improving this documents and adding + new elements, and eagerly welcome <a href="../feedback.html">feedback and additions</a>! </p> + +<h3>For beginners and experts alike</h3> <dl> - <dt><a href="help.html">W3C Validator Help</a></dt> + <dt>W3C Markup Validator + <a href="help.html">Help and <abbr title="Frequently Asked Questions">FAQ</abbr></a></dt> <dd><p>A quick intro and help to get you started, with answers to - a few Frequently Asked Questions. Read this first.</p></dd> - <dt><a href="users.html">W3C Validator Users Guide</a></dt> - <dd><p>The Users Guide for the W3C Validator.</p></dd> + Frequently Asked Questions. <strong>Read this first</strong>.</p></dd> + <dt>W3C Markup Validator <a href="users.html">User's Guide</a></dt> + <dd><p>The User's Guide and tips for the W3C Markup Validator.</p></dd> + <dt><a href="../favelets.html">Favelets</a></dt> + <dd><p>Favelets / Bookmarklets: Validation made fast and easy</p></dd> + <dt><a href="../accesskeys.html">Access Keys</a></dt> + <dd><p>Quick navigation with access keys.</p></dd> + <dt>W3C Markup Validator <a href="errors.html">Error Messages</a></dt> + <dd><p>Explanations of common error messages.</p></dd> +</dl> + +<h3>Experts only</h3> +<dl> <dt><a href="sgml.html">SGML (basics) and the Markup Validator</a></dt> <dd> <p> @@ -22,12 +37,17 @@ Validator with links to further information. </p> </dd> - <dt><a href="errors.html">W3C Validator Error Messages</a></dt> - <dd><p>Explanations of common error messages.</p></dd> + <dt><a href="../source/">Download / Source</a></dt> + <dd><p>Information on source code availability and download instructions for the Markup Validator</p></dd> + <dt><a href="install.html">Installation Guide</a></dt> + <dd><p>Step-by step guide for the installation of the Markup Validator + on <em>your</em> server.</p></dd> <dt><a href="devel.html">Developer Information</a></dt> - <dd><p>Information about the Validator for programmers.</p></dd> + <dd><p>Information for programmers wanting to play with the validator's code, and/or contribute to its development.</p></dd> </dl> +</div> + <!--#include virtual="../footer.html" --> </body> </html> diff --git a/htdocs/docs/install.html b/htdocs/docs/install.html new file mode 100755 index 0000000..7f49476 --- /dev/null +++ b/htdocs/docs/install.html @@ -0,0 +1,298 @@ +<!--#set var="revision" value="\$Id: install.html,v 1.2 2004-05-09 15:56:50 link Exp $" +--><!--#set var="date" value="\$Date: 2004-05-09 15:56:50 $" +--><!--#set var="title" value="Installation Documentation for The W3C Markup Validation Service" +--><!--#set var="relroot" value="../" +--><!--#include virtual="../header.html" --> + +<div class="doc"> +<h2>Installation information <br />for the W3C Markup Validator</h2> + +<h3 id="TableOfContents">Table of Contents</h3> + + <div id="toc"> + <ul> + <li><a href="#otherguides">This guide, and other guides</a></li> + <li><a href="#install-package">(Installing from) Packaged systems</a></li> + <li><a href="#install-fromsource">Install from source</a> (generic case) + <ul> + <li><a href="#install-download">Download</a></li> + <li><a href="#install-prereq">Prerequisites</a></li> + <li><a href="#install-components">Install components</a></li> + <li><a href="#install-configure">Configure</a></li> + <li><a href="#install-check">Check the installation</a></li> + </ul> + </li> + <li><a href="#install-troubleshoot">Installation troubleshooting</a></li> + <li><a href="#credits">Credits and Acknowledgments</a></li> + </ul> + </div> + + + <div id="install" class="stb"> + <a name="skip" id="skip"> </a> + + <h3 id="otherguides">This guide, and other guides</h3> + <h4>Other installation guides</h4> + <p>The installation guide we provide here is a rather generic set of instructions, + which should work on most systems. To our knowledge, the following platform-specific + guides are also available and can be of interest :</p> + <ul> + <li><a href="http://www.mediaville.net/articles/validator/">Mac OS X and OS X Server</a> + by Stephen Yoch,</li> + <li><a href="http://lists.w3.org/Archives/Public/www-validator/2003Dec/0023.html">Linux (Slackware)</a> + by Nick Talbott</li> + </ul> + <h4>Related documentation</h4> + <p>This installation guides presumes knowledge of the <a href="../source/">Source availability</a> for the + Markup Validator.</p> + <p>We recommend that <a href="devel.html">developers</a> wishing to contribute on the Markup Validator or modify it + go through this installation procedure once, to get familiar with the system.</p> + + <h3 id="install-package">Installing on packaged systems</h3> + + <p>The easiest way to install released versions of the Markup Validator is to use the packages created + for some platforms by contributors: Debian GNU/Linux and Fedora Core / Red Hat Linux packages are + <a href="../source/">available</a>.</p> + + <h3 id="install-fromsource">Installing from source (generic case)</h3> + <p>These instructions are strongly inspired from Nick Talbott's guide for Linux Slackware. Thanks Nick!</p> + <h4><a id="install-download" name="install-download"></a>Download</h4> + <p>Download the <a href="http://validator.w3.org/validator.tar.gz">Validator's Tar Ball</a> + and the <a href="http://validator.w3.org/sgml-lib.tar.gz">DTD library</a> from our site.</p> + <p>Alternatively, if you want to work on the latest development version, you can download + both from our CVS repository, but you should be aware that this version may not work at all.</p> + <p>(<a href="../source/">Read more</a> about retrieving the source)</p> + + <h4><a id="install-prereq" name="install-prereq"></a>Prerequisites</h4> + + <p> + Apart from a properly configured Web server, the Validator needs a + SGML parser -- that does all the hard work -- and several Perl + modules used by the "check" CGI script. + </p> + <h5>SGML Parser: Open SP</h5> + <p> + The SGML parser we're currently using is <code>OpenSP 1.5</code>, + which can be found on the + <a href="http://openjade.sourceforge.net/">OpenJade home page</a>. + </p> + + <h5>Perl Modules</h5> + <p> + The canonical list of Perl modules we use can be found in the source + for the "check" CGI script. There is a bunch of lines that of the form + "use Foo::Bar" where each "Foo::Bar" represents a module. Most modules + can be found on <a href="http://www.cpan.org/">CPAN</a> (minimum + versions in parenthesis after the name). The following + list was complete when CVS spit out: + <code>$Date: 2004-05-09 15:56:50 $</code>. <tt>:-)</tt> + </p> + + <p>One easy - and strongly recommended - way to take care of all these Perl module dependencies is to + install the <a href="http://search.cpan.org/dist/Bundle-W3C-Validator/">bundle available through CPAN</a> + as Bundle-W3C-Validator.</p> + + <h5>List of required Perl modules</h5> + + <dl> + <dt><code>CGI (2.81)</code></dt> + <dd> + The all-singing, all-dancing, + everything-<em>and</em>-the-kitchen-sink, Perl CGI library. This + takes care of all those niggly little bits of CGI for us and make + options parsing and file upload a breeze. + </dd> + <dt><code>CGI::Carp</code></dt> + <dd>CGI-aware warn()/die()</dd> + <dt><code>File::Spec</code></dt> + <dd>Portable file and path name operations.</dd> + <dt><code>HTML::Parser (3.25)</code></dt> + <dd>Minimal HTML Parser used for preparse and finding metadata.</dd> + <dt><code>LWP::UserAgent (1.90)</code></dt> + <dd> + Gisle Aas' most excellent WWW library for Perl. This is where our + support for downloading pages off the net comes from. + </dd> + <dt><code>Set::IntSpan</code></dt><dd>Efficient Set operations.</dd> + <dt><code>Text::Iconv</code></dt> + <dd> + Perl-native interface to the (g)libc iconv(3) library. Handles + character set conversion issues. + </dd> + <dt><code>Text::Wrap</code></dt> + <dd>Wrap text to a sane width. Needed for source output in results.</dd> + <dt><code>URI::Escape</code></dt> + <dd>Module to handle escaping special characters in URIs.</dd> + </dl> + + <h4><a id="install-components" name="install-components"></a>Install the various necessary components:</h4> + <ol> + <li><p>The installation guide assumes that you have a working Web server. We suggest + the popular Apache server, which is used for the W3C Markup Validation service. + The validator may work with other Web servers than the popular Apache, but + we can not guarantee that it will. You will also need a working installation + of the Perl language (standard on most Web servers).</p></li> + + <li><p>Proceed with the Prerequisites, as detailed above.</p></li> + + <li><p>Create a directory for the validator's installation. On Unix-based systems, + the default will be <code>/usr/local/validator</code>.This directory + will be referred as [validatorpath] throughout this guide.</p></li> + + <li><p>Unpack the archives of the validator and DTD library into <code>[validatorpath]</code></p> + <p>The <code>[validatorpath]</code> directory should now have subdirectories named + <code>htdocs</code>, <code>httpd</code>, <code>config</code> and <code>sgml-lib</code> + (if you used CVS, the latter is actually in the <code>htdocs</code> subdirectory, + but that is not really important).</p></li> + </ol> + <h4><a id="install-configure" name="install-configure"></a>Configure</h4> + <h5>Configuration files</h5> + + <p> + For reference, here is an overview of all the configuration files for + the Markup Validator. + </p> + + <p> + The validator uses a number of configuration files -- most of which + are really mapping tables of some form -- to avoid having to check in + a new version of the code every time a new version of HTML comes out. + All configuration files can be found in + <code>$CVSROOT/validator/htdocs/config/</code>. + </p> + <p> + To really understand what each does you should read the source, but + here is a short description to get you started. + </p> + <dl> + <dt>eref.cfg</dt> + <dd> + Contains the mappings from element names to an URI fragment + (relative to a configurable URI) for their definitions. Used + in output when the "Show Source Input" option is enabled. + </dd> + <dt>fpis.cfg</dt> + <dd> + Maps FPIs to plain text version strings. + </dd> + <dt>frag.cfg</dt> + <dd> + Maps error messages to an URI fragment identifier where an + explanation of that error can be found. + </dd> + <dt>type.cfg</dt> + <dd> + Maps MIME/HTTP Content-Types to an internal "document type" which + is used for treating HTML, XML, and XHTML in different ways. + </dd> + <dt>validator.conf</dt> + <dd> + Main configuration file. Gives various parameters (such as the + address of the maintainer and the URL for the "Home Page") and + the locations of the other configuration files and mapping tables. + </dd> + </dl> + + + + <h5>Configure the Web server</h5> + <p>The following instructions are for the Apache Web server, and should be adapted + if you plan on using another server.</p> + <ol> + <li><p>Edit the configuration of your Web server to refer to the specific configuration file + for the Validation service.</p> + <p>This can be done by adding this line:</p> + <pre>Include [validatorpath]/httpd/conf/validator-httpd.conf</pre> + </li> + + <li><p>Copy <code>[validatorpath]/httpd/conf/httpd.conf</code> to + <code>[validatorpath]/httpd/conf/validator-httpd.conf</code> and start + editing this file.</p></li> + + <li><p>You may want to set up a "virtual server" for the service. This can be done + by adding something similar to the following :</p> +<pre><VirtualHost 127.0.0.1> + DocumentRoot [validatorpath]/htdocs/ + ServerName validator.example.org +</VirtualHost></pre> + <p><strong>AND/OR</strong> you may want to have the service at a specific location + on your Web server, which can be configured as follows :</p> + <pre>Alias /validator/ [validatorpath]/htdocs/</pre> + </li> + + <li><p>Finish editing this HTTP server configuration file, adapting + all the directory references to reflect the paths used in your installation.</p></li> + + <li><p>Now restart the Web server to activate the updated configuration.</p><p> For Apache + this is done by typing into a shell, as System Administrator: + <code>apachectl graceful</code> (or, for older versions of Apache + <code>apachectl configtest</code> then <code>apachectl restart</code>)</p></li> + </ol> + + <h5>Configure the Validator itself</h5> + <ol> + <li><p>Create the directory <code>/etc/w3c</code> and create a file called + <code>validator.conf</code> using the file + <code>[validatorpath]/htdocs/config/validator.conf</code> as + template.</p></li> + <li><p> + Make changes to reflect where files are in your installation.</p> + This file is well commented and this should be relatively straightforward. </li> + </ol> + <h4>Check the installation</h4> + <ol> + <li><p>Point your browser at the new site.</p></li> + <li><p>Check the error log of the Web server to get clues on what may be wrong + if you get any server errors.</p></li> + </ol> + + <p><strong>Help us</strong> improve this installation guide by sending us your feedback + if you install the validator on your local system!</p> + + <h3 id="install-troubleshoot">Troubleshooting a new installation</h3> + <p>It is not always easy to troubleshoot an incomplete, or failed, installation of + the Markup Validator. While the instructions given in this page should help most people + install the validator successfully on their system, bad luck, a forgotten step + or a broken component can make things go sour.</p> + + <h4>Double check the installation steps</h4> + <p>The first sound thing to do if the installation failed would be to check that you did not forget + any step while installing. properly copying and editing the configuration file is among the common + mistakes, for example.</p> + + <h4>Check the logs</h4> + <p>The error logs for your Web server should be a good first place to look for hints on what + is wrong with your installation.</p> + + <h4>Check the dependencies</h4> + <p>A common problem with a newly installed validator is a validator that is apparently running + but marking anything as "invalid", without giving any error message as output.</p> + + <p>This is somewhat typical of a problem with OpenSP. Cross-check that you actually have a version + above 1.5, by running <kbd>onsgmls --version</kbd>.</p> + + + <h4>The miracle debug options</h4> + <p>If the validator is misbehaving, you can try forcing various debug options by appending to + the URI the following string: <kbd>&debug=1&errors=1&esis=1&verbose=1</kbd></p> + + <p>This can sometimes provide you with error messages that would not have appeared anywhere in + non-debug mode, and can be helpful to diagnose the problem</p> + + <h4>If all fails...</h4> + <p>Don't hesitate to contact the public mailing-list www-validator@w3.org with all the details + you can provide on what you did, tried, and what went wrong...</p> + +</div> + + <div id="credits" class="stb"> + <h3>Credits and Acknowledgments</h3> +<p>The Validator Team wishes to thank Nick Talbott and Stephen Yoch for their help +in creating the following installation instructions. Thanks also to all the people who +use and review the guide to make it better and better!</p> + + </div> +</div> +<!--#include virtual="../footer.html" --> + </body> +</html> diff --git a/htdocs/docs/sgml.html b/htdocs/docs/sgml.html index 3a40ae7..88b38ca 100755 --- a/htdocs/docs/sgml.html +++ b/htdocs/docs/sgml.html @@ -1,10 +1,13 @@ -<!--#set var="revision" value="\$Id: sgml.html,v 1.14 2003-05-24 20:32:46 link Exp $" ---><!--#set var="date" value="\$Date: 2003-05-24 20:32:46 $" +<!--#set var="revision" value="\$Id: sgml.html,v 1.15 2004-05-09 15:56:50 link Exp $" +--><!--#set var="date" value="\$Date: 2004-05-09 15:56:50 $" --><!--#set var="title" value="Introduction To SGML for The W3C Markup Validation Service" --><!--#set var="relroot" value="../" --><!--#include virtual="../header.html" --> - <div id="skip"> - <h2 id="sgml">What is SGML?</h2> +<div class="doc"><a id="skip" name="skip"></a> +<h2>Introduction to SGML<br /> for the W3C Markup Validator</h2> + + <div> + <h3 id="sgml">What is SGML?</h3> <p> SGML stands for Standard Generalized Markup Language. This is actually a slight misnomer, since SGML is actually a @@ -24,7 +27,7 @@ </div> <div> - <h2 id="dtd">What is a DTD?</h2> + <h3 id="dtd">What is a DTD?</h3> <p> For our purposes, a DTD, or Document Type Definition, is simply a file that defines the syntax of a <a href="#sgml">SGML</a>-based language. @@ -42,8 +45,8 @@ </div> <div> - <h2 id="doctype">What is this <code>DOCTYPE</code> thing The Validator - keeps pestering me for?</h2> + <h3 id="doctype">What is this <code>DOCTYPE</code> thing The Validator + keeps pestering me for?</h3> <p> A <code>DOCTYPE</code> is a <a href="#sgml">SGML</a> document type @@ -93,6 +96,7 @@ The Validator. </p> </div> +</div> <!--#include virtual="../footer.html" --> </body> </html> diff --git a/htdocs/docs/users.html b/htdocs/docs/users.html index ae5ecf6..1cd6f6f 100755 --- a/htdocs/docs/users.html +++ b/htdocs/docs/users.html @@ -1,10 +1,16 @@ -<!--#set var="revision" value="\$Id: users.html,v 1.17 2003-05-24 20:32:46 link Exp $" ---><!--#set var="date" value="\$Date: 2003-05-24 20:32:46 $" +<!--#set var="revision" value="\$Id: users.html,v 1.18 2004-05-09 15:56:50 link Exp $" +--><!--#set var="date" value="\$Date: 2004-05-09 15:56:50 $" --><!--#set var="title" value="User Documentation for The W3C Markup Validation Service" --><!--#set var="relroot" value="../" --><!--#include virtual="../header.html" --> + +<div class="doc"> + +<h2>User's guide for the W3C Markup Validator</h2> + +<h3 id="TableOfContents">Table of contents</h3> + <div id="toc"> - <h2 id="TableOfContents">Table of contents</h2> <ul> <li><a href="#Quickstart">Quick Start</a></li> <li><a href="#Introduction">Introduction</a></li> @@ -17,7 +23,7 @@ </div> <div id="Quickstart"> - <h2 id="skip">Quick Start</h2> + <h3><a id="skip" name="skip"></a>Quick Start</h3> <p> Just type (or Cut&Paste) the URL for the page you want to validate into the text field on the form and press the "Validate this page" @@ -32,7 +38,7 @@ </div> <div id="Introduction" class="stb"> - <h2>Introduction</h2> + <h3>Introduction</h3> <p> The W3C Markup Validation Service is a web gateway to a well known SGML parser called SP. SP will take your HTML and compare it to a set of @@ -56,7 +62,7 @@ </div> <div id="Options" class="stb"> - <h2>The Options</h2> + <h3>The Options</h3> <p> In addition to the text field where you enter an URL -- or the file selection field if you are uploading files -- there are a few @@ -66,69 +72,75 @@ </p> <dl> - <dt id="option-charset">Encoding</dt> + <dt><a id="option-charset" name="option-charset"></a>Encoding</dt> <dd> - This allows you to <strong>override</strong> the character encoding + <p>This allows you to <strong>override</strong> the character encoding information about your document. You may use this option for test purposes, but you will eventually have to serve your document with the correct character encoding, or the validator will <a href="help#faq-charset">complain</a> - about it and you document will not be valid. + about it and you document will not be valid.</p> </dd> - <dt id="option-fbc">Use Fallback instead of Override (Encoding) (<code>fbc</code>)</dt> + <dt><a id="option-fbc" name="option-fbc"></a>Use Fallback instead of Override (Encoding) (<code>fbc</code>)</dt> <dd> - Uses the <a href="#option-charset">character encoding override</a> mechanism + <p>Uses the <a href="#option-charset">character encoding override</a> mechanism described above, but only does it as a fall back mechanism if the actual document is not served with character encoding information. Think of this as a gentler - override mechanism. + override mechanism.</p> </dd> - <dt id="option-doctype">Type</dt> + <dt><a id="option-doctype" name="option-doctype"></a>Type</dt> <dd> - This allows you to <strong>override</strong> the DOCTYPE declaration for you + <p>This allows you to <strong>override</strong> the DOCTYPE declaration for you document. You may use this option for test purposes, but you will eventually have to serve your document with the correct character encoding, or the validator will <a href="help#faq-doctype">complain</a> - about it and you document will not be valid. + about it and you document will not be valid.</p> </dd> - <dt id="option-fbc">Use Fallback instead of Override (Type) (<code>fbd</code>)</dt> + <dt><a id="option-fbd" name="option-fbd"></a>Use Fallback instead of Override (Type) (<code>fbd</code>)</dt> <dd> - Uses the <a href="#option-doctype">Doctype override</a> mechanism + <p>Uses the <a href="#option-doctype">Doctype override</a> mechanism described above, but only does it as a fall back mechanism if the actual document - does not have a Doctype declaration. Think of this as a gentler override mechanism. + does not have a Doctype declaration. Think of this as a gentler override mechanism.</p> </dd> - <dt id="option-ss">Show source input (<code>ss</code>)</dt> + <dt><a id="option-ss" name="option-ss"></a>Show source input (<code>ss</code>)</dt> <dd> - Displays the HTML source of the document you validated and links + <p>Displays the HTML source of the document you validated and links error messages directly to lines in this output. Makes it easy to - see what's wrong. + see what's wrong.</p> </dd> - <dt id="option-outline">Show an outline of this document (<code>outline</code>)</dt> + <dt><a id="option-outline" name="option-outline"></a>Show an outline of this document (<code>outline</code>)</dt> <dd> - Will generate an outline of your document from the H1 - H6 elements. + <p>Will generate an outline of your document from the H1 - H6 elements. For a properly formed document, this will be a nicely nested tree structure. The visualization of your document's structure makes it - easier to see where you've skipped a heading. + easier to see where you've skipped a heading.</p> </dd> - <dt id="option-sp">Show parse tree (<code>sp</code>)</dt> + <dt><a id="option-sp" name="option-sp"></a>Show parse tree (<code>sp</code>)</dt> <dd> - Shows you exactly how the SGML Parser read your document. Probably + <p>Shows you exactly how the SGML Parser read your document. Probably best used only by advanced users as it deals with low-level SGML - constructs. + constructs.</p> </dd> - <dt id="option-noatt">exclude attributes from the parse tree (<code>noatt</code>)</dt> - <dd>Suppress attributes from the <a href="#option-sp">parse tree</a> to make it - more readable.</dd> - <dt id="option-no200">Validate error pages</dt> - <dd>The Markup Validator will usually tell you if the page you tried to validate - could not be retrieved (for example, if the server gave a "404 not found" message. - In some circumstances you may want to be able to validate the error page sent by - the server. This is the option to use then. + <dt><a id="option-noatt" name="option-noatt"></a>exclude attributes from the parse tree (<code>noatt</code>)</dt> + <dd> + <p>Suppress attributes from the <a href="#option-sp">parse tree</a> to make it + more readable.</p> </dd> - <dt id="option-verbose">Verbose Output</dt> - <dd>This option triggers verbose output. By default the validator will only output - the validity result if the document is valid, but you may want to have the rest of - the information (outline, etc.). This is the option to use then. + <dt><a id="option-no200" name="option-no200"></a>Validate error pages</dt> + <dd> + <p>The Markup Validator will usually tell you if the page you tried to validate + could not be retrieved (for example, if the server gave a "404 not found" message. + In some circumstances you may want to be able to validate the error page sent by + the server. This is the option to use then.</p> + </dd> + <dt><a id="option-verbose" name="option-verbose"></a>Verbose Output</dt> + <dd> + <p>This option triggers verbose output. By default the validator will only output + the validity result if the document is valid, but you may want to have more + information. This is the option to use then. The verbose output also provides helpful + explanations in addition to the error messages, which makes it a generally useful + option. </p> </dd> @@ -136,7 +148,7 @@ </div> <div id="Calling" class="stb"> - <h2>Calling/Linking to the Validator</h2> + <h3>Calling/Linking to the Validator</h3> <p> You can link directly to the Validator home page, or you can call the Validator CGI program. The home page is <<a @@ -148,7 +160,7 @@ <p> If you call the CGI program with extra path info matching "/referer" (i.e. <<a href="http://validator.w3.org/check/referer">http://validator.w3.org/check/referer</a>>) - it will fetch the refering document and validate that. This means that + it will fetch the referring document and validate that. This means that if you embed a link to that URL in your pages, following on that link will send you the validation results for that page. </p> @@ -174,7 +186,7 @@ </div> <div id="Interpret" class="stb"> - <h2>Interpreting the results</h2> + <h3>Interpreting the results</h3> <p> In spite of our efforts, interpreting the Markup Validator's error messages isn't quite what you'd call easy. The error messages are generated in the @@ -197,7 +209,7 @@ we can validate to see for ourselves. </p> <div id="Output" class="stb"> - <h3>Output Options</h3> + <h4>Output Options</h4> <p> In addition to the HTML output intended for human consumption in a browser, the Validator has some experimental features to generate @@ -212,7 +224,7 @@ may well be removed or disabled at any time. They are provided now to garner public feedback to determine how best to support this functionality in the future. One particularly likely option being - considered is removing these features alltogether in favor of a + considered is removing these features altogether in favor of a full-blown SOAP interface. <em>You have been warned!</em> </p> <dl> @@ -268,7 +280,7 @@ elements may appear more then once. </p> <div id="dtd-meta"> - <h4>The <code>meta</code> element</h4> + <h5>The <code>meta</code> element</h5> <p> The <code>meta</code> element contains various metadata about about the Validated document. It contains further elements @@ -295,7 +307,7 @@ </p> </div> <div id="dtd-warnings"> - <h4>The <code>warnings</code> element</h4> + <h5>The <code>warnings</code> element</h5> <p> The <code>warnings</code> element can contain only one sub-element; the <code>warning</code> element. Multiple <code>warning</code> @@ -305,7 +317,7 @@ </p> </div> <div id="dtd-messages"> - <h4>The <code>messages</code> element.</h4> + <h5>The <code>messages</code> element.</h5> <p> The <code>messages</code> element can contain only one sub-element; the <code>msg</code> element. Multiple <code>msg</code> elements @@ -324,7 +336,7 @@ </div> <div id="CommaTools"> - <h2>Comma Tools / Site Tools</h2> + <h3>Comma Tools / Site Tools</h3> <p> This site uses "comma tools", as does <a href="http://www.w3.org/,tools">W3C</a> and other sites. This means you can append a string (starting with a comma, hence @@ -422,17 +434,21 @@ </div> <div id="Installing" class="stb"> - <h2>Installing a local Validator</h2> + <h3>Installing a local Validator</h3> <p> - You can download the Validator to run on your own system, but it's not - recommended for average users as the process is rather complex and - involves obscure incantations on the command line. <tt>:-)</tt> + You can download the Validator to run on your own system. For Web design departments + or agencies it can be a very good idea, saving time and allowing you to not send + documents under work or confidential pages over the wire, but it is a complex operation, + and is not recommended for average users, for which the free online service at W3C + should suffice. </p> <p> - If you feel you're up to the task, you can find the information you need - in our <a href="devel.html">Developer Manual</a>. + We have created a simple <a href="install.html">Installation manual</a>, which, along with + the <a href="devel.html">Developer's information</a>, should help you install a local instance + of the Markup Validator in your own network easily. </p> </div> +</div> <!--#include virtual="../footer.html" --> </body> diff --git a/htdocs/docs/why.html b/htdocs/docs/why.html index e303081..40d4281 100755 --- a/htdocs/docs/why.html +++ b/htdocs/docs/why.html @@ -1,9 +1,9 @@ -<!--#set var="revision" value="\$Id: why.html,v 1.6 2002-12-01 13:40:33 link Exp $" ---><!--#set var="date" value="\$Date: 2002-12-01 13:40:33 $" +<!--#set var="revision" value="\$Id: why.html,v 1.7 2004-05-09 15:56:50 link Exp $" +--><!--#set var="date" value="\$Date: 2004-05-09 15:56:50 $" --><!--#set var="title" value="Why Validate?" --><!--#set var="relroot" value="../" --><!--#include virtual="../header.html" --> - <div id="skip" class="colophon"> + <div id="skip" name="skip" class="colophon"> <h2>Why Validate?</h2> <p> This document attempts to answer the questions many people have diff --git a/htdocs/doctype-select.html b/htdocs/doctype-select.html index b17886c..f7dc7df 100755 --- a/htdocs/doctype-select.html +++ b/htdocs/doctype-select.html @@ -1,8 +1,11 @@ <select id="doctype" name="doctype"> - <option value="Inline">(detect automatically)</option> + <option value="Inline" selected="selected">(detect automatically)</option> + <option>XHTML 1.1</option> + <option>XHTML Basic 1.0</option> <option>XHTML 1.0 Strict</option> <option>XHTML 1.0 Transitional</option> <option>XHTML 1.0 Frameset</option> + <option>ISO/IEC 15445:2000 (ISO-HTML)</option> <option>HTML 4.01 Strict</option> <option>HTML 4.01 Transitional</option> <option>HTML 4.01 Frameset</option> diff --git a/htdocs/favelets.html b/htdocs/favelets.html index a047583..805728f 100755 --- a/htdocs/favelets.html +++ b/htdocs/favelets.html @@ -1,10 +1,10 @@ -<!--#set var="revision" value="\$Id: favelets.html,v 1.5 2003-05-24 20:32:45 link Exp $" ---><!--#set var="date" value="\$Date: 2003-05-24 20:32:45 $" +<!--#set var="revision" value="\$Id: favelets.html,v 1.6 2004-05-09 15:56:49 link Exp $" +--><!--#set var="date" value="\$Date: 2004-05-09 15:56:49 $" --><!--#set var="title" value="Favelets For The W3C Markup Validation Service" --><!--#set var="relroot" value="./" --><!--#include virtual="header.html" --> - <div id="skip"> + <div><a id="skip" name="skip"></a> <h2><a href="http://favelets.com/">Favelets</a> For The Validator</h2> <div class="intro"> @@ -72,8 +72,6 @@ <dt>"<a href="javascript:void(q=prompt('Validate Page:',''));if(q)window.open('http://validator.w3.org/check?uri='+escape(q));void%200" title="Validate Page In New Window...">Validate Page In New Window...</a>"</dt> <dd>Same as above but shows results in a new window.</dd> - <dt>"<a href="javascript:_is=document.createElement('iframe');_is.setAttribute('src','http://validator.w3.org/favelets.html#'+window.location.href);_is.setAttribute('height','0');_is.setAttribute('width','0');_is.setAttribute('style','border:0;');document.body.appendChild(_is);void 0" - title="Is This Page Valid?">Is <em>This</em> Page Valid?</a>"</dt> </dl> </div> </div> diff --git a/htdocs/feedback.html b/htdocs/feedback.html index 3e3bd32..99a4483 100755 --- a/htdocs/feedback.html +++ b/htdocs/feedback.html @@ -1,22 +1,22 @@ -<!--#set var="revision" value="\$Id: feedback.html,v 1.18 2003-05-24 20:32:45 link Exp $" ---><!--#set var="date" value="\$Date: 2003-05-24 20:32:45 $" +<!--#set var="revision" value="\$Id: feedback.html,v 1.19 2004-05-09 15:56:49 link Exp $" +--><!--#set var="date" value="\$Date: 2004-05-09 15:56:49 $" --><!--#set var="title" value="How To Provide Feedback for The W3C Markup Validation Service" --><!--#set var="relroot" value="./" --><!--#include virtual="header.html" --> - -<h2 id="skip">How to Provide Feedback</h2> +<div class="doc"><a id="skip" name="skip"></a> +<h2>How to Provide Feedback<br /> +For the W3C Markup Validator</h2> <dl> <dt>If your page doesn't validate, and you don't know why, or you have a question about <acronym title="HyperText Markup Language">HTML</acronym> - or validation</dt> + or validation:</dt> <dd> <p> - First, check the <strong><a href="http://www.htmlhelp.com/faq/">Web - authoring frequently asked questions - (<acronym title="Frequently Asked Questions">FAQ</acronym>)</a></strong> - to see if your question has been answered there. + <strong>First, check our <a href="docs/help.html">Help and <acronym title="Frequently Asked Questions">FAQ</acronym> document</a>, as well as the + <a href="http://www.htmlhelp.com/faq/">Web authoring <acronym title="Frequently Asked Questions">FAQ</acronym></a> + to see if your question has been answered there.</strong> </p> <p> The two most common problems are: @@ -51,15 +51,15 @@ <p> Each of these forums have plenty of experienced <acronym title="HyperText Markup Language">HTML</acronym> - authors who are willing to share their expertise. (If you are + authors who are willing to share their expertise. If you are commenting on a specific page, be sure to provide a <acronym title="Universal Resource Locator">URL</acronym> - when you ask your question!) + when you ask your question! </p> </dd> <dt>If you are interested in helping to improve this - service, by writing code or just providing ideas,</dt> + service, by writing code or just providing ideas:</dt> <dd> <p> @@ -73,7 +73,7 @@ href="mailto:www-validator@w3.org">send it directly to the list</a>. </p> </dd> - <dt>If you want to report a bug or log a feature request.</dt> + <dt>If you want to report a bug or log a feature request:</dt> <dd> <p> The W3C Maintains a public bug tracking database known as <a @@ -86,7 +86,7 @@ </p> </dd> </dl> - +</div> <!--#include virtual="footer.html" --> </body> </html> diff --git a/htdocs/file-upload.html b/htdocs/file-upload.html index 155863b..4a0216a 100755 --- a/htdocs/file-upload.html +++ b/htdocs/file-upload.html @@ -1,16 +1,17 @@ -<!--#set var="revision" value="\$Id: file-upload.html,v 1.17 2003-05-24 20:32:45 link Exp $" ---><!--#set var="date" value="\$Date: 2003-05-24 20:32:45 $" +<!--#set var="revision" value="\$Id: file-upload.html,v 1.18 2004-05-09 15:56:49 link Exp $" +--><!--#set var="date" value="\$Date: 2004-05-09 15:56:49 $" --><!--#set var="title" value="W3C Markup Validation Service: Upload Files" --><!--#set var="relroot" value="./" --><!--#include virtual="header.html" --> - <p id="skip"> + <p><a id="skip" name="skip"></a> This form allows you to upload files from your computer and have them validated. </p> <div> <h2>Validate Uploaded File</h2> + <fieldset><legend>Validate by File Upload</legend> <form method="post" enctype="multipart/form-data" action="check"> <table> <tr><th><label for="uploaded_file">File:</label></th><td colspan="2"><input type="file" id="uploaded_file" name="uploaded_file" size="50" /></td></tr> @@ -21,6 +22,7 @@ </tr> </table> </form> + </fieldset> </div> <p> diff --git a/htdocs/footer.html b/htdocs/footer.html index 6876bb3..5a6b4cb 100755 --- a/htdocs/footer.html +++ b/htdocs/footer.html @@ -1,14 +1,17 @@ - <address> - <a href="<!--#echo var="relroot" -->check/referer"><img + </div><!-- End of "main" DIV. --> + +<address> + <a href="<!--#echo var="relroot" -->check?uri=referer"><img src="http://www.w3.org/Icons/valid-xhtml10" height="31" width="88" alt="Valid XHTML 1.0!" /></a> - <a title="Send Feedback for the W3C Markup Validation Service" + Feedback: + <a title="Send Feedback for the W3C Markup Validation Service" href="<!--#echo var="relroot" -->feedback.html">The W3C Validator Team</a><br /> <!--#echo var="date" --> - <!-- SSI Template Version: $Id: footer.html,v 1.8 2003-05-24 20:32:45 link Exp $ --> + <!-- SSI Template Version: $Id: footer.html,v 1.9 2004-05-09 15:56:49 link Exp $ --> </address> <p class="copyright"> - <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 1994-2003 + <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 1994-2004 <a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a>® (<a href="http://www.lcs.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>, <a href="http://www.ercim.org/"><acronym title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>, diff --git a/htdocs/header.html b/htdocs/header.html index 6b70286..46d3b1a 100755 --- a/htdocs/header.html +++ b/htdocs/header.html @@ -12,65 +12,26 @@ <meta name="description" content="W3C's easy-to-use HTML validation service, based on an SGML parser." /> <meta name="revision" content="<!--#echo var="revision" -->" /> - <!-- SSI Template Version: $Id: header.html,v 1.24 2004-04-05 20:33:06 ville Exp $ --> + <!-- SSI Template Version: $Id: header.html,v 1.25 2004-05-09 15:56:49 link Exp $ --> </head> <body> - <h1 id="title"><a href="http://www.w3.org/"><img height="48" alt="W3C" - id="logo" src="http://www.w3.org/Icons/WWW/w3c_home" /></a> - Markup Validation Service</h1> - <dl class="navbar"> - <dt>Site Navigation</dt> - <dd class="main"> - <ul> - <li class="hideme"><a href="#skip" accesskey="s" title="Skip past navigation to main part of page">Skip Navigation</a></li> - <li><a href="<!--#echo var="relroot" -->" accesskey="h" title="Go to the Home Page for The W3C Markup Validation Service">Home Page</a></li> - <li><a href="<!--#echo var="relroot" -->docs/" title="Documentation for this Service">Documentation</a></li> - <li><a href="<!--#echo var="relroot" -->source/" title="Information on Source Availability">Source Code</a></li> - <li><a href="<!--#echo var="relroot" -->whatsnew.html" title="The changes made to this service recently">What's New</a></li> - <li><a href="<!--#echo var="relroot" -->accesskeys.html" accesskey="k" title="Accesskey Legend for the Validator Service">Accesskeys</a></li> - <li><a href="<!--#echo var="relroot" -->feedback.html" title="How to provide feedback on this service">Feedback</a></li> - <li><a href="<!--#echo var="relroot" -->about.html" title="Information About this Service">About...</a></li> - <li><a href="<!--#echo var="relroot" -->favlets.html" title="Favlets for the Validator">Favlets</a></li> - </ul> - </dd> - <dt>Other Tools</dt> - <dd> - <ul> - <li><a href="http://valet.webthing.com/" class="offsite" title="The Site Valet QA Tools">Site Valet</a></li> - <li><a href="http://www.htmlhelp.com/tools/validator/" class="offsite" title="The WDG HTML Validator"><acronym title="Web Design Group">WDG</acronym> Validator</a></li> - <li><a href="http://jigsaw.w3.org/css-validator/" class="offsite" title="The W3C CSS Validator"><acronym title="Cascading Style Sheets">CSS</acronym> Validator</a></li> - <li><a href="http://validator.w3.org/checklink" class="offsite" title="The W3C Link Checker">Link Checker</a></li> - <li><a href="http://www.w3.org/People/Raggett/tidy/" class="offsite" title="The HTML Tidy Home Page"><acronym title="HyperText Markup Language">HTML</acronym> Tidy</a></li> - <li><a href="http://cgi.w3.org/cgi-bin/tidy" class="offsite" title="The HTML Tidy Tool Online">Tidy Online</a></li> - </ul> - </dd> - <dt>Markup Standards</dt> - <dd> - <ul> - <li><a href="http://www.w3.org/TR/xhtml11/" class="offsite" title="The XHTML 1.1 Recommendation"><acronym title="eXtensible HyperText Markup Language">XHTML</acronym> 1.1</a></li> - <li><a href="http://www.w3.org/TR/xhtml1/" class="offsite" title="The XHTML 1.0 Recommendation"><acronym title="eXtensible HyperText Markup Language">XHTML</acronym> 1.0</a></li> - <li><a href="http://www.w3.org/TR/html401/" class="offsite" title="The HTML 4.01 Recommendation"><acronym title="HyperText Markup Language">HTML</acronym> 4.01</a></li> - </ul> - </dd> - <dt>Style Standards</dt> - <dd> - <ul class="none"> - <li><a href="http://www.w3.org/TR/xsl/" class="offsite" title="The XSL 1.0 Proposed Recommendation"><acronym title="eXtensible Style Language">XSL</acronym> 1.0</a></li> - <li><a href="http://www.w3.org/TR/REC-CSS2" class="offsite" title="The CSS Level 2 Recommendation"><acronym title="Cascading Style Sheets">CSS</acronym> Level 2</a></li> - <li><a href="http://www.w3.org/TR/REC-CSS1" class="offsite" title="The CSS Level 1 Recommendation"><acronym title="Cascading Style Sheets">CSS</acronym> Level 1</a></li> - </ul> - </dd> - <dt>Accessibility</dt> - <dd> - <ul> - <li><a href="http://www.w3.org/WAI/" class="offsite" title="The Web Accessibility Initiative Home Page"><acronym title="Web Accessibility Initiative">WAI</acronym> Home</a></li> - <li><a href="http://www.w3.org/Talks/WAI-Intro/slide1-0.html" class="offsite" title="Overview of the Web Accessibility Initiative"><acronym title="Web Accessibility Initiative">WAI</acronym> Overview</a></li> - <li><a href="http://www.w3.org/WAI/bcase/benefits.html" class="offsite" title="Benefits of Accessible Web Design"><acronym title="Web Accessibility Initiative">WAI</acronym> Benefits</a></li> - <li><a href="http://www.w3.org/1999/05/WCAG-REC-fact" class="offsite" title="Frequently Asked Questions About The Web Content Accessibility Guidelines"><acronym title="Web Content Accessibility Guidelines">WCAG</acronym> <acronym title="Frequently Asked Questions">FAQ</acronym></a></li> - <li><a href="http://www.w3.org/TR/WCAG10/" class="offsite" title="Web Content Accessibility Guidelines 1.0"><acronym title="Web Content Accessibility Guidelines">WCAG</acronym> 1.0</a></li> - <li><a href="http://www.w3.org/WAI/gettingstarted/" class="offsite" title="WAI Getting Started Guide"><acronym title="Web Accessibility Initiative">WAI</acronym> Intro</a></li> - <li><a href="http://www.w3.org/WAI/References/QuickTips/" class="offsite" title="WAI Quick Tips"><acronym title="Web Accessibility Initiative">WAI</acronym> Tips</a></li> - </ul> - </dd> - </dl> + <div id="banner"> + <h1 id="title"> + <a href="http://www.w3.org/"><img height="48" alt="W3C" id="logo" src="http://www.w3.org/Icons/WWW/w3c_home" /></a> + <a href="http://www.w3.org/QA/"><img src="http://www.w3.org/QA/2002/12/qa-small.png" alt="QA" /></a> + Markup Validation Service</h1> + <span id="versioninfo"><abbr title="version">v</abbr>0.6.5</span> + </div> + <ul class="navbar" id="menu"> + <li><span class="hideme"><a href="#skip" accesskey="s" title="Skip past navigation to main part of page">Skip Navigation</a> |</span> + <a href="<!--#echo var="relroot" -->" accesskey="h" title="Go to the Home Page for The W3C Markup Validation Service"><strong>Home</strong></a></li> + <li><a href="<!--#echo var="relroot" -->about.html" title="Information About this Service">About...</a></li> + <li><a href="<!--#echo var="relroot" -->whatsnew.html" title="The changes made to this service recently">News</a></li> + <li><a href="<!--#echo var="relroot" -->docs/" title="Documentation for this Service">Docs</a></li> + <li><a href="<!--#echo var="relroot" -->docs/help.html" title="Help and answers to frequently asked questions">Help & <acronym title="Frequently Asked Questions">FAQ</acronym></a></li> + <li><a href="<!--#echo var="relroot" -->feedback.html" title="How to provide feedback on this service">Feedback</a></li> + <li><a href="http://validator.w3.org/checklink" title="In addition to fixing your markup, fix your links with the W3C Link Checker">Link Checker</a></li> + </ul> + + <div id="main"><!-- This DIV encapsulates everything in this page - necessary for the positioning --> diff --git a/htdocs/images/footer.png b/htdocs/images/footer.png Binary files differnew file mode 100644 index 0000000..ba03cb4 --- /dev/null +++ b/htdocs/images/footer.png diff --git a/htdocs/images/header.jpg b/htdocs/images/header.jpg Binary files differnew file mode 100644 index 0000000..f8ab513 --- /dev/null +++ b/htdocs/images/header.jpg diff --git a/htdocs/images/header.png b/htdocs/images/header.png Binary files differnew file mode 100644 index 0000000..6abc8d2 --- /dev/null +++ b/htdocs/images/header.png diff --git a/htdocs/index.html b/htdocs/index.html index 8d3c263..b9fda2f 100755 --- a/htdocs/index.html +++ b/htdocs/index.html @@ -1,11 +1,12 @@ -<!--#set var="revision" value="\$Id: index.html,v 1.58 2003-05-24 20:32:45 link Exp $" ---><!--#set var="date" value="\$Date: 2003-05-24 20:32:45 $" +<!--#set var="revision" value="\$Id: index.html,v 1.59 2004-05-09 15:56:49 link Exp $" +--><!--#set var="date" value="\$Date: 2004-05-09 15:56:49 $" --><!--#set var="title" value="The W3C Markup Validation Service" --><!--#set var="relroot" value="./" --><!--#include virtual="header.html" --> - <div id="skip" class="intro"> - <p> + + <div class="intro"> + <p><a name="skip" id="skip"></a> Welcome to the W3C Markup Validation Service; a free service that checks documents like HTML and XHTML for conformance to W3C Recommendations and other standards. @@ -13,59 +14,61 @@ </div> <div> - <h2>Validate Files</h2> - <p> - You can enter a URI in the <code>Address</code> field below, - and have the page validated: - </p> + <h2>Validate Your Markup</h2> + <fieldset class="front"><legend>Validate by URI</legend> <form method="get" action="check"> <p> <label title="Address of page to Validate" for="uri">Address: <input id="uri" name="uri" size="40" /></label> - <label title="Submit URI for validation"> - <input type="submit" value="Validate URI..." /></label> + <label title="Submit URI for validation"><input type="submit" value="Check" /></label> + <input type="hidden" name="verbose" value="0" /> + <!-- <input type="hidden" name="fussy" value="0" /> --> </p> </form> <p> - If you want to upload a file from your computer and have it validated, - you can use this form: + Enter the <abbr title="Uniform Resource Identifier">URI</abbr> of the page + you want to check. Advanced options are available from the <a + title="Extended Interface to the W3C Markup Validation Service" + href="detailed.html">Extended Interface</a>. </p> + </fieldset> + <br /> + <fieldset class="front"><legend>Validate by File Upload</legend> <form method="post" enctype="multipart/form-data" action="check"> - <p> - <label title="Choose a Local File to Upload and Validate" for="uploaded_file">Local File: <input type="file" id="uploaded_file" name="uploaded_file" size="30" /></label> - <label title="Submit file for validation"><input type="submit" value="Validate File" /></label> + <p> + <label title="Choose a Local File to Upload and Validate" for="uploaded_file">Local File: + <input type="file" id="uploaded_file" name="uploaded_file" size="30" /></label> + <label title="Submit file for validation"><input type="submit" value="Check" /></label> + <input type="hidden" name="verbose" value="0" /> + <!-- <input type="hidden" name="fussy" value="0" /> --> </p> </form> <p> - There is also an <a - title="Extended Interface to the W3C Markup Validation Service" - href="detailed.html">Extended Interface</a> available if you want - to set any advanced options, and a <a + Select the file you want to upload and check. Advanced options are + available from the <a title="File Upload Interface to the W3C Markup Validation Service" - href="file-upload.html">Extended File Upload Interface</a> if you - want to validate uploaded files with advanced options. + href="file-upload.html">Extended File Upload Interface</a>. </p> + </fieldset> </div> <div id="recent"> <h2>Recent Updates</h2> + <dl> + <dt><a href="whatsnew.html#t2004-05-07">2004-05-07</a></dt> + <dd>Released version 0.6.5, a maintenance release easier to use and install, + featuring new documentation, simpler navigation, new recovery mechanisms instead of fatal errors, + and offering explanations in addition to error messages.</dd> + <dt><a href="whatsnew.html#t2002-12-01">2002-12-01</a></dt> + <dd>Released version 0.6.1, a maintenance release to fix minor bugs.</dd> + </dl> <p class="intro"> These are the most recent major changes to this service. See "<a href="whatsnew.html">What's New</a>" for more details. - </p> - <dl> - <dt><a href="whatsnew.html#2003-05-01">May 01, 2003 (TBC)</a></dt> - <dd> - Released version 0.6.2 of the Markup Validator; a maintenance - release to address various minor issues. - </dd> - <dt><a href="whatsnew.html#2002-12-01">December 01, 2002</a></dt> - <dd>Maintenance release to fix minor bugs.</dd> - <dt><a href="whatsnew.html#2002-11-26">November 26, 2002</a></dt> - <dd>Internal restructuring and new DTDs added. Bug fixes.</dd> - </dl> + </p> </div> + <!--#include virtual="footer.html" --> </body> diff --git a/htdocs/loadexplanation.js b/htdocs/loadexplanation.js new file mode 100644 index 0000000..c5a8010 --- /dev/null +++ b/htdocs/loadexplanation.js @@ -0,0 +1,27 @@ +d=document +w=window +msgs=new Array() +if (w && d && d.getElementsByTagName){ + w.onload=doubleUp +} +function doubleUp() { + glist=d.getElementsByTagName("DIV") + upto(10) +} +function upto(n) { + if (n<glist.length) { + for (i=n;i<glist.length && i<n+10;i++) { + j=glist[i] + cls=j.className + if (cls) cls=cls.split(' ') + if (cls.length>1) { + if (cls[0]=='ve') msgs[cls[1]]=j.innerHTML + if (cls[0]=='hidden' && msgs[cls[1]]) { + j.className="ve "+cls[1] + j.innerHTML=msgs[cls[1]] + } + } + } + if (w && w.setTimeout) setTimeout('upto('+i+')',500) + } +} diff --git a/htdocs/navbar.css b/htdocs/navbar.css index 17cdd7b..2ad35dc 100644 --- a/htdocs/navbar.css +++ b/htdocs/navbar.css @@ -1,89 +1,170 @@ /* Navigation Style Sheet for the W3C Markup Validation Service. - Copyright 2000 W3C (MIT, INRIA, Keio). All Rights Reserved. + Copyright 2000-2004 W3C (MIT, INRIA, Keio). All Rights Reserved. See http://www.w3.org/Consortium/Legal/ipr-notice.html#Copyright - $Id: navbar.css,v 1.6 2003-02-24 23:33:18 ville Exp $ + $Id: navbar.css,v 1.7 2004-05-09 15:56:49 link Exp $ */ -dl.navbar { - float: right; - text-decoration: none; - text-align: left; - background-color: #eee; - border-left: 1px solid black; - margin-left: 1em; - padding-left: 1em; +html { +/* min-width: 55em; */ } -dl.navbar dt { - text-align: left; - margin-left: 0px; +#menu { +/* min-width: 63em; */ + list-style-type: none; + padding: 0; + margin: 0; + height: 1.5em; + background-color: #eee; + border-bottom: solid 1px black; } -dl.navbar dd { - margin: 0px; +#menu li { + display: inline; + padding: 0; + margin: 0; } -dl.navbar ul { - padding: 0px; +#menu li a:link, #menu li a:visited { + text-decoration: none; + text-align: center; + float: left; + display: block; + width: 8em; + padding: 2px 0px; + margin: 0; + background-color: #eee; + color: #053188; + font-size: smaller; + font-variant: small-caps; + border-right: solid 1px #bbb; + border-bottom: solid 1px #ddd; } -dl.navbar ul li { - list-style-type: none; - margin-top: 1px; +#menu li a#selected:link, #menu li a#selected:visited { + text-decoration: underline; + background-color: #fff; + color: #053188; } -dl.navbar ul li a { - display: block; - text-decoration: none; - font-family: sans-serif; +#menu li a:hover { + text-decoration: underline; + background-color: #fff; + color: #053188; } -dl.navbar ul li a:hover { - background: #ccc; +#menu li a:active { + background-color: #fff; + color: #053188; + border-right: solid 1px #ddd; } +/* link bar - all pages*/ + +#misclinks { + float: right; + width: 8em; + text-decoration: none; + padding: 1ex; + background-color: #eee; + border-left: 1px solid black; + border-bottom: 1px solid black; + margin-top: -1px; + font-size: smaller; +} +#misclinks dt { + text-align: center; + background: #ddd; + color: #053188; + font-variant: small-caps; +} +#misclinks dd { + text-align: right; + margin: 0; + padding-bottom: 2ex; +} +#misclinks ul {margin: 0; padding: 0;} +#misclinks li { + list-style-type: none; + text-align: right; +} +#misclinks ul li a { + display: block; +} +#misclinks li a:link, #misclinks li a:visited, div.jumpbar li a:link, div.jumpbar li a:visited { + text-decoration: none; + display: block; + padding: 1px 0px; + margin: 0; + background-color: #eee; + color: #053188; + font-size: smaller; +} +#misclinks li a:hover { + text-decoration: underline; + background-color: #fff; + color: #053188; +} +#misclinks li a#selected:link, div.jumpbar li a#selected:visited { + text-decoration: underline; +} +/* Jump Bar - results page*/ +.jumpbar { + float: right; + width: 8em; + margin-right: -.4em; /* FIXME - find the exact value - */ + text-align: left; + text-decoration: none; + padding: 1ex; + background-color: #eee; + border-left: 1px solid black; + border-bottom: 1px solid black; + margin-top: -1.3em; + font-size: smaller; +} -/* -div.navbar p a { - display: block; - text-decoration: none; +div.jumpbar ul { + padding: 0; + margin: 0; } -div.navbar p a:hover { - background: #ccc; +div.jumpbar li { + list-style-type: none; } -div.navbar { - float: right; - text-align: right; - text-decoration: none; - margin: .1ex .1ex 2.5ex 1ex; - padding: 1ex; +div.jumpbar li a:link, div.jumpbar li a:visited { + text-decoration: none; + text-align: center; + display: block; + width: 8em; + padding: 2px 0px; + margin: 0; background-color: #eee; - border-left: 1px solid black; - clear: both; - width: 8em; + color: #053188; + font-size: smaller; + border-top: dotted 1px black; } -div.navbar p { - border-top: 1px solid black; - margin: .1ex; - padding: .1ex .1em 1.5ex .1em; +div.jumpbar li a:hover { + text-decoration: underline; } -div.navbar p.main { - border-top-style: none; +div.jumpbar li a#selected:link, div.jumpbar li a#selected:visited { + text-decoration: underline; + background-color: #fff; + color: #053188; + border-right: solid 1px #ddd; + border-bottom: solid 1px #fff; } -*/ + diff --git a/htdocs/results.css b/htdocs/results.css index 791ef2d..a03d334 100644 --- a/htdocs/results.css +++ b/htdocs/results.css @@ -1,34 +1,207 @@ /* style sheet for the validator's results page */ -/* $Id: results.css,v 1.17 2003-05-24 20:32:45 link Exp $ */ +/* $Id: results.css,v 1.18 2004-05-09 15:56:49 link Exp $ */ -.markup { +.input { + color: black; + background-color: #eee; + font-family: "Bitstream Vera Mono", monospace; + font-size: small; +} + +/* The "Jump To" links in result pages. */ +.jumpbar { + float: left; + width: 12ex; + text-align: left; + text-decoration: none; + padding: 1ex; + background-color: #eee; + border-top: 1px solid #eee; + border-right: 1px solid black; + border-bottom: 1px solid black; + margin-top: -1.3em; + font-weight: bolder; + font-size: smaller; +} + +div.jumpbar ul { + padding: 0; + margin: 0; +} + +div.jumpbar li { + list-style-type: none; +} + +p.jumpbar a:hover { + background: #ccc; +} + +/* Error Messages Display */ +/* +*/ +.msg { + font-weight: bold; +} + +.ve { + font-size: smaller; + clear: left; + padding: 0; + width: 100%; +} + +.ve p { + line-height: 100%; + font-style: italic; + font-size: small; + margin: 0; +} + +.ve p.helpwanted { + float: right; + width: 30ex; + border: 1px solid black; + background: #eee; + font-size: smaller; + line-height: 120%; + padding: 1ex; + text-align: justify; + margin: 0; +} + +.helpwanted em { + font-weight: bolder; +} + +ol#errors code { + margin-bottom: 2ex; +} + +ol#errors li p code strong { color: red; - background: white; + padding-left: .5ex; + padding-right: .5ex; font-weight: bolder; } -.input { - color: black; - background-color: #eeeeee; /* light grey */ +ol#errors li { + clear: both; +} + +/* Source Code Display */ +/* +*/ +#source div { +/* where the source is actually displayed */ + background: #eee; + border: 1px solid black; + margin-right: 1em; + margin-left: 1em; + padding-left: 1em; + padding-right: 1em; +} + +#source code { + white-space: normal; + font-family: "Bitstream Vera Mono", monospace; + font-size: smaller; } + fieldset { color: black; + clear: left; + margin-left: auto; + margin-right: auto; background-color: #eeeeee; } fieldset legend { background-color: #eee; - border-right: 1px solid grey; - border-bottom: 1px solid grey; + border-right: 1px solid gray; + border-bottom: 1px solid gray; + font-weight: bold; +} + + +/* Style for non-parser warnings. */ +/* +*/ + +div.Warnings { + clear: left; + padding: 0; + margin-right: 1em; +} + +/* "Fatal" warnings... */ +div.Warnings div.fatal h3 { + background: #FCC; + border-top: 1px solid black; + border-right: 1px solid black; + border-bottom: 1px solid black; + padding: .5ex; + margin: 0; + margin-bottom: 1em; + float: left; + font-size: small; + font-weight: bolder; +} + +div.Warnings div.fatal { + margin: 0 0 1ex 0; + padding: 0; + clear: left; +} + +div.Warnings div.fatal div { + border: 5px solid #FCC; + margin: 0 0 0 1em; + padding: .5em 1em; +} + +div.Warnings div.fatal p:first-child { font-weight: bold; +/* font-size: normal; */ + clear: left; +} + +/* "note" warnings... */ +div.Warnings div.note h3 { + background: #053188; + color: white; + border-top: 1px solid black; + border-right: 1px solid black; + border-bottom: 1px solid black; + padding: .5ex; + margin: 0; + margin-bottom: 1em; + margin-right: 1em; + float: left; + font-size: small; + font-weight: bolder; } -ul#Warnings { +div.Warnings div.note { + margin: 0 0 1ex 0; + padding: 0; clear: left; - padding-top: 1ex; } +div.Warnings div.note div { + margin: 0 0 0 1em; + padding: .5em 1em; +} +/* Not all warnings have a "p", but if they + do, the first one should be emphasized. */ +div.Warnings div.note p:first-child { + font-weight: bold; +/* font-size: normal; */ + clear: left; +} + + th { padding-right: .5em; text-align: right; @@ -86,7 +259,7 @@ h2.valid { padding-bottom: .5em; } -.valid a { +.valid a:link { color: yellow; background: #053188; } @@ -106,8 +279,19 @@ h2.valid { background: yellow; } +div#result { + clear: left; + padding-top: 1em; +} + +h2.valid { +margin-top: 0; +margin-bottom: 0; +} h2.invalid { text-align: center; + margin-top: 0; + margin-bottom: 0; } .invalid { diff --git a/htdocs/sgml-lib/xml.soc b/htdocs/sgml-lib/xml.soc index e548491..1b1e1f1 100644 --- a/htdocs/sgml-lib/xml.soc +++ b/htdocs/sgml-lib/xml.soc @@ -8,14 +8,14 @@ SYSTEM "spec.dtd" "http://www.w3.org/XML/1998/06/xmlspec-v20.dtd" -- MathML 2.0 DTD driver -- PUBLIC "-//W3C//DTD XHTML 1.1 plus MathML 2.0//EN" - "UPD-MathML2-20021015/xhtml-math11-f.dtd" + "UPD-MathML2-20030620/xhtml-math11-f.dtd" PUBLIC "-//W3C//DTD MathML 2.0//EN" - "UPD-MathML2-20021015/mathml2.dtd" + "UPD-MathML2-20030620/mathml2.dtd" SYSTEM "http://www.w3.org/TR/MathML2/dtd/xhtml-math11-f.dtd" - "UPD-MathML2-20021015/xhtml-math11-f.dtd" + "UPD-MathML2-20030620/xhtml-math11-f.dtd" SYSTEM "http://www.w3.org/TR/MathML2/dtd/mathml2.dtd" - "UPD-MathML2-20021015/mathml2.dtd" + "UPD-MathML2-20030620/mathml2.dtd" -- XHTML + MathML + SVG -- PUBLIC "-//W3C//DTD XHTML 1.1 plus MathML 2.0 plus SVG 1.1//EN" diff --git a/htdocs/source/index.html b/htdocs/source/index.html index 12cbacb..2f2e2ec 100755 --- a/htdocs/source/index.html +++ b/htdocs/source/index.html @@ -1,34 +1,45 @@ -<!--#set var="revision" value="\$Id: index.html,v 1.29 2003-05-24 20:32:46 link Exp $" ---><!--#set var="date" value="\$Date: 2003-05-24 20:32:46 $" +<!--#set var="revision" value="\$Id: index.html,v 1.30 2004-05-09 15:56:52 link Exp $" +--><!--#set var="date" value="\$Date: 2004-05-09 15:56:52 $" --><!--#set var="title" value="Source Code Availability for The W3C Markup Validation Service" --><!--#set var="relroot" value="../" --><!--#include virtual="../header.html" --> +<div class="doc"> +<h2>Source code availability<br />for the W3C Markup Validator</h2> +<h3 id="TableOfContents">Table of Contents</h3> - <p id="skip"> + <div id="toc"> + <ul> + <li><a href="#getting">Retrieving and browsing the Code</a> + <ul> + <li><a href="#browse">Browsing the code</a></li> + <li><a href="#tarball">Download tarballs</a></li> + <li><a href="#rpm">RPM package</a></li> + <li><a href="#deb">Debian package</a></li> + <li><a href="#CVS">CVS repository</a></li> + </ul> + </li> + <li><a href="#using">Using the code</a></li> + </ul> + </div> + + + <h3><a name="getting" id="getting"></a>Retrieving and browsing the Code</h3> + + <p><a id="skip" name="skip"></a> The source code for the <a href="../"><acronym title="World Wide Web Consortium">W3C</acronym> Markup Validation Service</a> is available under the terms of the <a href="http://www.w3.org/Consortium/Legal/copyright-software"><acronym title="World Wide Web Consortium">W3C</acronym> - Software Copyright</a>. Tarballs of the source, and available binary + Software License</a>. Tarballs of the source, and available binary distributions, of the latest production version is always available at - <<a href="http://validator.w3.org/dist/">http://validator.w3.org/dist/</a>>. + <<a href="http://validator.w3.org/validator.tar.gz">http://validator.w3.org/validator.tar.gz</a>>. Development code is only available from CVS. </p> - <p> - The purpose of making the source code available is partly to allow - others to set up mirrors of the service (either publicly or within - an intranet behind a firewall), but also to allow us to collaborate - on making the service better! - </p> - <div id="getting"> - <h2>Retrieving the Code</h2> - <p>You can retrieve the code a number of ways:</p> - <ul> - <li> - <p> + <h4><a id="browse" name="browse"></a>Browsing the code</h4> + <p> If you just want to glance at the code, or see its revision history, you can <a href="http://dev.w3.org/cvsweb/validator/">browse it on @@ -36,50 +47,77 @@ </p> <p> The most interesting files are currently - <a href="http://dev.w3.org/cvsweb/validator/httpd/cgi-bin/check">a + <a href="http://dev.w3.org/cvsweb/validator/httpd/cgi-bin/check?only_with_tag=validator-0_6_0-branch">a CGI script called "check"</a> that does pretty much everything, and possibly also <a - href="http://dev.w3.org/cvsweb/validator/httpd/conf/httpd.conf">the - httpd.conf</a>. (Select the topmost revision numbers on these - pages to see the most recent revision of each file.) + href="http://dev.w3.org/cvsweb/validator/httpd/conf/httpd.conf?only_with_tag=validator-0_6_0-branch">the + httpd.conf configuration file snippet for Apache</a>. + Select the topmost revision numbers on these + pages to see the most recent revision of each file. </p> - </li> - <li> - <p> + <h4><a id="tarball" name="tarball"></a>Download the code in tarballs</h4> + <p> If you want a copy of all the files that make up the service, you - can download a tarball of <a href="../validator.tar.gz">the code</a> - (~161kB) and the <a href="../sgml-lib.tar.gz">the <acronym + can download a tarball of <a href="http://validator.w3.org/validator.tar.gz">the code</a> + (~161kB) and <a href="http://validator.w3.org/sgml-lib.tar.gz">the <acronym title="Document Type Definitions">DTDs</acronym></a> (~2.6MB). </p> - </li> - <li id="rpm"> + <h4><a id="rpm" name="rpm"></a>RPM package</h4> <p> - Experimental RPMs are available, courtesy of Ville Skyttä, at - <<a href="http://cachalot.ods.org/">http://cachalot.ods.org/</a>>. + RPM packages are available, courtesy of Ville Skyttä, at + <<a href="http://cachalot.mine.nu/1/">http://cachalot.mine.nu/1/</a>>. </p> <p> - The RPMs have only been tested on <a href="http://www.redhat.com/">Red - Hat</a> 8.0, but should be adaptable to other RPM based systems. + The RPMs have only been tested on + <a href="http://fedora.redhat.com/">Fedora</a> Core 1, + but should be adaptable to other RPM based systems. </p> <p> - Note that the Validator RPMs have several dependencies so you will - have to get at least the following RPMs: + Note that the Validator RPMs have several dependencies, you'll + have to get at least the following RPMs (other dependencies are + included in the Fedora Core distribution): </p> <ul> - <li>w3c-validator</li> - <li>w3c-validator-libs</li> + <li>w3c-markup-validator</li> + <li>w3c-markup-validator-libs</li> + <li>perl-Config-General</li> + <li>perl-Net-IP</li> <li>perl-Set-IntSpan</li> <li>perl-Text-Iconv</li> - <li>opensp</li> </ul> <p> In addition, each of these may have further dependencies that must - be satisfied. All the necessary RPMs should be either in Red Hat 8.0 - or available from - <<a href="http://cachalot.ods.org/">http://cachalot.ods.org/</a>>. + be satisfied. All the necessary RPMs are either included in + the Fedora Core distribution or are available from + <<a href="http://cachalot.mine.nu/1/">http://cachalot.mine.nu/1/</a>> or + <<a href="http://www.fedora.us/">http://www.fedora.us/</a>>. + Use of an automated package management tool, such as apt, up2date + or yum is strongly recommended. See the links above for more + information about getting and configuring these tools. </p> - </li> - <li id="CVS"> + <h4><a name="deb" id="deb"></a>Debian package</h4> + <p> + A Debian package is available, courtesy of Frédéric + Schütz. The latest version is available for the Debian Woody + (current stable), Sarge (current testing) or Sid (unstable) + distributions at + <<a href="http://www.mathgen.ch/debian/">http://www.mathgen.ch/debian/</a>>. + If you want to use the <kbd>apt-get</kbd> command, add the line + <kbd>deb http://www.mathgen.ch/debian/woody ./</kbd> + in the /etc/apt/sources.list file (replace woody by testing or sid + if you use another distribution). All dependencies that are not + part of the standard Debian archive are provided at the same + address, and running the command <kbd>apt-get install + w3c-markup-validator</kbd> as root will install all the packages + needed. + </p> + <p> + If you are using the Debian Testing or Unstable distribution, the + package is already included in the offical archive and you can + directly use the <kbd>apt-get</kbd> command if your + /etc/apt/sources.list file is correctly configured. + </p> + <h4><a id="CVS" name="CVS"></a>CVS repository</h4> <p> If you intend to actively mirror the code and/or contribute patches to the code, you should install and become familiar @@ -99,7 +137,7 @@ bash$ <kbd>cvs login</kbd> (Logging in to anonymous@dev.w3.org) CVS password: <kbd>anonymous</kbd> - bash$ <kbd>cvs get -r validator-0_6_2-release validator</kbd> + bash$ <kbd>cvs get -r validator-0_6_5 validator</kbd> cvs server: Updating validator cvs server: Updating validator/htdocs U validator/htdocs/about.html @@ -113,106 +151,20 @@ or lesser breakage at any given point in time. <em>Approach with caution!</em> </p> - </li> - </ul> - </div> - <div> - <h2>Prerequisites</h2> - <p> - Before you will be able to get the code to run, you will need a few - things already installed on your system: - </p> - <ul> - <li> - A Unix-like operating system. It may also work with Windows - NT, Mac OS X or other systems. It has worked on Linux, - Solaris, FreeBSD, HP-UX, and Digital UNIX. If you try it on other - systems and get it to work, please <a href="../feedback.html">let - us know</a> (and <a href="../feedback.html">send us patches</a>, - if they are needed to get it to work elsewhere). - </li> - <li> - <a href="http://openjade.sourceforge.net/">OpenSP</a>, version 1.5 - or newer. OpenSP is the SGML and XML parser used by the service. - </li> - <li> - <a href="../sgml-lib.tar.gz">A collection of DTDs and other - files</a> to validate against. (You do not need to download this - if you mirror everything using <a href="#CVS">CVS</a>.) - </li> - <li> - A web server: we are currently running <a - href="http://httpd.apache.org/">Apache</a> version 1.3.27, but - likely any version will work, and other web servers may work as - well with some tweaking. In particular, the server needs to be - able to run <a href="http://www.w3.org/CGI/"><acronym - title="Common Gateway Interface">CGI</acronym></a> scripts and - have support for - <a href="http://httpd.apache.org/docs/howto/ssi.html"><acronym - title="Server Side Includes">SSI</acronym></a>. - </li> - <li> - <a href="http://www.perl.org/">Perl</a>: the <a - href="http://dev.w3.org/cvsweb/validator/httpd/cgi-bin/check">main - CGI script</a> that does everything is written in Perl. - You'll need version 5.6.0 or newer. Additionally, the following - <a href="http://www.cpan.org/"><acronym - title="Comprehensive Perl Archive Network">CPAN</acronym></a> - distributions are needed: - <ul> - <li> - <a href="http://search.cpan.org/dist/CGI.pm/">CGI.pm</a>, - version 2.81 or newer - </li> - <li> - <a href="http://search.cpan.org/dist/Config-General/">Config-General</a>, - version 2.06 or newer - </li> - <li> - <a href="http://search.cpan.org/dist/HTML-Parser/">HTML-Parser</a>, - version 3.25 or newer - </li> - <li> - <a href="http://search.cpan.org/dist/libwww-perl/">libwww-perl</a>, - version 5.60 or newer - </li> - <li> - <a href="http://search.cpan.org/dist/Set-IntSpan/">Set-IntSpan</a> - </li> - <li> - <a href="http://search.cpan.org/dist/Text-Iconv/">Text-Iconv</a> - </li> - <li> - <a href="http://search.cpan.org/dist/URI/">URI</a> - </li> - </ul> - </li> - </ul> - <p> - If you try to use the code and succeed (or fail), please <a - href="../feedback.html">let us know</a>! - </p> - </div> + <h3><a id="using" name="using"></a>Using the code</h3> + + <p> + The purpose of making the source code available is partly to allow + others to set up mirrors of the service (either publicly or within + an intranet behind a firewall), but also to allow us to collaborate + on making the service better! If you are interested in helping with + the development, we suggest you first <a href="../docs/install.html">install</a> + the code and <a href="../docs/devel.html">read our instructions for developers</a>. + </p> + - <div id="dev"> - <h2>Development</h2> - <p> - For information on current development activity, see the <a - href="http://lists.w3.org/Archives/Public/www-validator/">www-validator - mailing list archives</a>. To join in discussions about the - Validator, please join us in the <code>#validator</code> IRC channel - on <code>irc.freenode.net</code>. - </p> - <p> - Any changes to the service will attempt to maintain - compatibility with a <a href="../dev/tests/">list of test cases</a>. - Any changes to the code or documentation related to the service cause - a notification message to be sent to the <a - href="http://lists.w3.org/Archives/Public/www-validator-cvs/">www-validator-cvs - mailing list</a>. - </p> - </div> +</div> <!--#include virtual="../footer.html" --> </body> </html> diff --git a/htdocs/tips.css b/htdocs/tips.css index c94f58d..8204250 100644 --- a/htdocs/tips.css +++ b/htdocs/tips.css @@ -4,43 +4,40 @@ Copyright 2000 W3C (MIT, INRIA, Keio). All Rights Reserved. See http://www.w3.org/Consortium/Legal/ipr-notice.html#Copyright - $Id: tips.css,v 1.6 2003-02-24 23:33:18 ville Exp $ + $Id: tips.css,v 1.7 2004-05-09 15:56:49 link Exp $ */ - dl.tip { - text-align: justify; - margin-top: 0em; - background: #eeeeee; - border-top: 1px solid black; + margin-top: 0em; + text-align: center; + background: #eeeeee; + border-top: 1px solid black; border-bottom: 1px solid black; + padding: .5em; } -dl.tip dt a { - text-decoration: none; - color: inherit; -} - dl.tip dt { text-align: center; - padding: 0em; - margin: 0em; - color: black; + color: black; background: #eeeeee; + display: inline; } +dl.tip dt a { + text-decoration: none; + color: inherit; +} + dl.tip dd { text-align: center; text-decoration: none; font-weight: bolder; - margin: .5em; color: blue; + display: inline; + } dl.tip dd a { - padding: .1em .25em; text-decoration: none; - margin: .5em; - display: block; } diff --git a/htdocs/whatsnew.html b/htdocs/whatsnew.html index c8b6fed..5411fef 100755 --- a/htdocs/whatsnew.html +++ b/htdocs/whatsnew.html @@ -1,24 +1,74 @@ -<!--#set var="revision" value="\$Id: whatsnew.html,v 1.38 2003-05-24 20:32:45 link Exp $" ---><!--#set var="date" value="\$Date: 2003-05-24 20:32:45 $" +<!--#set var="revision" value="\$Id: whatsnew.html,v 1.39 2004-05-09 15:56:49 link Exp $" +--><!--#set var="date" value="\$Date: 2004-05-09 15:56:49 $" --><!--#set var="title" value="What's New at The W3C Markup Validation Service" --><!--#set var="relroot" value="./" --><!--#include virtual="header.html" --> - - <div id="skip" class="intro"> + <div class="doc"><a name="skip" id="skip"></a> + <h2>News for the W3C Markup Validator</h2> + <div class="intro"> <p> This page lists recent changes to <a href="./">the <acronym - title="World Wide Web Consortium">W3C</acronym> Markup Validation - Service</a>. For minor changes and bug fixes that aren't listed on this + title="World Wide Web Consortium">W3C</acronym> Markup Validation + Service</a>. For minor changes and bug fixes that aren't listed on this page, see <a href="http://dev.w3.org/cvsweb/validator/">the - <acronym title="Concurrent Versions System">CVS</acronym> log</a>. + <acronym title="Concurrent Versions System">CVS</acronym> log</a>. </p> </div> <dl> - <dt id="2003-05-01">May 01, 2003 (TBC):</dt> + <dt id="t2004-05-07">2004-05-07 — 0.6.5 Release:</dt> + <dd> + <p>Stable release including all the fixes and improvements made in consecutive beta versions + <a href="#t2004-04-30">0.6.5 Beta #3</a>, + <a href="#t2004-04-15">0.6.5 Beta #2</a>, + <a href="#t2003-08-26">0.6.5 Beta #1</a>, + <a href="http://lists.w3.org/Archives/Public/www-validator/2003Jun/0062.html">0.6.2 beta #2</a>, and + <a href="http://lists.w3.org/Archives/Public/www-validator/2003May/0069.html">0.6.2 beta #1</a> + </p> + </dd> + <dt id="t2004-04-30">2004-04-30 — 0.6.5 Beta #3:</dt> + <dd> + <p> + Testing version 0.6.5 Beta #3 of the Markup Validator; an intermediary + version including further layout, style and documentation improvements + over version 0.6.5 Beta #2, based on discussion and comments during + the testing phase of that version. + Changes include: + </p> + <ul> + <li>Simpler navigation system - removed the "links" navigation bar</li> + <li>More consistent layout</li> + <li>A few issues with the way some agents were dealing with our Style Sheets + were fixed. Other minor style fixes were also applied</li> + <li>Cleanup of grammar issues and typos in a large part of the documentation.</li> + </ul> + </dd> + + <dt id="t2004-04-15">2004-04-15 — 0.6.5 Beta #2:</dt> + <dd> + <p> + Testing version 0.6.5 Beta #2 of the Markup Validator; an intermediary + version addressing comments received for the version 0.6.5 Beta #1 + and adding significant User Interface and Documentation improvements. + Changes include: + </p> + <ul> + <li>More explanations for most of the validation error messages</li> + <li>New documentation on installing the Markup Validator locally</li> + <li>The "fussy" parsing mode is no longer available and will be + drastically improved before it comes back - if ever </li> + <li>The W3C Link Checker has now been spun off into a standalone product + and is no longer bundled with the Markup Validator</li> + <li>Stylesheets have been updated, with a more pleasant look</li> + <li>Easier navigation, more accessible documentation</li> + <li>More "Quality Tips" have been added</li> + </ul> + </dd> + <dt id="t2003-08-26">2003-08-26 — 0.6.5 Beta #1:</dt> <dd> <p> - Released version 0.6.2 of the Markup Validator; a maintenance - release to address various minor issues. Changes include: + Testing version 0.6.5 Beta #1 of the Markup Validator; an intermediary + version addressing various issues and add requested features. + Changes include: </p> <ul> <li>Stylesheets updated to work around browser issues.</li> @@ -26,15 +76,62 @@ courtesy of <a href="http://www.iki.fi/scop/">Ville Skyttä</a>.</li> <li>Fixed broken links in Copyright statement.</li> <li>Added current version number in page headings.</li> + <li>Detect proxies stripping the Referer header.</li> + <li>Added "Comma Tools".</li> + <li>Minor Accessibility fixes.</li> + <li>A few new Webmaster Tips for the Tip of The Day.</li> + <li>The Link Checker now sends Accept, and Accept-Language headers.</li> + <li>The Link Checker supports more HTTP Status Codes.</li> + <li>The documentation has seen much improvement.</li> + <li>The RPM spec file is now available in the download.</li> + <li>Update ISO-HTML DTD to TC1.</li> + <li>Update SVG 1.0 DTD to current Errata.</li> + <li>Added support for ISO-8859-16 Encoding.</li> + <li>Added support for the data: URI scheme.</li> + <li>The Link Checker in command-line mode now supports bundling of options.</li> + <li>The Validator RPMs now try to integrate with the system catalog.</li> + <li> + Added options to make the DOCTYPE and Charset Override behave like + Fallbacks. i.e. With these options enabled, the Override will only + insert the relevant new value iff one was not allready present. + </li> + <li>No longer treat missing DOCTYPE or Charset as a fatal error.</li> + <li>Much improved error messages for several error situations.</li> + <li>Updated and expanded error explanations.</li> + <li>Use passive (PASV) FTP by default.</li> + <li>Updated experimental mod_perl support to work with Apache/mod_perl 2.</li> + <li>Added support for the Big5-HKSCS encoding.</li> + <li>The MathML2 DTDs were updated to the 20030620 errata version.</li> + <li>Add option to restrict access to private IP addresses.</li> + <li>Added custom, inline, verbose error messages.</li> + <li>Tweaked markup and style for source display.</li> + <li>Tweaked markup and style for indicating position of error.</li> + <li>Changes in output mandated by W3C Legal.</li> + <li>Verbose output is now the default from the home page.</li> + <li> + Added new "fussy" parse mode (enabled by default from the home + page) that should make it easier to locate SHORTTAGS-related + problems (such as implied end tags). + </li> + <li>Valid Badge useage guidelines are now available.</li> + <li>Various internal restructuring to make way for future (post-0.6.5) features.</li> + <li> + "/referer" is now deprecated in favor of "?uri=referer"; + this allows us to preserve additional options in referer links. + </li> </ul> </dd> - <dt><a name="2002-12-01">December 01, 2002</a>:</dt> + <dt id="t2002-12-01">2002-12-01 — 0.6.1 Release:</dt> <dd> - Maintenance release to fix various minor issues reported against the - <a href="#2002-11-26">November 26</a> release. Stylesheet updates, - ability to turn on Verbose output, and bug fixes. + <ul> + <li> + Maintenance release to fix various minor issues reported against the + <a href="#t2002-11-26">November 26</a> release. Stylesheet updates, + ability to turn on Verbose output, and bug fixes. + </li> + </ul> </dd> - <dt><a name="2002-11-26">November 26, 2002</a>:</dt> + <dt id="t2002-11-26">2002-11-26 — 0.6.0 Release:</dt> <dd> <ul> <li>Improved design of layout, including for Validation results.</li> @@ -83,14 +180,14 @@ <li>And a whole bunch of bugfixes... :-)</li> </ul> </dd> - <dt><a name="2001-10-06">October 06, 2001</a>:</dt> + <dt id="t2001-10-06">2001-10-06:</dt> <dd> <ul> <li>Finished redesign and use consistent style for all pages..</li> <li>Added Tip-of-the-Day.</li> </ul> </dd> - <dt><a name="2001-09-24">September 24, 2001</a>:</dt> + <dt id="t2001-09-24">2001-09-24:</dt> <dd> <ul> <li>Added experimental support for <acronym @@ -99,7 +196,7 @@ <li>...and several minor bug fixes.</li> </ul> </dd> - <dt><a name="2001-09-13">September 13, 2001</a>:</dt> + <dt id="t2001-09-13">2001-09-13:</dt> <dd> <ul> <li>Added support for <acronym @@ -113,7 +210,7 @@ <li>Various bug fixes and minor changes.</li> </ul> </dd> - <dt><a name="2001-06-22">June 22, 2001</a>:</dt> + <dt id="t2001-06-22">2001-06-22:</dt> <dd> <ul> <li>Various bug fixes; notably two related to the File Upload feature.</li> @@ -123,7 +220,7 @@ <li>Documentation donated by Scott Bigham (Thanks Scott!).</li> </ul> </dd> - <dt><a name="2000-10-18">October 18, 2000</a>:</dt> + <dt id="t2000-10-18">2000-10-18:</dt> <dd> <p> Added support for <a @@ -135,7 +232,7 @@ Guide to <acronym title="Internation Organization for Standardization">ISO</acronym>-<acronym title="HyperText Markup Language">HTML</acronym></a>. </p> </dd> - <dt><a name="2000-06-30">June 30, 2000</a>:</dt> + <dt id="t2000-06-30">2000-06-30:</dt> <dd> <p> The service now checks <acronym @@ -144,7 +241,7 @@ title="eXtensible Markup Language">XML</acronym> well-formedness. </p> </dd> - <dt><a name="2000-04-28">April 28, 2000</a>:</dt> + <dt id="t2000-04-28">2000-04-28:</dt> <dd> <p> Added the <a href="file-upload.html">file upload</a> feature. @@ -158,7 +255,7 @@ <a href="about.html">another page</a>. </p> </dd> - <dt><a name="2000-01-26">January 26, 2000</a>:</dt> + <dt id="t2000-01-26">2000-01-26:</dt> <dd> <p> Updated the <acronym title="Document Type Definitions">DTDs</acronym> @@ -168,7 +265,7 @@ title="HyperText Markup Language">HTML</acronym> 4.01</a>. </p> </dd> - <dt><a name="1999.08.24">August 24, 1999</a>:</dt> + <dt id="t1999-08-24">1999-08-24:</dt> <dd> <p> Added the <acronym title="Document Type Definitions">DTDs</acronym> @@ -181,7 +278,7 @@ title="eXtensible HyperText Markup Language">XHTML</acronym> 1.0</a>. </p> </dd> - <dt><a name="1999.04.08">April 8, 1999</a>:</dt> + <dt id="t1999-04-08">1999-04-08:</dt> <dd> <p> Added username/password proxying for validation of documents protected @@ -195,7 +292,7 @@ of libwww-perl, <a href="http://www.linpro.no/lwp/">LWP</a>. </p> </dd> - <dt><a name="1999.03.04">March 4, 1999</a>:</dt> + <dt id="t1999-03-04">1999-03-04:</dt> <dd> <p> Added support for <a href="http://www.w3.org/MarkUp/#future"><acronym @@ -205,7 +302,7 @@ 19990304 working draft</a>. (see <a href="http://dev.w3.org/cvsweb/validator/httpd/cgi-bin/check.diff?r1=text&tr1=1.13&r2=text&tr2=1.16&f=h">the changes</a>) </p> </dd> - <dt><a name="1999.02.25">February 25, 1999</a>:</dt> + <dt id="t1999-02-25">1999-02-25:</dt> <dd> <p> Added support for <code>ISO-2022-JP</code> and <code>Shift_JIS</code> @@ -223,7 +320,7 @@ changes</a>). </p> </dd> - <dt><a name="1998.08.26">August 26, 1998</a>:</dt> + <dt id="t1998-08-26">1998-08-26:</dt> <dd> <p> Put a tarred and gzipped version of the SGML library files (<acronym @@ -231,11 +328,11 @@ Web. </p> </dd> - <dt><a name="1998.08.05">August 5, 1998</a>:</dt> + <dt id="t1998-08-05">1998-08-05:</dt> <dd> <p>Posted some new documents on the Web:</p> <ul> - <li><a href="http://validator.w3.org/source/">information on the source code</a></li> + <li><a href="source/">information on the source code</a></li> <li><a href="todo.html">the to-do list for the service</a></li> <li> <a href="feedback.html">a page explaining how to give feedback</a> @@ -244,10 +341,10 @@ </li> </ul> </dd> - <dt><a name="1998.07.24">July 24, 1998</a>:</dt> + <dt id="t1998-07-24">1998-07-24:</dt> <dd> <p> - Made the <a href="http://validator.w3.org/source/">source code</a> + Made the <a href="source/">source code</a> available via <a href="http://dev.w3.org/cvsweb/"><acronym title="World Wide Web Consortium">W3C</acronym>'s public <acronym title="Concurrent Versions System">CVS</acronym> tree</a>. @@ -257,14 +354,14 @@ 1.3.1.</a> </p> </dd> - <dt><a name="1998.06.19">June 19, 1998</a>:</dt> + <dt id="t1998-06-19">1998-06-19:</dt> <dd> <p> Added a page about <a href="about.html">the hardware/network behind this service</a>. </p> </dd> - <dt><a name="1998.04.20">April 20, 1998</a>:</dt> + <dt id="t1998-04-20">1998-04-20:</dt> <dd> <p> Added support for a parameter to check the referring Web page for @@ -273,7 +370,7 @@ (you can try the link to see how it works). </p> </dd> - <dt><a name="1997.12.18">December 18, 1997</a>:</dt> + <dt id="t1997-12-18">1997-12-18:</dt> <dd> <p> Updated <acronym title="HyperText Markup Language">HTML</acronym> 4.0 @@ -283,6 +380,7 @@ </p> </dd> </dl> +</div> <!--#include virtual="footer.html" --> </body> </html> |
