Annotation of 2002/css-validator/DOWNLOAD.html.en, revision 1.7
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">
! 10: @import "base.css";
! 11: </style>
! 12: <meta name="revision"
! 13: content="$Id: api.html,v 1.4 2006/02/23 13:48:59 ylafon Exp $" />
! 14: <!-- SSI Template Version: $Id: api.html,v 1.4 2006/02/23 13:48:59 ylafon Exp $ -->
1.1 plehegar 15:
1.7 ! ot 16: </head>
1.1 plehegar 17:
1.7 ! ot 18: <body>
! 19:
! 20: <div id="banner">
! 21: <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>
! 22: <a href="./"><img src="images/css_validation_service.png" alt="CSS Validation Service" /></a></h1>
! 23: </div>
! 24:
! 25:
! 26: <h2>Download and Install the CSS Validator</h2>
! 27: <h3>Download the CSS Validator</h3>
! 28: <h4>Download as java package (jar or war)</h4>
! 29: <p>TBD... we just need a stable location to put jar/war archives on a regular basis</p>
! 30:
! 31: <h4>Download the source</h4>
1.1 plehegar 32: <p>
33: The <a href='http://dev.w3.org/cvsweb/2002/css-validator'>CSS validator</a> is available for download using CVS.
34: Follow the <a href='http://dev.w3.org/cvsweb/'>instructions</a> to
1.4 plehegar 35: access the W3C CVS public server and get 2002/css-validator. Note
36: that the online version of the CSS Validator is older than the CVS
37: version so we may not have the same results...
1.7 ! ot 38: </p>
! 39:
! 40: <h3>Installation guide</h3>
! 41: <p>The CSS validation service is a servlet software, written in Java. It may be installed on any servlet engine,
! 42: and can also be used as a simple command-line tool.
! 43: The official W3C CSS Validation service is running with the Jigsaw server, which is the recommended setup.
! 44: However, for the sake of simplicity, we will, in this document, mostly provide details on how to install
! 45: it as an online servlet with Apache's servlet engine TOMCAT.</p>
! 46:
! 47: <p>Some instructions on installing the servlet with Jigsaw, as well as running it from a command-line environment,
! 48: are also given below. </p>
! 49:
! 50: <h4>Install the CSS Validator with Tomcat</h4>
! 51:
! 52: <h5>Install the servlet engine: Tomcat</h5>
! 53: <ul>
! 54: <li>Download Tomcat:
! 55: <ul>
! 56: <li>
! 57: This guide was tested using Apache Tomcat 5.5.16, available at :
! 58: <a href="http://apache.crihan.fr/dist/tomcat/tomcat-5/v5.5.16/bin/apache-tomcat-5.5.16.tar.gz">apache-tomcat-5.5.16.tar.gz</a>.
! 59: </li>
! 60: <li>
! 61: This version need java 1.5, but if you only have java 1.4 you can download a compatibility package :
! 62: <a href="http://apache.crihan.fr/dist/tomcat/tomcat-5/v5.5.16/bin/apache-tomcat-5.5.16-compat.tar.gz">apache-tomcat-5.5.16-compat.tar.gz</a>.
! 63: </li>
! 64: </ul>
! 65: </li>
! 66: <li>Uncompress the Tomcat source:
! 67: <ul>
! 68: <li>
! 69: "tar xvzf <span class="file">apache-tomcat-5.5.16.tar.gz</span>"
! 70: (see <a href="http://w3cstag5:8001/dleroy/doc/tomcat/contenu-tomcat.txt">contenu-tomcat.txt</a>).<br />
! 71: "tar xvzf <span class="file">apache-tomcat-5.5.16-compat.tar.gz</span>"
! 72: (see <a href="http://w3cstag5:8001/dleroy/doc/tomcat/contenu-tomcat-compat.txt">contenu-tomcat-compat.txt</a>).<br />
! 73: Tomcat server now is in <span class="dir">[<span class="const">TOMCAT_DIR</span>]</span>.
! 74: </li>
! 75: </ul>
! 76: </li>
! 77: <li>Test your tomcat installation:
! 78: <ul>
! 79: <li>
! 80: "cd <span class="dir">apache-tomcat-5.5.16</span>; <span class="dir">./bin/</span><span class="file">startup.sh</span>"<br />
! 81: Then in your browser : "<a href="http://localhost:8080/">http://localhost:8080</a>".
! 82: </li>
! 83: </ul>
! 84: </li>
! 85: <li>Configuration:
! 86: <ul>
! 87: <li>
! 88: Open "<span class="dir">conf/</span><span class="file">tomcat-users.xml</span>" and add user manager :
! 89: <span class="balise"><<span class="name">user</span>
! 90: <span class="attr">name</span>=<span class="string">"manager"</span>
! 91: <span class="attr">password</span>=<span class="string">"motdepasse"</span>
! 92: <span class="attr">roles</span>=<span class="string">"manager"</span>
! 93: /></span>.<br />
! 94: To change the service's port open file : "<span class="dir">conf/</span><span class="file">server.xml</span>" and modify
! 95: <span class="balise"><<span class="name">Service</span>
! 96: <span class="attr">name</span>=<span class="string">"Catalina"</span>></span>
! 97: ...
! 98: <span class="balise"><<span class="name">Connector</span>
! 99: <span class="attr">port</span>=<span class="string">"8080"</span> <span class="attr">...</span>></span>
! 100: ... .
! 101: </li>
! 102: <li>
! 103: To check changes you must reload the server.<br />
! 104: In <span class="dir">[<span class="const">TOMCAT_DIR</span>]</span> use
! 105: "<span class="dir">./bin/</span><span class="file">shutdown.sh</span>" then
! 106: "<span class="dir">./bin/</span><span class="file">startup.sh</span>".
! 107: </li>
! 108: </ul>
! 109: </li>
! 110: </ul>
! 111:
! 112: <h5>CSS Validator installation</h5>
! 113: <ul>
! 114: <li>
! 115: Download validator as explained <a href="#download">above</a>.
! 116: </li>
! 117: <li>
! 118: The Validator's sources are now in <span class="dir">[<span class="const">VALIDATOR_DIR</span>]</span> ("<span class="dir">.../2002/css-validator/</span>").
! 119: </li>
! 120: <li>
! 121: In "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]</span>" make a directory "<span class="dir">WEB-INF</span>".<br />
! 122: In "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]/WEB-INF</span>" make a directory "<span class="dir">lib</span>".<br />
! 123: Add the libraries :
! 124: <ol>
! 125: <li>servlet.jar
! 126: (which you should find in [<span class="const">TOMCAT_DIR</span>]/common/lib/, possibly under the name servlet-api.jar. If not, get it at
! 127: <a href="http://java.sun.com/products/servlet/download.html">java.sun.com</a></li>
! 128: <li><a href="http://jigsaw.w3.org/Devel/classes-2.2/20060329/">jigsaw.jar</a></li>
! 129: <li>xercesImpl.jar and xml-apis.jar (which can be downloaded with
! 130: <a href="http://www.apache.org/dist/xml/xerces-j/">xerces-j-bin</a>).</li>
! 131: </ol>
! 132:
! 133: copy all these jar files to the directory
! 134: "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]/WEB-INF/lib</span>"
! 135: and make sure the directory is in your CLASSPATH.
! 136: </li>
! 137: <li>Building the validator's source, css-validator.jar
! 138: <ul>
! 139: <li>"cd <span class="dir">[<span class="const">VALIDATOR_DIR</span>]/</span>; ant;"</li>
! 140: <li>
! 141: Copy or move file "<span class="file">web.xml</span>" from
! 142: "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]/</span>" to
! 143: "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]/WEB-INF/</span>".<br />
! 144: Copy or move file "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]/</span><span class="file">css-validator.jar</span>"
! 145: to "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]/WEB-INF/lib/</span>".<br />
! 146: In "<span class="dir">[<span class="const">TOMCAT_DIR</span>]/webapps</span>" make link named
! 147: "<span class="dir">css-validator</span>" to
! 148: "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]/</span>".<br />
! 149: "ln -s <span class="dir">[<span class="const">VALIDATOR_DIR</span>]/</span> <span class="dir">css-validator</span>".
! 150: </li>
! 151: </ul>
! 152: </li>
! 153: <li>
! 154: Finally, reload the Tomcat server:
! 155: <ul>
! 156: <li>
! 157: "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>;".<br />
! 158: Next in your browser "<a href="http://localhost:8080/css-validator/validator.html.en">http://localhost:8080/css-validator/validator.html.en</a>".
! 159: </li>
! 160: </ul>
! 161: </li>
! 162: </ul>
! 163:
! 164: <h4>Install on Jigsaw Web Server</h4>
! 165: <ul>
! 166: <li>First, download the source as described above</li>
! 167:
! 168: <li>Then you have to configure the validator home directory (usually this is
! 169: css-validator) so that it can work as a servlet container. For this purpose
! 170: you need to have Jigsaw installed (see the Jigsaw pages for a short
! 171: instruction (it is really easy)) and then start Jigsaw Admin. Change the
! 172: HTTPFrame to ServletDirectoryFrame.</li>
! 173:
! 174: <li>The next step is to create a resource "validator", with as class
! 175: 'ServletWrapper' and as frame 'ServletWrapperFrame'. The latter should add
! 176: itself automagically. The class of the servlet is
! 177: org.w3c.css.servlet.CssValidator. If there already exists a file named
! 178: 'validator', please rename it. It is important that this 'alias' is always
! 179: named 'validator'.</li>
! 180:
! 181: <li>Finally, start jigsaw and run the validator. Check which HTML you want to
! 182: invoke. Usually your URL will look like this:<br />
! 183: http://localhost:8001/css-validator/validator.html</li>
! 184: </ul>
! 185:
! 186: <h3>Command-line usage</h3>
! 187:
! 188: <p>The CSS validator can also be used as a command-line tool, if your computer
! 189: has java installed. Download the css-validator.jar, and run as:</p>
! 190: <pre>
! 191: java -jar css-validator.jar http://www.w3.org/
! 192: </pre>
! 193:
! 194: <ul class="navbar" id="menu">
! 195: <li><strong><a href="./" title="Home page for the W3C CSS Validation Service">Home</a></strong> <span class="hideme">|</span></li>
! 196: <li><a href="about" title="About this service">About</a> <span class="hideme">|</span></li>
! 197:
! 198: <li><a href="documentation" title="Documentation for the W3C CSS Validation Service">Documentation</a> <span class="hideme">|</span></li>
! 199: <li><a href="DOWNLOAD" title="Download the CSS validator">Download</a> <span class="hideme">|</span></li>
! 200: <li><a href="Email" title="How to provide feedback on this service">Feedback</a> <span class="hideme">|</span></li>
! 201: <li><a href="thanks" title="Credits and Acknowlegments">Credits</a><span class="hideme">|</span></li>
! 202:
! 203: </ul>
! 204:
! 205: <p id="activity_logos">
! 206: <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>
! 207: </p>
! 208:
! 209: <p id="support_logo">
! 210: Support this tool, become a<br />
! 211: <a href="http://www.w3.org/Consortium/supporters"><img src="http://www.w3.org/Consortium/supporter-logos/csupporter.png" alt="W3C Supporter" /></a>
! 212: </p>
! 213:
! 214: <p class="copyright">
! 215: <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 1994-2006
! 216: <a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a>®
! 217:
! 218: (<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>,
! 219: <a href="http://www.ercim.org/"><acronym title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>,
! 220: <a href="http://www.keio.ac.jp/">Keio</a>),
! 221: All Rights Reserved.
! 222: W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
! 223: <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a>,
! 224: <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a>
! 225:
! 226: and <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-software">software licensing</a>
! 227:
! 228: rules apply. Your interactions with this site are in accordance
! 229: with our <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Public">public</a> and
! 230: <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Members">Member</a> privacy
! 231: statements.
1.4 plehegar 232: </p>
1.7 ! ot 233:
! 234:
1.1 plehegar 235: </body>
1.7 ! ot 236:
1.1 plehegar 237: </html>
1.7 ! ot 238:
! 239:
! 240:
! 241:
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