Télécharger et installer le validateur CSS

Télécharger le validateur CSS

Télécharger le code source

Le validateur CSS est disponible en téléchargement par CVS. Suivez les instructions pour accéder au serveur CVS public du W3C et sélectionnez 2002/css-validator. Notez que la version en ligne du validateur CSS est en général plus ancienne que la version CVS, de sorte que les résultats et l'aspect peuvent varier légèrement.

Télécharger un paquetage Java (jar ou war)

css-validator.jar

Guide d'installation

Le service de validation CSS est un servlet écrit en Java. On peut l'installer sur n'importe quel moteur de servlets, et on peut aussi s'en servir comme un simple outil en ligne de commande. Le service de validation CSS officiel du W3C fonctionne avec le serveur Jigsaw, ce qui est la configuration recommandée. Toutefois, pour simplifier, dans ce document, nous indiquerons comment l'installer en tant que servlet en ligne avec le moteur de servlets Tomcat d'Apache.

On donne également ici quelques instructions pour installer le servlet avec Jigsaw et pour l'exécuter dans un environnement en ligne de commande.

Préalables

Ce guide d'installation suppose que vous avez téléchargé, installé et testé :

• Un environnement Java fonctionnel ;
• L'outil de construction Java Ant ;
• Un conteneur de servlet Web Java tel que Jigsaw, Tomcat ou Jetty, si vous prévoyez d'utiliser le validateur comme service en ligne. Ce guide couvre dans le détail seulement Tomcat et Jigsaw.

Pour l'installation du validateur sur votre système, il vous faudra charger et/ou rechercher dans votre système plusieurs bibliothèques Java :

• servlet.jar (que vous trouverez dans [TOMCAT_DIR]/common/lib/, si Tomcat est installé dans [TOMCAT_DIR], probablement sous le nom servlet-api.jar). Sinon, récupérez le chez java.sun.com ;
• jigsaw.jar
• xercesImpl.jar et xml-apis.jar (que l'on peut télécharger avec xerces-j-bin).
• tagsoup.jar

Installation du validateur CSS avec Tomcat

1. Téléchargez le validateur comme expliqué précédemment ;
2. Copiez le dossier source entier (".../css-validator/") dans le répertoire webapps de votre installation de Tomcat. Ce sera habituellement dans [TOMCAT_DIR]/webapps/. Les sources du validateur se trouvent maintenant dans [TOMCAT_DIR]/webapps/css-validator, que nous appellerons désormais [VALIDATOR_DIR] ;
3. Dans "[VALIDATOR_DIR]", créez un répertoire "WEB-INF", puis dans "[VALIDATOR_DIR]/WEB-INF", créez un répertoire "lib" :
   mkdir -p WEB-INF/lib
4. Copiez tous les fichiers jar (cf. Préalables) dans le répertoire "[VALIDATOR_DIR]/WEB-INF/lib" ;
5. Compiler la source du validateur : depuis le répertoire [VALIDATOR_DIR], lancez ant, tout en vous assurant que les fichiers jar téléchargés sont correctement définis dans votre variable d'environnement CLASSPATH. En général, ce qui suit fonctionnera :
   CLASSPATH=.:./WEB-INF/lib:$CLASSPATH ant
6. Copiez ou déplacez "[VALIDATOR_DIR]/css-validator.jar" dans "[VALIDATOR_DIR]/WEB-INF/lib/" ;
7. Copiez ou déplacez le fichier "web.xml" depuis "[VALIDATOR_DIR]/" vers "[VALIDATOR_DIR]/WEB-INF/" ;
8. Enfin, relancez le serveur Tomcat :
   "cd [TOMCAT_DIR]; ./bin/shutdown.sh; ./bin/startup.sh;"

Installation sur le serveur Web Jigsaw

1. Téléchargez d'abord la source comme décrit précédemment, récupérez les fichiers jar nécessaires et construisez la source avec ant ;
2. Configurez ensuite le répertoire racine du validateur (en général, c'est css-validator), afin qu'il puisse fonctionner comme conteneur de servlets. Pour ce faire, vous devrez avoir installé Jigsaw (cf. les pages de Jigsaw pour quelques instructions, ce n'est vraiment pas difficile) puis lancez Jigsaw Admin. Changez HTTPFrame pour ServletDirectoryFrame ;
3. La prochaine étape consiste à créer une ressource "validator", avec pour classe 'ServletWrapper' et pour cadre 'ServletWrapperFrame'. Ce dernier devrait s'ajouter comme par magie. La classe du servlet est org.w3c.css.servlet.CssValidator. S'il existe déjà un fichier nommé 'validator', veuillez le renommer. Il importe que cet 'alias' soit toujours nommé 'validator' ;
4. Enfin, démarrez jigsaw et lancez le validateur. Vérifiez quel type de HTML vous souhaitez invoquer. Habituellement, l'adresse URL ressemblera à ça :
   http://localhost:8001/css-validator/validator.html

Utilisation en ligne de commande

On peut aussi utiliser le validateur CSS comme un outil en ligne de commande, si Java est installé sur votre ordinateur. Construisez le fichier css-validator.jar comme expliqué précédemment, et exécutez de cette façon :
java -jar css-validator.jar http://www.w3.org/