Annotation of 2002/css-validator/DOWNLOAD.html.en, revision 1.30
1.7 ot 1: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2: "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3: <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
4: <head>
1.28 ot 5: <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
1.7 ot 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.30 ! ot 14: content="$Id: DOWNLOAD.html.en,v 1.29 2009/02/05 14:31:30 ot Exp $" />
! 15: <!-- SSI Template Version: $Id: DOWNLOAD.html.en,v 1.29 2009/02/05 14:31:30 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: <h3>Installation Guide</h3>
47: <p>The CSS Validation service is based on a servlet written in the cross-platform Java language, and can
48: be installed on any servlet platform. While the official service from W3C runs under the Jigsaw server
49: (which is the recommended setup), we will for the sake of convenience describe in this guide the setup
50: under Apache's servlet engine, Tomcat, as well as some quick instructions for Jigsaw and commandline usage.</p>
1.7 ot 51:
1.8 ot 52: <h4 id="prereq">Prerequisites</h4>
1.7 ot 53:
1.26 ot 54: <p>This guide assumes that you have already downloaded and installed successfully the following:</p>
1.8 ot 55: <ul class="instructions">
1.26 ot 56: <li>a working java environment ;</li>
57: <li>the <a href="http://ant.apache.org/">Ant</a> java build tool ;</li>
58: <li>a Java servlet container such as <a href="http://www.w3.org/Jigsaw/">Jigsaw</a>,
59: <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 60: </ul>
1.26 ot 61: <p id="prereq-libs">
62: 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>.
63: 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
64: find it, <a href="http://java.sun.com/products/servlet/DOWNLOAD.html">java.sun.com</a> will have it.
65: </p>
1.7 ot 66:
1.26 ot 67: <h4>Installation of the CSS validator under Tomcat</h4>
1.8 ot 68: <ol class="instructions">
1.26 ot 69: <li>Download the CVS source as explained <a href="#source">above</a> ;</li>
70: <li>Edit the file called <span class="file">[<span class="const">VALIDATOR_DIR</span>]build.xml</span> and replace the value of
71: property servlet.lib with the full path to <span class="file">servlet.jar</span>
72: </li>
73: <li>
74: You can now build the source : from <span class="dir">[<span class="const">VALIDATOR_DIR</span>run the command <kbd>ant war</kbd>.
75: Running ant should download a number of necessary libraries, and build the archive called <span class="file">css-validator.war</span>.
76: </li>
77: <li>
78: Copy or move <span class="file">css-validator.war</span> to <span class="dir">[<span class="const">TOMCAT_DIR</span>]/webapps</span>.
79: <li>Finally, restart the Tomcat engine :<br />
1.8 ot 80: <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 81: </li>
1.8 ot 82: </ol>
1.7 ot 83:
1.26 ot 84: <h4>Installation of the CSS validator under Jigsaw</h4>
1.8 ot 85: <ol class="instructions">
1.26 ot 86: <li>Download the CVS source as explained previously, save it under <span class="dir">[<span class="const">JIGSAW_DIR</span>]/WWW</span>
87: and build source with <kbd>ant jigsaw</kbd> ;
88: </li>
89: <li>Next, configure the root folder for the validator (in most cases it will be called css-validator) to make it a servlet container.
90: Within your Jigsaw installation, launch the Jigsaw Admin utility, browse to <code>css-validator</code> and change it from HTTPFrame to ServletDirectoryFrame ;</li>
91: <li>The next step will be to create a "validator" resource as 'ServletWrapper' class. A 'ServletWrapperFrame' frame will automagically
92: 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.
93: 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>
94: <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
95: are properly added to Jigsaw's CLASSPATH setup.</li>
96: <li>Finally, restart Jigsaw and point your browser to the validator. The URI should be something like :<br />
1.7 ot 97: http://localhost:8001/css-validator/validator.html</li>
1.8 ot 98: </ol>
1.7 ot 99:
1.26 ot 100: <h3>Command-Line use</h3>
1.7 ot 101:
1.26 ot 102: <p>Any computer with Java installed can also run the validator from the terminal/console as a commandline tool.
103: Download the css-validator.jar jar archive (or build it with <kbd>ant jar</kbd>) and run it as :<br />
104: <kbd>java -jar css-validator.jar http://www.w3.org/</kbd>.
1.8 ot 105: </p>
1.26 ot 106: <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 107: </div>
1.7 ot 108: <ul class="navbar" id="menu">
109: <li><strong><a href="./" title="Home page for the W3C CSS Validation Service">Home</a></strong> <span class="hideme">|</span></li>
1.11 ot 110: <li><a href="about.html" title="About this service">About</a> <span class="hideme">|</span></li>
1.7 ot 111:
1.11 ot 112: <li><a href="documentation.html" title="Documentation for the W3C CSS Validation Service">Documentation</a> <span class="hideme">|</span></li>
113: <li><a href="Email.html" title="How to provide feedback on this service">Feedback</a> <span class="hideme">|</span></li>
114: <li><a href="thanks.html" title="Credits and Acknowlegments">Credits</a><span class="hideme">|</span></li>
1.7 ot 115:
116: </ul>
1.13 ot 117:
118: <ul id="lang_choice">
1.22 ot 119:
1.30 ! ot 120: <li><a href="DOWNLOAD.html.bg"
! 121: lang="bg"
! 122: xml:lang="bg"
! 123: hreflang="bg"
! 124: rel="alternate">Български</a></li>
! 125: <li><a href="DOWNLOAD.html.de"
1.22 ot 126: lang="de"
127: xml:lang="de"
128: hreflang="de"
129: rel="alternate">Deutsch</a>
130: </li>
131:
1.23 ot 132: <li><a href="DOWNLOAD.html.en"
1.22 ot 133: lang="en"
134: xml:lang="en"
135: hreflang="en"
136: rel="alternate">English</a>
137: </li>
138:
1.23 ot 139: <li><a href="DOWNLOAD.html.es"
1.22 ot 140: lang="es"
141: xml:lang="es"
142: hreflang="es"
143: rel="alternate">Español</a>
144: </li>
145:
1.23 ot 146: <li><a href="DOWNLOAD.html.fr"
1.22 ot 147: lang="fr"
148: xml:lang="fr"
149: hreflang="fr"
150: rel="alternate">Français</a>
151: </li>
152:
1.23 ot 153: <li><a href="DOWNLOAD.html.ko"
1.22 ot 154: lang="ko"
155: xml:lang="ko"
156: hreflang="ko"
157: rel="alternate">한국어</a>
158: </li>
159:
1.23 ot 160: <li><a href="DOWNLOAD.html.it"
1.22 ot 161: lang="it"
162: xml:lang="it"
163: hreflang="it"
164: rel="alternate">Italiano</a>
165: </li>
166:
1.23 ot 167: <li><a href="DOWNLOAD.html.nl"
1.22 ot 168: lang="nl"
169: xml:lang="nl"
170: hreflang="nl"
171: rel="alternate">Nederlands</a>
172: </li>
173:
1.23 ot 174: <li><a href="DOWNLOAD.html.ja"
1.22 ot 175: lang="ja"
176: xml:lang="ja"
177: hreflang="ja"
178: rel="alternate">日本語</a>
179: </li>
180:
1.23 ot 181: <li><a href="DOWNLOAD.html.pl-PL"
1.22 ot 182: lang="pl-PL"
183: xml:lang="pl-PL"
184: hreflang="pl-PL"
185: rel="alternate">Polski</a>
186: </li>
187:
1.23 ot 188: <li><a href="DOWNLOAD.html.pt-BR"
1.22 ot 189: lang="pt-BR"
190: xml:lang="pt-BR"
191: hreflang="pt-BR"
192: rel="alternate">Português</a>
193: </li>
194:
1.23 ot 195: <li><a href="DOWNLOAD.html.ru"
1.22 ot 196: lang="ru"
197: xml:lang="ru"
198: hreflang="ru"
199: rel="alternate">Русский</a>
200: </li>
201:
1.23 ot 202: <li><a href="DOWNLOAD.html.sv"
1.22 ot 203: lang="sv"
204: xml:lang="sv"
205: hreflang="sv"
206: rel="alternate">Svenska</a>
207: </li>
208:
1.23 ot 209: <li><a href="DOWNLOAD.html.zh-cn"
1.22 ot 210: lang="zh-cn"
211: xml:lang="zh-cn"
212: hreflang="zh-cn"
213: rel="alternate">简体中文</a>
214: </li>
215: </ul>
216:
1.13 ot 217:
1.7 ot 218:
1.18 ot 219: <div id="footer">
1.7 ot 220: <p id="activity_logos">
1.18 ot 221:
1.7 ot 222: <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>
223: </p>
224:
225: <p id="support_logo">
1.25 ot 226: <a href="http://www.w3.org/QA/Tools/Donate">
227: <img src="http://www.w3.org/QA/Tools/I_heart_validator" alt="I heart Validator logo" title=" Validators Donation Program" />
228: </a>
1.7 ot 229: </p>
230:
231: <p class="copyright">
1.24 ot 232: <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 1994-2009
1.7 ot 233: <a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a>®
234:
235: (<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>,
236: <a href="http://www.ercim.org/"><acronym title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>,
237: <a href="http://www.keio.ac.jp/">Keio</a>),
238: All Rights Reserved.
239: W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
240: <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a>,
241: <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a>
242:
243: and <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-software">software licensing</a>
244:
245: rules apply. Your interactions with this site are in accordance
246: with our <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Public">public</a> and
247: <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Members">Member</a> privacy
248: statements.
1.4 plehegar 249: </p>
1.7 ot 250:
1.18 ot 251: </div>
1.1 plehegar 252: </body>
1.7 ot 253:
1.1 plehegar 254: </html>
1.7 ot 255:
256:
257:
258:
Webmaster