Annotation of 2002/css-validator/DOWNLOAD.html.en, revision 1.31

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.31    ! ylafon     14:   content="$Id: DOWNLOAD.html.en,v 1.30 2009-03-25 20:13:52 ot Exp $" />
        !            15:   <!-- SSI Template Version: $Id: DOWNLOAD.html.en,v 1.30 2009-03-25 20:13:52 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> &copy; 1994-2009
1.7       ot        233:       <a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a>&reg;
                    234: 
                    235:       (<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>,
1.31    ! ylafon    236:       <a href="http://www.ercim.eu/"><acronym title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>,
1.7       ot        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