Annotation of 2002/css-validator/DOWNLOAD.html.en, revision 1.26
1.7 ot 1: <?xml version="1.0" encoding="utf-8"?>
2: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
3: "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
4: <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
5: <head>
6: <title>Download and Install the CSS Validator</title>
7: <link rev="made" href="mailto:www-validator-css@w3.org" />
8: <link rev="start" href="./" title="Home Page" />
9: <style type="text/css" media="all">
1.12 ot 10: @import "style/base.css";
1.14 ot 11: @import "style/docs.css";
1.7 ot 12: </style>
13: <meta name="revision"
1.26 ! ot 14: content="$Id: DOWNLOAD.html.en,v 1.25 2009/01/08 22:40:32 ot Exp $" />
! 15: <!-- SSI Template Version: $Id: DOWNLOAD.html.en,v 1.25 2009/01/08 22:40:32 ot Exp $ -->
1.1 plehegar 16:
1.7 ot 17: </head>
1.1 plehegar 18:
1.7 ot 19: <body>
20: <div id="banner">
1.18 ot 21: <h1 id="title"><a href="http://www.w3.org/"><img alt="W3C" width="110" height="61" id="logo" src="./images/w3c.png" /></a>
22: <a href="./"><span>CSS Validation Service</span></a></h1>
23: <p id="tagline">
24: Check Cascading Style Sheets (CSS) and (X)HTML documents with style sheets
25: </p>
26: </div>
1.7 ot 27:
1.18 ot 28: <div class="doc">
1.7 ot 29: <h2>Download and Install the CSS Validator</h2>
1.8 ot 30: <h3 id="download">Download the CSS Validator</h3>
1.7 ot 31:
1.26 ! ot 32: <p>The CSS validator is available in three different packaging: from CVS for developers who want the very latest version,
! 33: as a jar archive to build applications and for use as a command line tool, and (since 2009) as a war archive for server-side
! 34: applications.</p>
! 35:
! 36: <h4 id="source">Download the source code</h4>
! 37: <p>The <a href="http://dev.w3.org/cvsweb/2002/css-validator">source of the CSS Validator</a> can be retrieved with CVS.
! 38: Follow the <a href='http://dev.w3.org/cvsweb/'>instructions</a> to connect to the W3C's CVS server, and retrieve the
! 39: <code>2002/css-validator</code> module. Please note that the online service for the CSS validator is a stable release,
! 40: generally a little older than the version under CVS, and their results and behaviour may differ.</p>
! 41:
! 42:
! 43: <h4>Download the Java archive (jar)</h4>
! 44: <p><a href="http://www.w3.org/QA/Tools/css-validator/css-validator.jar">css-validator.jar</a></p>
! 45:
! 46: <h4>Download the Web archive (war)</h4>
! 47: <p><a href="http://www.w3.org/QA/Tools/css-validator/css-validator.war">css-validator.war</a></p>
! 48:
! 49: <h3>Installation Guide</h3>
! 50: <p>The CSS Validation service is based on a servlet written in the cross-platform Java language, and can
! 51: be installed on any servlet platform. While the official service from W3C runs under the Jigsaw server
! 52: (which is the recommended setup), we will for the sake of convenience describe in this guide the setup
! 53: under Apache's servlet engine, Tomcat, as well as some quick instructions for Jigsaw and commandline usage.</p>
1.7 ot 54:
1.8 ot 55: <h4 id="prereq">Prerequisites</h4>
1.7 ot 56:
1.26 ! ot 57: <p>This guide assumes that you have already downloaded and installed successfully the following:</p>
1.8 ot 58: <ul class="instructions">
1.26 ! ot 59: <li>a working java environment ;</li>
! 60: <li>the <a href="http://ant.apache.org/">Ant</a> java build tool ;</li>
! 61: <li>a Java servlet container such as <a href="http://www.w3.org/Jigsaw/">Jigsaw</a>,
! 62: <a href="http://tomcat.apache.org/">Tomcat</a> or <a href="http://www.mortbay.org/">Jetty</a>, if you plan to provide the validator as a web service.</li>
1.7 ot 63: </ul>
1.26 ! ot 64: <p id="prereq-libs">
! 65: As a prerequisite to the installation, you will need to know the complete path to the java library called <span class="file">servlet.jar</span>.
! 66: It is generally available within <span class="dir">[<span class="const">TOMCAT_DIR</span>]/common/lib/</span>, with <span class="dir">[<span class="const">TOMCAT_DIR</span>]</span> being the path under which Tomcat is installed. It may also be found under the name servlet-api.jar. If you can not
! 67: find it, <a href="http://java.sun.com/products/servlet/DOWNLOAD.html">java.sun.com</a> will have it.
! 68: </p>
1.7 ot 69:
1.26 ! ot 70: <h4>Installation of the CSS validator under Tomcat</h4>
1.8 ot 71: <ol class="instructions">
1.26 ! ot 72: <li>Download the CVS source as explained <a href="#source">above</a> ;</li>
! 73: <li>Edit the file called <span class="file">[<span class="const">VALIDATOR_DIR</span>]build.xml</span> and replace the value of
! 74: property servlet.lib with the full path to <span class="file">servlet.jar</span>
! 75: </li>
! 76: <li>
! 77: You can now build the source : from <span class="dir">[<span class="const">VALIDATOR_DIR</span>run the command <kbd>ant war</kbd>.
! 78: Running ant should download a number of necessary libraries, and build the archive called <span class="file">css-validator.war</span>.
! 79: </li>
! 80: <li>
! 81: Copy or move <span class="file">css-validator.war</span> to <span class="dir">[<span class="const">TOMCAT_DIR</span>]/webapps</span>.
! 82: <li>Finally, restart the Tomcat engine :<br />
1.8 ot 83: <kbd>"cd <span class="dir">[<span class="const">TOMCAT_DIR</span>]</span>; <span class="dir">./bin/</span><span class="file">shutdown.sh</span>; <span class="dir">./bin/</span><span class="file">startup.sh</span>;"</kbd>
1.26 ! ot 84: </li>
1.8 ot 85: </ol>
1.7 ot 86:
1.26 ! ot 87: <h4>Installation of the CSS validator under Jigsaw</h4>
1.8 ot 88: <ol class="instructions">
1.26 ! ot 89: <li>Download the CVS source as explained previously, save it under <span class="dir">[<span class="const">JIGSAW_DIR</span>]/WWW</span>
! 90: and build source with <kbd>ant jigsaw</kbd> ;
! 91: </li>
! 92: <li>Next, configure the root folder for the validator (in most cases it will be called css-validator) to make it a servlet container.
! 93: Within your Jigsaw installation, launch the Jigsaw Admin utility, browse to <code>css-validator</code> and change it from HTTPFrame to ServletDirectoryFrame ;</li>
! 94: <li>The next step will be to create a "validator" resource as 'ServletWrapper' class. A 'ServletWrapperFrame' frame will automagically
! 95: be created for it. You will need to provide the name of the servlet class, which for the CSS Validator os org.w3c.css.servlet.CssValidator.
! 96: Note that a file called “validator” may already be present – you MUST rename it, as the validator absolutely needs to enforce this name for the servlet wrapper ;</li>
! 97: <li>Make sure that all the .jar libraries within the <span class="dir">[<span class="const">JIGSAW_DIR</span>]/WWW/css-validator/lib</span> folder
! 98: are properly added to Jigsaw's CLASSPATH setup.</li>
! 99: <li>Finally, restart Jigsaw and point your browser to the validator. The URI should be something like :<br />
1.7 ot 100: http://localhost:8001/css-validator/validator.html</li>
1.8 ot 101: </ol>
1.7 ot 102:
1.26 ! ot 103: <h3>Command-Line use</h3>
1.7 ot 104:
1.26 ! ot 105: <p>Any computer with Java installed can also run the validator from the terminal/console as a commandline tool.
! 106: Download the css-validator.jar jar archive (or build it with <kbd>ant jar</kbd>) and run it as :<br />
! 107: <kbd>java -jar css-validator.jar http://www.w3.org/</kbd>.
1.8 ot 108: </p>
1.26 ! ot 109: <p>Note : the css-validator.jar file must be located at the exact same level as the lib/ folder to work properly.</p>
1.18 ot 110: </div>
1.7 ot 111: <ul class="navbar" id="menu">
112: <li><strong><a href="./" title="Home page for the W3C CSS Validation Service">Home</a></strong> <span class="hideme">|</span></li>
1.11 ot 113: <li><a href="about.html" title="About this service">About</a> <span class="hideme">|</span></li>
1.7 ot 114:
1.11 ot 115: <li><a href="documentation.html" title="Documentation for the W3C CSS Validation Service">Documentation</a> <span class="hideme">|</span></li>
116: <li><a href="Email.html" title="How to provide feedback on this service">Feedback</a> <span class="hideme">|</span></li>
117: <li><a href="thanks.html" title="Credits and Acknowlegments">Credits</a><span class="hideme">|</span></li>
1.7 ot 118:
119: </ul>
1.13 ot 120:
121: <ul id="lang_choice">
1.22 ot 122:
1.23 ot 123: <li><a href="DOWNLOAD.html.de"
1.22 ot 124: lang="de"
125: xml:lang="de"
126: hreflang="de"
127: rel="alternate">Deutsch</a>
128: </li>
129:
1.23 ot 130: <li><a href="DOWNLOAD.html.en"
1.22 ot 131: lang="en"
132: xml:lang="en"
133: hreflang="en"
134: rel="alternate">English</a>
135: </li>
136:
1.23 ot 137: <li><a href="DOWNLOAD.html.es"
1.22 ot 138: lang="es"
139: xml:lang="es"
140: hreflang="es"
141: rel="alternate">Español</a>
142: </li>
143:
1.23 ot 144: <li><a href="DOWNLOAD.html.fr"
1.22 ot 145: lang="fr"
146: xml:lang="fr"
147: hreflang="fr"
148: rel="alternate">Français</a>
149: </li>
150:
1.23 ot 151: <li><a href="DOWNLOAD.html.ko"
1.22 ot 152: lang="ko"
153: xml:lang="ko"
154: hreflang="ko"
155: rel="alternate">한국어</a>
156: </li>
157:
1.23 ot 158: <li><a href="DOWNLOAD.html.it"
1.22 ot 159: lang="it"
160: xml:lang="it"
161: hreflang="it"
162: rel="alternate">Italiano</a>
163: </li>
164:
1.23 ot 165: <li><a href="DOWNLOAD.html.nl"
1.22 ot 166: lang="nl"
167: xml:lang="nl"
168: hreflang="nl"
169: rel="alternate">Nederlands</a>
170: </li>
171:
1.23 ot 172: <li><a href="DOWNLOAD.html.ja"
1.22 ot 173: lang="ja"
174: xml:lang="ja"
175: hreflang="ja"
176: rel="alternate">日本語</a>
177: </li>
178:
1.23 ot 179: <li><a href="DOWNLOAD.html.pl-PL"
1.22 ot 180: lang="pl-PL"
181: xml:lang="pl-PL"
182: hreflang="pl-PL"
183: rel="alternate">Polski</a>
184: </li>
185:
1.23 ot 186: <li><a href="DOWNLOAD.html.pt-BR"
1.22 ot 187: lang="pt-BR"
188: xml:lang="pt-BR"
189: hreflang="pt-BR"
190: rel="alternate">Português</a>
191: </li>
192:
1.23 ot 193: <li><a href="DOWNLOAD.html.ru"
1.22 ot 194: lang="ru"
195: xml:lang="ru"
196: hreflang="ru"
197: rel="alternate">Русский</a>
198: </li>
199:
1.23 ot 200: <li><a href="DOWNLOAD.html.sv"
1.22 ot 201: lang="sv"
202: xml:lang="sv"
203: hreflang="sv"
204: rel="alternate">Svenska</a>
205: </li>
206:
1.23 ot 207: <li><a href="DOWNLOAD.html.zh-cn"
1.22 ot 208: lang="zh-cn"
209: xml:lang="zh-cn"
210: hreflang="zh-cn"
211: rel="alternate">简体中文</a>
212: </li>
213: </ul>
214:
1.13 ot 215:
1.7 ot 216:
1.18 ot 217: <div id="footer">
1.7 ot 218: <p id="activity_logos">
1.18 ot 219:
1.7 ot 220: <a href="http://www.w3.org/QA/" title="W3C's Quality Assurance Activity, bringing you free Web quality tools and more"><img src="http://www.w3.org/QA/2002/12/qa-small.png" alt="QA" /></a><a href="http://www.w3.org/Style/CSS/learning" title="Learn more about Cascading Style Sheets"><img src="images/woolly-icon" alt="CSS" /></a>
221: </p>
222:
223: <p id="support_logo">
1.25 ot 224: <a href="http://www.w3.org/QA/Tools/Donate">
225: <img src="http://www.w3.org/QA/Tools/I_heart_validator" alt="I heart Validator logo" title=" Validators Donation Program" />
226: </a>
1.7 ot 227: </p>
228:
229: <p class="copyright">
1.24 ot 230: <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 1994-2009
1.7 ot 231: <a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a>®
232:
233: (<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>,
234: <a href="http://www.ercim.org/"><acronym title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>,
235: <a href="http://www.keio.ac.jp/">Keio</a>),
236: All Rights Reserved.
237: W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
238: <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a>,
239: <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a>
240:
241: and <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-software">software licensing</a>
242:
243: rules apply. Your interactions with this site are in accordance
244: with our <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Public">public</a> and
245: <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Members">Member</a> privacy
246: statements.
1.4 plehegar 247: </p>
1.7 ot 248:
1.18 ot 249: </div>
1.1 plehegar 250: </body>
1.7 ot 251:
1.1 plehegar 252: </html>
1.7 ot 253:
254:
255:
256:
Webmaster