Завантаження й встановлення сервісу перевірки CSS

Завантаження

Завантаження початкових файлів

Сервіс перевірки CSS є доступним для завантаження через CVS. Дотримуйтесь інструкцій для доступу до загальнодоступного серверу CVS й завантажте 2002/css-validator. Зверніть увагу: на jigsaw.w3.org/css-validator встановлено більш ранню версію, ніж ту, що зберігається у репозиторії CVS, через що результати виводу і зовнішній вигляд можуть незначно розрізнятись

Завантаження пакета Java (jar або war)

css-validator.jar

Посібник по встановленню

Сервіс є сервлетом Java, його може бути встановлено до будь-якого сервлет-контейнеру, а також викликано з командного рядку. Офіційний сервіс від W3C працює під керуванням сервера Jigsaw, що рекомендовано для встановлення локального сервісу. Однак, для спрощення, у цьому документі ми, головним чином, будемо розповідати, як встановити сервіс перевірки на Tomcat — контейнері сервлетів від Apache.

Нижче наведено низку інструкцій по встановленню сервлету на Jigsaw та запуску сервісу з командного рядку.

Вимоги для встановлення

Мається на увазі, що ви завантажили, встановили й перевірили:

робоче середовище Java;
засіб розробки Ant;
контейнер сервлетів — наприклад, Jigsaw, Tomcat або Jetty — якщо плануєте створити сітьовий сервіс; в цій інструкції докладно розповідається лише про Jigsaw та Tomcat.

Для встановлення сервісу у власній системі необхідно завантажити або знайти на своєму комп'ютері низку бібліотек Java:

servlet.jar (якщо Tomcat встановлено до [TOMCAT_DIR], то можна знайти цей файл у [TOMCAT_DIR]/common/lib/); можливо, він буде зватися «servlet-api.jar»; якщо його немає, завантажте з java.sun.com;
jigsaw.jar;
xercesImpl.jar і xml-apis.jar (можуть бути завантажені з xerces-j-bin);
tagsoup.jar.

Встановлення сервісу перевірки CSS на сервері Tomcat

Завантажте установлювальні файли, як написано вище.
Скопіюйте усю директорію .../css-validator/ до директорії webapps серверу Tomcat; звичайно це [TOMCAT_DIR]/webapps/. Програмний код сервісу перевірки тепер знаходиться у [TOMCAT_DIR]/webapps/css-validator, яку ми позначимо як [VALIDATOR_DIR].
У директорії [VALIDATOR_DIR] створіть піддиректорію WEB-INF, а у [VALIDATOR_DIR]/WEB-INF — піддиректорію lib:
mkdir -p WEB-INF/lib
Скопіюйте усі файли з розширенням jar, перераховані у вимогах для встановлення, до директорії [VALIDATOR_DIR]/WEB-INF/lib
Скомпілюйте програмний код: у [VALIDATOR_DIR] запустіть ant та переконайтеся, що завантажені jar-файли коректно прописані у змінній оточення CLASSPATH. У загальному випадку працює наступна конструкція:
CLASSPATH=.:./WEB-INF/lib:$CLASSPATH ant
Скопіюйте або перемістіть [VALIDATOR_DIR]/css-validator.jar до [VALIDATOR_DIR]/WEB-INF/lib/.
Скопіюйте або перемістіть файл web.xml з [VALIDATOR_DIR]/ до [VALIDATOR_DIR]/WEB-INF/.
Останній крок: перезапустіть Tomcat:
cd [TOMCAT_DIR]; ./bin/shutdown.sh; ./bin/startup.sh;

Встановлення на сервері Jigsaw

Як написано вище, завантажте програмний код і необхідні jar-файли; скомпілюйте вихідні файли за допомогою ant.
Настройте корньову директорію сервісу (звичайно «css-validator») для того, щоб він міг функціонувати як сервлет. Для цього встановіть Jigsaw (стислі інструкції дивиться на сторінках пілтримки Jigsaw — вони насправді не складні) та запустіть адміністрування серверу Jigsaw. Змініть HTTPFrame на ServletDirectoryFrame.
Створіть ресурс validator у якості класу ServletWrapper і фрейму ServletWrapperFrame; усе інше буде зроблено автоматично. Клас сервлету — org.w3c.css.servlet.CssValidator. Якщо вже існує файл validator, то перейменуйте його. Важливо, щоб цей alias завжди звався «validator».
Останній крок: запустіть Jigsaw та відкрийте у браузері сервіс перевірки. Звичайно URL виглядає як
http://localhost:8001/css-validator/validator.html

Використовування з командного рядку

Якщо на комп'ютері встановлено віртуальну машину Java, то сервіс перевірки CSS може також викликатися з командного рядку. Скомпілюйте css-validator.jar, як вказано вище, та запустіть наступним чином:
java -jar css-validator.jar http://www.w3.org/