Завантаження й встановлення сервісу перевірки 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/