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> &copy; 1994-2009
1.7       ot        231:       <a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a>&reg;
                    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