Annotation of 2002/css-validator/DOWNLOAD.html.en, revision 1.16
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.16 ! ot 14: content="$Id: DOWNLOAD.html.en,v 1.15 2007/01/09 18:08:55 ot Exp $" />
! 15: <!-- SSI Template Version: $Id: DOWNLOAD.html.en,v 1.15 2007/01/09 18:08:55 ot Exp $ -->
1.1 plehegar 16:
1.7 ot 17: </head>
1.1 plehegar 18:
1.7 ot 19: <body>
20:
21: <div id="banner">
22: <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_nb" /></a>
23: <a href="./"><img src="images/css_validation_service.png" alt="CSS Validation Service" /></a></h1>
24: </div>
25:
26:
27: <h2>Download and Install the CSS Validator</h2>
1.8 ot 28: <h3 id="download">Download the CSS Validator</h3>
1.7 ot 29:
1.8 ot 30: <h4 id="source">Download the source</h4>
1.1 plehegar 31: <p>
32: The <a href='http://dev.w3.org/cvsweb/2002/css-validator'>CSS validator</a> is available for download using CVS.
33: Follow the <a href='http://dev.w3.org/cvsweb/'>instructions</a> to
1.4 plehegar 34: access the W3C CVS public server and get 2002/css-validator. Note
1.8 ot 35: that the online version of the CSS Validator is generally older than the CVS
36: version so results and appearance may vary slightly...
1.7 ot 37: </p>
1.8 ot 38: <h4>Download as java package (jar or war)</h4>
1.15 ot 39: <!-- <p>TBD... we just need a stable location to put jar/war archives on a regular basis</p>-->
40: <p><a href="http://www.w3.org/QA/Tools/css-validator/css-validator.jar">css-validator.jar</a></p>
41:
1.7 ot 42:
43: <h3>Installation guide</h3>
44: <p>The CSS validation service is a servlet software, written in Java. It may be installed on any servlet engine,
45: and can also be used as a simple command-line tool.
46: The official W3C CSS Validation service is running with the Jigsaw server, which is the recommended setup.
47: However, for the sake of simplicity, we will, in this document, mostly provide details on how to install
1.8 ot 48: it as an online servlet with Apache's servlet engine Tomcat.</p>
1.7 ot 49:
50: <p>Some instructions on installing the servlet with Jigsaw, as well as running it from a command-line environment,
51: are also given below. </p>
52:
1.8 ot 53: <h4 id="prereq">Prerequisites</h4>
1.7 ot 54:
1.8 ot 55: <p>This installation guide assumes that you have downloaded, installed and tested: </p>
56: <ul class="instructions">
57: <li>A working java environment,</li>
58: <li>The <a href="http://ant.apache.org/">Ant</a> java building tool</li>
1.9 ot 59: <li>A java Web servlet container such as
1.8 ot 60: <a href="http://www.w3.org/Jigsaw/">Jigsaw</a>, <a href="http://tomcat.apache.org/">Tomcat</a> or
61: <a href="http://www.mortbay.org/">Jetty</a> if you plan on using the validator as an online service.
62: This guide only covers Tomcat and Jigsaw in details.</li>
63: </ul>
64: <p id="prereq-libs">For the installation of the validator onto your system, you will
65: need to download and/or find in your system a number of java libraries:</p>
66: <ul class="instructions">
67: <li>servlet.jar
68: (which, if you have Tomcat installed in [<span class="const">TOMCAT_DIR</span>],
1.16 ! ot 69: you should find in [<span class="const">TOMCAT_DIR</span>]/common/lib/) possibly
1.8 ot 70: under the name servlet-api.jar. If not, get it at
71: <a href="http://java.sun.com/products/servlet/download.html">java.sun.com</a></li>
72: <li><a href="http://jigsaw.w3.org/Devel/classes-2.2/20060329/">jigsaw.jar</a></li>
73: <li>xercesImpl.jar and xml-apis.jar (which can be downloaded with
74: <a href="http://www.apache.org/dist/xml/xerces-j/">xerces-j-bin</a>).</li>
1.7 ot 75: </ul>
76:
1.8 ot 77: <h4>Install the CSS Validator with Tomcat</h4>
78: <ol class="instructions">
1.7 ot 79: <li>
1.8 ot 80: Download validator as explained <a href="#source">above</a>.
81: </li>
82: <li>Copy the whole source folder ("<span class="dir">.../css-validator/</span>") to the <span class="dir">webapps</span>
1.16 ! ot 83: directory within your installation of Tomcat. usually, this will be
1.8 ot 84: <span class="dir">[<span class="const">TOMCAT_DIR</span>]/webapps/</span>.
85: The Validator's sources are now in <span class="dir">[<span class="const">TOMCAT_DIR</span>]/webapps/css-validator</span>,
86: which we will now call <span class="dir">[<span class="const">VALIDATOR_DIR</span>]</span>.
1.7 ot 87: </li>
1.10 ot 88: <li>In "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]</span>" create a directory "<span class="dir">WEB-INF</span>", and In "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]/WEB-INF</span>" create a directory "<span class="dir">lib</span>":<br />
89: <kbd>mkdir -p WEB-INF/lib</kbd>
90: </li>
1.8 ot 91: <li>Copy all the jar files (from the <a href="#prereq-libs">prerequisites</a>) to the directory "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]/WEB-INF/lib</span>"</li>
92: <li>Compile the validator's source: from the directory <span class="dir">[<span class="const">VALIDATOR_DIR</span>]</span>,
93: Run <kbd>ant</kbd>, while making sure that the jar files you downloaded are correctly set in you CLASSPATH environment variable.
94: Generally, the following will just work:<br />
95: <kbd>CLASSPATH=.:./WEB-INF/lib:$CLASSPATH ant</kbd>
1.7 ot 96: </li>
1.8 ot 97: <li>Copy or move "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]/</span><span class="file">css-validator.jar</span>"
98: to "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]/WEB-INF/lib/</span>".</li>
1.7 ot 99: <li>
1.8 ot 100: Copy or move file "<span class="file">web.xml</span>" from
101: "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]/</span>" to
102: "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]/WEB-INF/</span>".
1.7 ot 103: </li>
1.8 ot 104: <li>
105: Finally, reload the Tomcat server:<br />
106: <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.7 ot 107: </li>
1.8 ot 108: </ol>
1.7 ot 109:
110: <h4>Install on Jigsaw Web Server</h4>
1.8 ot 111: <ol class="instructions">
112: <li>First, download the source as described above, get the necessary jars, and build the source with <kbd>ant</kbd>.</li>
1.7 ot 113:
114: <li>Then you have to configure the validator home directory (usually this is
115: css-validator) so that it can work as a servlet container. For this purpose
116: you need to have Jigsaw installed (see the Jigsaw pages for a short
117: instruction (it is really easy)) and then start Jigsaw Admin. Change the
118: HTTPFrame to ServletDirectoryFrame.</li>
119:
120: <li>The next step is to create a resource "validator", with as class
121: 'ServletWrapper' and as frame 'ServletWrapperFrame'. The latter should add
122: itself automagically. The class of the servlet is
123: org.w3c.css.servlet.CssValidator. If there already exists a file named
124: 'validator', please rename it. It is important that this 'alias' is always
125: named 'validator'.</li>
126:
1.16 ! ot 127: <li>Finally, start Jigsaw and run the validator. Check which HTML you want to
1.7 ot 128: invoke. Usually your URL will look like this:<br />
129: http://localhost:8001/css-validator/validator.html</li>
1.8 ot 130: </ol>
1.7 ot 131:
132: <h3>Command-line usage</h3>
133:
134: <p>The CSS validator can also be used as a command-line tool, if your computer
1.8 ot 135: has java installed. build the css-validator.jar as explained above, and run as:<br />
136: <kbd>java -jar css-validator.jar http://www.w3.org/</kbd>
137: </p>
1.7 ot 138:
139: <ul class="navbar" id="menu">
140: <li><strong><a href="./" title="Home page for the W3C CSS Validation Service">Home</a></strong> <span class="hideme">|</span></li>
1.11 ot 141: <li><a href="about.html" title="About this service">About</a> <span class="hideme">|</span></li>
1.7 ot 142:
1.11 ot 143: <li><a href="documentation.html" title="Documentation for the W3C CSS Validation Service">Documentation</a> <span class="hideme">|</span></li>
144: <li><a href="Email.html" title="How to provide feedback on this service">Feedback</a> <span class="hideme">|</span></li>
145: <li><a href="thanks.html" title="Credits and Acknowlegments">Credits</a><span class="hideme">|</span></li>
1.7 ot 146:
147: </ul>
1.13 ot 148:
149: <ul id="lang_choice">
150: <li><a href="DOWNLOAD.html.de"
151: lang="de"
152: xml:lang="de"
153: hreflang="de"
154: rel="alternate">Deutsch</a></li>
155: <li><a href="DOWNLOAD.html.en"
156: lang="en"
157: xml:lang="en"
158: hreflang="en"
159: rel="alternate">English</a> </li>
160: <li><a href="DOWNLOAD.html.es"
161: lang="es" xml:lang="es" hreflang="es"
162: rel="alternate">Español</a></li>
163: <li><a href="DOWNLOAD.html.fr"
164: lang="fr"
165: xml:lang="fr"
166: hreflang="fr"
167: rel="alternate">Français</a> </li>
168: <li><a href="DOWNLOAD.html.it"
169: lang="it"
170: xml:lang="it"
171: hreflang="it"
172: rel="alternate">Italiano</a> </li>
173: <li><a href="DOWNLOAD.html.nl"
174: lang="nl"
175: xml:lang="nl"
176: hreflang="nl"
177: rel="alternate">Nederlands</a> </li>
178: <li><a href="DOWNLOAD.html.ja"
179: lang="ja"
180: xml:lang="ja"
181: hreflang="ja"
182: rel="alternate">日本語</a> </li>
183: <li><a href="DOWNLOAD.html.pl-PL"
184: lang="pl"
185: xml:lang="pl"
186: hreflang="pl"
187: rel="alternate">Polski</a> </li>
188: <li><a href="DOWNLOAD.html.zh-cn"
189: lang="zh-hans"
190: xml:lang="zh-hans"
191: hreflang="zh-hans"
192: rel="alternate">中文</a></li>
193: </ul>
194:
1.7 ot 195:
196: <p id="activity_logos">
197: <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>
198: </p>
199:
200: <p id="support_logo">
201: Support this tool, become a<br />
202: <a href="http://www.w3.org/Consortium/supporters"><img src="http://www.w3.org/Consortium/supporter-logos/csupporter.png" alt="W3C Supporter" /></a>
203: </p>
204:
205: <p class="copyright">
206: <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 1994-2006
207: <a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a>®
208:
209: (<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>,
210: <a href="http://www.ercim.org/"><acronym title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>,
211: <a href="http://www.keio.ac.jp/">Keio</a>),
212: All Rights Reserved.
213: W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
214: <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a>,
215: <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a>
216:
217: and <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-software">software licensing</a>
218:
219: rules apply. Your interactions with this site are in accordance
220: with our <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Public">public</a> and
221: <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Members">Member</a> privacy
222: statements.
1.4 plehegar 223: </p>
1.7 ot 224:
225:
1.1 plehegar 226: </body>
1.7 ot 227:
1.1 plehegar 228: </html>
1.7 ot 229:
230:
231:
232:
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