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