- From: Olivier Thereaux via cvs-syncmail <cvsmail@w3.org>
- Date: Mon, 07 Jul 2008 19:05:30 +0000
- To: www-validator-cvs@w3.org
Update of /sources/public/2002/css-validator
In directory hutz:/tmp/cvs-serv19958
Added Files:
DOWNLOAD.html.ru about.html.ru documentation.html.ru
manual.html.ru
Log Message:
new Russian translation, courtesy of Anatoly Vahramenko with help from Alexey Beshenov
--- NEW FILE: manual.html.ru ---
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ru" lang="ru">
<head>
<title>Руководство пользователя сервиса проверки CSS</title>
<link rev="made" href="mailto:www-validator-css@w3.org" />
<link rev="start" href="./" title="Home Page" />
<style type="text/css" media="all">
@import "style/base.css";
@import "style/docs.css";
</style>
<meta name="revision"
content="$Id: manual.html.ru,v 1.1 2008/07/07 19:05:27 ot Exp $" />
<!-- SSI Template Version: $Id: manual.html.ru,v 1.1 2008/07/07 19:05:27 ot Exp $ -->
</head>
<body>
<div id="banner">
<h1 id="title"><a href="http://www.w3.org/"><img alt="W3C" width="110" height="61" id="logo" src="./images/w3c.png" /></a>
<a href="./"><span>Сервис проверки CSS</span></a></h1>
<p id="tagline">
Проверка таблиц каскадных стилей (CSS) и документов (X)HTML с таблицами стилей
</p>
</div>
<div id="main">
<!-- This DIV encapsulates everything in this page - necessary for the positioning -->
<div class="doc">
<h2>Руководство пользователя сервиса проверки CSS</h2>
<h3 id="TableOfContents">Содержание</h3>
<div id="toc">
<ul>
<li><a href="#use">Как использовать сервис проверки CSS</a>
<ul>
<li><a href="#url">Проверка по URL</a></li>
<li><a href="#fileupload">Проверка загруженного файла</a></li>
<li><a href="#directinput">Проверка непосредственно введенного кода</a></li>
<li><a href="#basicvalidation">Что делает основная проверка?</a></li>
</ul>
</li>
<li><a href="#advanced">Расширенная проверка</a>
<ul>
<li><a href="#paramwarnings">Предупреждения</a></li>
<li><a href="#paramprofile">Настройка профиля</a></li>
<li><a href="#parammedium">Настройка носителя информации</a></li>
</ul>
</li>
<li><a href="#expert">Для специалистов</a>
<ul>
<li><a href="#requestformat">Формат запроса на проверку</a></li>
<li><a href="#api">API веб-сервиса проверки CSS</a></li>
</ul>
</li>
</ul>
</div>
<p id="skip"></p>
<h3 id="use">Как использовать сервис проверки CSS</h3>
<p>Самый простой способ проверки предоставляет основной интерфейс. На его странице вы найдете описание трех форм, соответствующих трем способам проверки:</p>
<h4 id="url">Проверка по URL</h4>
<p>Просто введите URL документа, который хотите проверить. Документ может в формате HTML или CSS.</p>
<img style="display: block; margin-left:auto; margin-right: auto;" src="./images/uri_basic.png" alt="Проверка по URL" />
<h4 id="fileupload">Проверка загруженного файла</h4>
<p>Этот способ позволяет вам загрузить файл на сервер и проверить его. Нажмите кнопку «Обзор...» и выберите файл, который вы хотите проверить.</p>
<img style="display: block; margin-left:auto; margin-right: auto;"
src="./images/file_upload_basic.png"
alt="Проверка загруженного файла" />
<p>В этом случае допускаются только документы CSS. То есть, вы не можете загрузить документы (X)HTML. Также следует учесть наличие директив @import, так как они будут обработаны, только если явно ссылаются на общедоступный ресурс (так что не используйте в этом варианте проверки относительные пути).</p>
<h4 id="directinput">Проверка непосредственно введенного кода</h4>
<p>Этот способ идеален для проверки части CSS-файла. Вам только необходимо код в текстовое поле.</p>
<img style="display: block; margin-left:auto; margin-right: auto;" src="./images/direct_input_basic.png" alt="Проверка непосредственно введенного кода" />
<p>Справедливы приведенные ранее замечания. Заметьте, что этот способ очень удобен, если требуется определенная помощь других людей. Также это удобно для отправки сообщения об ошибке, поскольку вы можете создать ссылаться на результаты проверки в качестве тестового примера.</p>
<h4 id="basicvalidation">Что делает основная проверка?</h4>
<p>При использовании упрощенного интерфейса, сервис проверит документы на соответствие <a href="http://www.w3.org/TR/CSS2">CSS 2</a> — текущей технической рекомендации для CSS.<br />
Он выдаст отчет в XHTML без каких-либо предупреждений (будет только информация об ошибках).<br />
Опция «среда» будет установлена в значение «all», что обозначает соответствие всем устройствам (смотрите <a href="http://www.w3.org/TR/CSS2/media.html">http://www.w3.org/TR/CSS2/media.html</a> для полного описания сред).</p>
<h3 id="advanced">Расширенная проверка</h3>
<p>Если нужна более конкретная проверка, можно использовать расширенный интерфейс, позволяющий указать три параметра. Далее приводится краткая справка по каждому из них.</p>
<h4 id="paramwarnings">Предупреждения</h4>
<p>Этот параметр полезен для настройки подробности отчетов сервиса проверки CSS. Действительно, сервис может выдавать два типа сообщений: ошибки и предупреждения. Ошибки выдаются, когда проверяемый CSS не соответствует рекомендации. Предупреждения отличаются от ошибок тем, что не относятся к проблемам выполнения спецификации. Они используются, чтобы предупредить (!) разработчика CSS, что некоторые аспекты могут быть опасны и странно обрабатываться пользовательскими приложениями.</p>
<p>Типичное предупреждение касается font-family: если вы не укажете базовый тип шрифта, вы получите предупреждение, говорящее о том, что вы должны добавить таковой в конец соответствующего правила CSS, иначе пользовательские приложения, не обладающие списком перечисленных в правиле шрифтов, переключатся на шрифт по умолчанию, что может исказить отображение информации.</p>
<h4 id="paramprofile">Профиль</h4>
<p>Сервис проверки может работать с различными профилями CSS. Профиль перечисляет все особенности и возможности реализации на конкретной платформе. Это определение взято с <a href="http://www.w3.org/Style/2004/css-charter-long.html#modules-and-profiles0">сайта CSS</a>. Выбор по умолчанию соответствует наиболее часто используемому, <a href="http://www.w3.org/TR/CSS2">CSS 2</a>.</p>
<h4 id="parammedium">Носитель</h4>
<p>Задание носителя соответствует правилу @media, применяющемуся ко всему документу. Вы можете найти больше информации о носителях по адресу <a href="http://www.w3.org/TR/CSS2/media.html">http://www.w3.org/TR/CSS2/media.html</a>.</p>
<h3 id="expert">Только для специалистов</h3>
<h4 id="requestformat">Формат запроса на проверку</h4>
<p>Ниже приведена таблица с параметрами, которые вы можете использовать для в запросах к сервису проверки CSS от W3C.</p>
<p>Если вы хотите использовать общий сервер проверки W3C, то используйте приведенные ниже параметры с основным URI<br />
<kbd>http://jigsaw.w3.org/css-validator/validator</kbd><br />
замените его адресом своего сервера, если вы хотите обратиться к собственной установке сервиса проверки.</p>
<p><strong>Примечание</strong>: если нужно программно вызывать сервис для множества документов, то убедитесь в, что ваши программы используют задержку <strong>минимум в 1 секунду</strong> между обращениями.
Сервис проверки предоставляется бесплатно для всех, поэтому будем признательны за уважительное отношение. Спасибо за понимание.</p>
<table class="refdoc">
<tbody>
<tr>
<th>Параметр</th>
<th>Описание</th>
<th>Значение по умолчанию</th>
</tr>
<tr>
<th>uri</th>
<td><acronym title="Universal Resource Locator">URL</acronym> документа для проверки. Документ может в формате HTML или CSS.</td>
<td>По умолчанию не установлен, однако для проверки документа должен быть указан либо этот параметр, либо <code>text</code>.</td>
</tr>
<tr>
<th>text</th>
<td>Документ для проверки; принимается только формат CSS.</td>
<td>По умолчанию не установлен, однако для проверки документа должен быть указан либо этот параметр, либо <code>uri</code>.</td>
</tr>
<tr>
<th>usermedium</th>
<td><a href="http://www.w3.org/TR/CSS2/media.html">Среда</a>, используемая для проверки; например. <code>screen</code>, <code>print</code>, <code>braille</code>...</td>
<td><code>all</code></td>
</tr>
<tr>
<th>output</th>
<td>Переключает различных форматов выдачи результата проверки. Возможные значения: <code>text/html</code> и <code>html</code> (документ XHTML, Content-Type: text/html), <code>application/xhtml+xml</code> и <code>xhtml</code> (документ XHTML, Content-Type: application/xhtml+xml), <code>application/soap+xml</code> и <code>soap12</code> (документ SOAP 1.2, Content-Type: application/soap+xml), <code>text/plain</code> и <code>text</code> (текстовый документ, Content-Type: text/plain), другие значения (документ XHTML document, Content-Type: text/html)</td>
<td>html</td>
</tr>
<tr>
<th>profile</th>
<td>Профиль CSS, используемый для проверки. Может принимать значения
<code>css1</code>, <code>css2</code>, <code>css21</code>,
<code>css3</code>, <code>svg</code>, <code>svgbasic</code>,
<code>svgtiny</code>, <code>mobile</code>, <code>atsc-tv</code>,
<code>tv</code> или <code>none</code></td>
<td>Последняя рекомендация W3C: CSS 2</td>
</tr>
<tr>
<th>lang</th>
<td>Язык отчета. В данный момент может принимать значения <code>en</code>, <code>fr</code>, <code>ja</code>, <code>es</code>, <code>zh-cn</code>, <code>nl</code>, <code>de</code>, <code>it</code>, <code>pl</code>.</td>
<td>Английский (<code>en</code>).</td>
</tr>
<tr>
<th>warning</th>
<td>Уровень сообщений о предупреждениях: <code>no</code> — для отключения предупреждений, <code>0</code> — для минимального количества предупреждений, <code>1</code> или <code>2</code> — для дальнейших уровней.</td>
<td>2</td>
</tr>
</tbody>
</table>
<h4 id="api">API веб-сервиса проверки CSS: документация для интерфейса SOAP 1.2 сервиса проверки</h4>
<p>Более подробную техническую справку, в частности, по выводу данных в SOAP 1.2, а также о всех возможных способах вызова сервиса проверки, смотрите <a href="./api.html">API веб-сервиса проверки CSS</a>.</p>
</div>
</div>
<!-- End of "main" DIV. -->
<ul class="navbar" id="menu">
<li><strong><a href="./" title="Главная страница сервиса W3C по проверке CSS">Главная страница</a></strong> <span class="hideme">|</span></li>
<li><a href="documentation.html" title="Документация по сервису W3C для проверки CSS">Документация</a> <span class="hideme">|</span></li>
<li><a href="DOWNLOAD.html" title="Скачивание приложения проверки CSS">Скачивание</a> <span class="hideme">|</span></li>
<li><a href="Email.html" title="Как оставить отзыв">Отзывы</a> <span class="hideme">|</span></li>
<li><a href="thanks.html" title="Создатели и участники">Создатели</a><span class="hideme">|</span></li>
</ul>
<ul id="lang_choice">
<li><a href="manual.html.de"
lang="de"
xml:lang="de"
hreflang="de"
rel="alternate">Deutsch</a></li>
<li><a href="manual.html.en"
lang="en"
xml:lang="en"
hreflang="en"
rel="alternate">English</a> </li>
<li><a href="manual.html.es"
lang="es" xml:lang="es" hreflang="es"
rel="alternate">Español</a></li>
<li><a href="manual.html.fr"
lang="fr"
xml:lang="fr"
hreflang="fr"
rel="alternate">Français</a> </li>
<li><a href="manual.html.it"
lang="it"
xml:lang="it"
hreflang="it"
rel="alternate">Italiano</a> </li>
<li><a href="manual.html.nl"
lang="nl"
xml:lang="nl"
hreflang="nl"
rel="alternate">Nederlands</a> </li>
<li><a href="manual.html.ja"
lang="ja"
xml:lang="ja"
hreflang="ja"
rel="alternate">日本語</a> </li>
<li><a href="manual.html.pl-PL"
lang="pl"
xml:lang="pl"
hreflang="pl"
rel="alternate">Polski</a> </li>
<li><a href="manual.html.zh-cn"
lang="zh-hans"
xml:lang="zh-hans"
hreflang="zh-hans"
rel="alternate">中文</a></li>
</ul>
<div id="footer">
<p id="activity_logos">
<a href="http://www.w3.org/QA/" title="Сообщество контроля качества в W3C, распространяющее бесплатные утилиты"><img src="http://www.w3.org/QA/2002/12/qa-small.png" alt="Сообщество контроля качества" /></a><a href="http://www.w3.org/Style/CSS/learning" title="Изучите больше о Cascading Style Sheets"><img src="images/woolly-icon" alt="CSS" /></a>
</p>
<p id="support_logo">Поддержите проект — внесите пожертвования.<br />
<a href="http://www.w3.org/Consortium/supporters"><img src="http://www.w3.org/Consortium/supporter-logos/csupporter.png" alt="Люди, поддерживающие W3C" /></a>
</p>
<p class="copyright">
<a rel="Copyright" href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 1994-2007
<a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a>®
(<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>,
<a href="http://www.ercim.org/"><acronym title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>,
<a href="http://www.keio.ac.jp/">Keio</a>),
All Rights Reserved.
W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
<a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a>,
<a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a>
and <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-software">software licensing</a>
rules apply. Your interactions with this site are in accordance
with our <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Public">public</a> and
<a href="http://www.w3.org/Consortium/Legal/privacy-statement#Members">Member</a> privacy
statements.
</p>
</div>
</body>
</html>
--- NEW FILE: about.html.ru ---
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ru" lang="ru">
<head>
<title>О сервисе W3C для проверки CSS</title>
<link rev="made" href="mailto:www-validator-css@w3.org" />
<link rev="start" href="./" title="Home Page" />
<style type="text/css" media="all">
@import "style/base.css";
@import "style/docs.css";
</style>
<meta name="revision" content="$Id: about.html.ru,v 1.1 2008/07/07 19:05:27 ot Exp $" />
</head>
<body>
<div id="banner">
<h1 id="title"><a href="http://www.w3.org/"><img alt="W3C" width="110" height="61" id="logo" src="./images/w3c.png" /></a>
<a href="./"><span>Сервис проверки CSS</span></a></h1>
<p id="tagline">
Проверка таблиц каскадных стилей (CSS) и документов (X)HTML с таблицами стилей
</p>
</div>
<div class="doc">
<h2>О сервисе проверки CSS</h2>
<h3 id="TableOfContents">Содержание</h3>
<div id="toc">
<ol>
<li>О сервисе
<ol>
<li><a href="#what">Что это? Зачем это мне?</a></li>
<li><a href="#help">Описание выше слишком путанное! Объясните!</a></li>
<li><a href="#reference">Это официальная проверка на корректность CSS?</a></li>
<li><a href="#free">Сколько это стоит?</a></li>
<li><a href="#who">Кто написал это приложение? Кто его поддерживает?</a></li>
<li><a href="#contact">Как мне связаться с авторами? Сообщить об ошибке?</a></li>
<li><a href="#participate">Могу ли я помочь?</a></li>
</ol>
</li>
<li>Уголок разработчика
<ol>
<li><a href="#code">На чем написан сервис проверки CSS? Доступны ли исходники?</a></li>
<li><a href="#install">Могу ли я установить и запустить сервис проверки сам?</a></li>
<li><a href="#api">Могу ли я построить приложение с использованием данного сервиса? Есть ли API?</a></li>
</ol>
</li>
</ol>
</div><!-- toc -->
<h3 id="about">О сервисе</h3>
<h4 id="what">Что это? Зачем это мне?</h4>
<p>Сервис проверки CSS — бесплатное приложение, созданное организацией W3C для помощи веб-дизайнерам и веб-разработчикам в проверке каскадных таблиц стилей (CSS). Он может быть использован как <a href="./">бесплатный сервис</a> в сети или загружен для запуска на веб-сервере в качестве Java-приложения или сервлета.</p>
<p>Зачем это <em>вам</em>? Если вы веб-разработчик или веб-дизайнер, то этот сервис может стать бесценным помощником: он не только сравнивает таблицы стилей со спецификациями и помогает обнаружить ошибки, опечатки, неправильное использование CSS, но и сообщает о риске возникновения проблем с доступностью контента.</p>
<h4 id="help">Описание выше слишком путанное! Объясните!</h4>
<p>Большинство документов в сети написаны на компьютерном языке HTML. Он может быть использован для создания страниц со структурированной информацией, ссылками, мультимедийными объектами. Для цветов, шрифтов и верстки HTML использует язык описания стилей CSS («Cascade Style Sheets», «каскадные таблицы стилей»). Этот сервис позволяет людям проверить написанные ими таблицы стилей и, если потребуется, внести в них изменения.</p>
<h4 id="reference">Это официальная проверка на корректность CSS?</h4>
<p>Нет. Это надежная и полезная утилита, но это всего лишь программа, и, как у любого программного обеспечения, у нее есть <a href="http://www.w3.org/Bugs/Public/buglist.cgi?product=CSSValidator">ошибки и проблемы</a>. Актуальный справочник по таблицам каскадных стилей есть в их <a href="http://www.w3.org/Style/CSS/#specs">спецификации</a>.</p>
<h4 id="free">Сколько это стоит?</h4>
<p>Нисколько, это бесплатный сервис. Исходный код <a href="DOWNLOAD.html">открыт</a>, и вы можете свободно загрузить его, использовать, модифицировать, распространять — <a href="http://www.w3.org/Consortium/Legal/copyright-software">делать с ним что угодно</a>.
Если этот сервис нравится вам, то вы можете <a href="#participate">присоединиться к проект</a> или добровольно спонсировать W3C через <a href="http://www.w3.org/Consortium/sup">программу поддержки</a>, но никто не заставляет вас это делать.</p>
<h4 id="who">Кто написал это приложение? Кто его поддерживает?</h4>
<p>Данный сервис размещается и обслуживается на сервере W3C, благодаря вкладу и работе членов W3C, добровольных разработчиков и переводчиков. Для подробной информации смотрите страницу <a href="thanks.html">создателей и участников</a>. Вы также можете <a href="#participate">внести свой вклад</a>.</p>
<h4 id="participate">Могу ли я помочь?</h4>
<p>Конечно. Если вы программируете на Java, то можете помочь проекту, проверяя, улучшая, <a href="http://www.w3.org/Bugs/Public/buglist.cgi?product=CSSValidator">исправляя</a> исходный <a href="#code">код</a>, либо добавляя новые функции.</p>
<p>Для помощи в разработке и поддержке вам не обязательно быть программистом — вы можете помочь улучшить документацию, перевести интерфейс на свой язык или подписаться на <a href="http://lists.w3.org/Archives/Public/www-validator-css/">лист рассылки</a> для обсуждения сервиса и помощи другим пользователям.</p>
<h4 id="contact">Есть еще вопросы?</h4>
<p>Если у вас возникли вопросы по CSS или сервису проверки CSS, задайте их в доступных
<a href="Email">рассылках и форумах</a>. Но перед этим убедитесь, что ответа нет в <a href="http://www.websitedev.de/css/validator-faq">FAQ сервиса проверки CSS</a>.</p>
<h3 id="dev">Уголок разработчика</h3>
<h4 id="code">На чем написан сервис проверки CSS? Доступны ли исходники?</h4>
<p>Сервис W3C для проверки CSS написан на Java; исходный код открыт и доступен через CVS. Вы можете
<a href="http://dev.w3.org/cvsweb/2002/css-validator/">посмотреть код в сети</a>, либо скачать его в соответствии с инструкциями. Для быстрого ознакомления с используемыми классами, ознакомьтесь с файлом <a href="README.html">README</a>.</p>
<h4 id="install">Могу ли я сам установить и запустить сервис проверки?</h4>
<p>Да, можете скачать и установить сервис проверки и запустить его, либо из командной строки, либо как сервлет. Ознакомьтесь с <a href="RUN.html">инструкциями</a> по установке и запуску.</p>
<h4 id="api">Могу ли я построить приложение с использованием данного сервиса? Есть ли API?</h4>
<p>Да, и еще раз <a href="api.html">да</a>. Сервис проверки обладает <a href="api.html">интерфейсом SOAP</a> (RESTful), с помощью которого достаточно легко использовать его в приложениях (веб- или любых других). Если вы пользуетесь доступом к общему ресурсу, то учтите правила сетевого этикета: убедитесь, что приложение вызывает функцию sleep() между вызовами сервиса, либо установите свою копию.</p>
</div>
<ul class="navbar" id="menu">
<li><strong><a href="./" title="Главная страница сервиса W3C по проверке CSS">Главная страница</a></strong> <span class="hideme">|</span></li>
<li><a href="documentation.html" title="Документация по сервису W3C для проверки CSS">Документация</a> <span class="hideme">|</span></li>
<li><a href="DOWNLOAD.html" title="Скачивание приложения проверки CSS">Скачивание</a> <span class="hideme">|</span></li>
<li><a href="Email.html" title="Как оставить отзыв">Отзывы</a> <span class="hideme">|</span></li>
<li><a href="thanks.html" title="Создатели и участники">Создатели</a><span class="hideme">|</span></li>
</ul>
<ul id="lang_choice">
<li><a href="about.html.de"
lang="de"
xml:lang="de"
hreflang="de"
rel="alternate">Deutsch</a></li>
<li><a href="about.html.en"
lang="en"
xml:lang="en"
hreflang="en"
rel="alternate">English</a> </li>
<li><a href="about.html.es"
lang="es" xml:lang="es" hreflang="es"
rel="alternate">Español</a></li>
<li><a href="about.html.fr"
lang="fr"
xml:lang="fr"
hreflang="fr"
rel="alternate">Français</a> </li>
<li><a href="about.html.it"
lang="it"
xml:lang="it"
hreflang="it"
rel="alternate">Italiano</a> </li>
<li><a href="about.html.nl"
lang="nl"
xml:lang="nl"
hreflang="nl"
rel="alternate">Nederlands</a> </li>
<li><a href="about.html.ja"
lang="ja"
xml:lang="ja"
hreflang="ja"
rel="alternate">日本語</a> </li>
<li><a href="about.html.pl-PL"
lang="pl"
xml:lang="pl"
hreflang="pl"
rel="alternate">Polski</a> </li>
<li><a href="about.html.zh-cn"
lang="zh-hans"
xml:lang="zh-hans"
hreflang="zh-hans"
rel="alternate">中文</a></li>
</ul>
<div id="footer">
<p id="activity_logos">
<a href="http://www.w3.org/QA/" title="Сообщество контроля качества в W3C, распространяющее бесплатные утилиты"><img src="http://www.w3.org/QA/2002/12/qa-small.png" alt="Сообщество контроля качества" /></a><a href="http://www.w3.org/Style/CSS/learning" title="Изучите больше о Cascading Style Sheets"><img src="images/woolly-icon" alt="CSS" /></a>
</p>
<p id="support_logo">Поддержите проект — внесите пожертвования.<br />
<a href="http://www.w3.org/Consortium/supporters"><img src="http://www.w3.org/Consortium/supporter-logos/csupporter.png" alt="Люди, поддерживающие W3C" /></a>
</p>
<p class="copyright">
<a rel="Copyright" href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 1994-2007
<a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a>®
(<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>,
<a href="http://www.ercim.org/"><acronym title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>,
<a href="http://www.keio.ac.jp/">Keio</a>),
All Rights Reserved.
W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
<a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a>,
<a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a>
and <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-software">software licensing</a>
rules apply. Your interactions with this site are in accordance
with our <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Public">public</a> and
<a href="http://www.w3.org/Consortium/Legal/privacy-statement#Members">Member</a> privacy
statements.
</p>
</div>
</body>
</html>
--- NEW FILE: documentation.html.ru ---
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ru" lang="ru">
<head>
<title>Документация для сервиса W3C проверки CSS</title>
<link rev="made" href="mailto:www-validator-css@w3.org" />
<link rev="start" href="./" title="Home Page" />
<style type="text/css" media="all">
@import "style/base.css";
@import "style/docs.css";
</style>
<meta name="revision" content="$Id: documentation.html.ru,v 1.1 2008/07/07 19:05:27 ot Exp $" />
<!-- SSI Template Version: $Id: documentation.html.ru,v 1.1 2008/07/07 19:05:27 ot Exp $ -->
</head>
<body>
<div id="banner">
<h1 id="title"><a href="http://www.w3.org/"><img alt="W3C" width="110" height="61" id="logo" src="./images/w3c.png" /></a>
<a href="./"><span>Сервис проверки CSS</span></a></h1>
<p id="tagline">
Проверка таблиц каскадных стилей (CSS) и документов (X)HTML с таблицами стилей
</p>
</div>
<div id="main">
<!-- This DIV encapsulates everything in this page - necessary for the positioning -->
<div class="doc">
<h2>Документация для сервиса проверки CSS</h2>
<p id="skip"></p>
<h3 id="use">Для пользователя</h3>
<dl>
<dt><a href="./manual.html">Руководство пользователя</a></dt>
<dd>— документация по использованию сервиса проверки CSS.</dd>
<dt><a href="about.html">О сервисе</a></dt>
<dd>— информация о сервисе проверки CSS и ответы на общие вопросы.</dd>
<dt><a href="http://www.websitedev.de/css/validator-faq">FAQ</a></dt>
<dd>— ответы на часто задаваемые технические вопросы.</dd>
</dl>
<h3 id="devel">Для разработчика</h3>
<dl>
<dt><a href="DOWNLOAD.html">Загрузка и установка</a></dt>
<dd>— информация о загрузке исходного кода и запуске сервиса проверки из командной строки или в качестве сервлета.</dd>
<dt><a href="README">Введение для разработчиков</a></dt>
<dd>— обзор кода сервиса проверки CSS.</dd>
<dt><a href="./api.html">API веб-сервиса</a></dt>
<dd>— документация по интерфейсу взаимодействия через SOAP 1.2.</dd>
<dt><a href="http://www.w3.org/Bugs/Public/buglist.cgi?bug_status=__open__;product=CSSValidator">Ошибки</a></dt>
<dd>— известные ошибки и проблемы работы текущей версии сервиса, форма для сообщения о новых ошибках и проблемах. Также смотрите <a href="Email.html">инструкции по составлению отзывов</a>.</dd>
</dl>
</div>
</div>
<!-- End of "main" DIV. -->
<ul class="navbar" id="menu">
<li><strong><a href="./" title="Главная страница сервиса W3C по проверке CSS">Главная страница</a></strong> <span class="hideme">|</span></li>
<li><a href="documentation.html" title="Документация по сервису W3C для проверки CSS">Документация</a> <span class="hideme">|</span></li>
<li><a href="DOWNLOAD.html" title="Скачивание приложения проверки CSS">Скачивание</a> <span class="hideme">|</span></li>
<li><a href="Email.html" title="Как оставить отзыв">Отзывы</a> <span class="hideme">|</span></li>
<li><a href="thanks.html" title="Создатели и участники">Создатели</a><span class="hideme">|</span></li>
</ul>
<ul id="lang_choice">
<li><a href="documentation.html.de"
lang="de"
xml:lang="de"
hreflang="de"
rel="alternate">Deutsch</a></li>
<li><a href="documentation.html.en"
lang="en"
xml:lang="en"
hreflang="en"
rel="alternate">English</a> </li>
<li><a href="documentation.html.es"
lang="es" xml:lang="es" hreflang="es"
rel="alternate">Español</a></li>
<li><a href="documentation.html.fr"
lang="fr"
xml:lang="fr"
hreflang="fr"
rel="alternate">Français</a> </li>
<li><a href="documentation.html.it"
lang="it"
xml:lang="it"
hreflang="it"
rel="alternate">Italiano</a> </li>
<li><a href="documentation.html.nl"
lang="nl"
xml:lang="nl"
hreflang="nl"
rel="alternate">Nederlands</a> </li>
<li><a href="documentation.html.ja"
lang="ja"
xml:lang="ja"
hreflang="ja"
rel="alternate">日本語</a> </li>
<li><a href="documentation.html.pl-PL"
lang="pl"
xml:lang="pl"
hreflang="pl"
rel="alternate">Polski</a> </li>
<li><a href="documentation.html.zh-cn"
lang="zh-hans"
xml:lang="zh-hans"
hreflang="zh-hans"
rel="alternate">中文</a></li>
</ul>
<div id="footer">
<p id="activity_logos">
<a href="http://www.w3.org/QA/" title="Сообщество контроля качества в W3C, распространяющее бесплатные утилиты"><img src="http://www.w3.org/QA/2002/12/qa-small.png" alt="Сообщество контроля качества" /></a><a href="http://www.w3.org/Style/CSS/learning" title="Изучите больше о Cascading Style Sheets"><img src="images/woolly-icon" alt="CSS" /></a>
</p>
<p id="support_logo">Поддержите проект — внесите пожертвования.<br />
<a href="http://www.w3.org/Consortium/supporters"><img src="http://www.w3.org/Consortium/supporter-logos/csupporter.png" alt="Люди, поддерживающие W3C" /></a>
</p>
<p class="copyright">
<a rel="Copyright" href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 1994-2007
<a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a>®
(<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>,
<a href="http://www.ercim.org/"><acronym title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>,
<a href="http://www.keio.ac.jp/">Keio</a>),
All Rights Reserved.
W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
<a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a>,
<a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a>
and <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-software">software licensing</a>
rules apply. Your interactions with this site are in accordance
with our <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Public">public</a> and
<a href="http://www.w3.org/Consortium/Legal/privacy-statement#Members">Member</a> privacy
statements.
</p>
</div>
</body>
</html>
--- NEW FILE: DOWNLOAD.html.ru ---
<?xml version="1.0" encoding="utf-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="ru" lang="ru">
<head>
<title>Загрузка и установка сервиса проверки CSS</title>
<link rev="made" href="mailto:www-validator-css@w3.org" />
<link rev="start" href="./" title="Home Page" />
<style type="text/css" media="all">
@import "style/base.css";
@import "style/docs.css";
</style>
<meta name="revision"
content="$Id: DOWNLOAD.html.ru,v 1.1 2008/07/07 19:05:27 ot Exp $" />
<!-- SSI Template Version: $Id: DOWNLOAD.html.ru,v 1.1 2008/07/07 19:05:27 ot Exp $ -->
</head>
<body>
<div id="banner">
<h1 id="title"><a href="http://www.w3.org/"><img alt="W3C" width="110" height="61" id="logo" src="./images/w3c.png" /></a>
<a href="./"><span>Сервис проверки CSS</span></a></h1>
<p id="tagline">
Проверка таблиц каскадных стилей (CSS) и документов (X)HTML с таблицами стилей
</p>
</div>
<div class="doc">
<h2>Загрузка и установка сервиса проверки CSS</h2>
<h3 id="download">Загрузка</h3>
<h4 id="source">Загрузка исходных файлов</h4>
<p><a href="http://dev.w3.org/cvsweb/2002/css-validator">Сервис проверки CSS</a> доступен для загрузки через CVS. Следуйте <a href="http://dev.w3.org/cvsweb/">инструкциям для доступа к общедоступному серверу CVS</a> и загрузите 2002/css-validator. Заметьте, что на jigsaw.w3.org/css-validator установлена более ранняя версия, нежели та, что хранится в репозитории CVS, так что результаты вывода и внешний вид могут незначительно различаться</p>
<h4>Загрузка пакета Java (jar или war)</h4>
<!-- <p>TBD... we just need a stable location to put jar/war archives on a regular basis</p>-->
<p><a href="http://www.w3.org/QA/Tools/css-validator/css-validator.jar">css-validator.jar</a></p>
<h3>Руководство по установке</h3>
<p>Сервис является сервлетом Java, он может быть установлен в любой сервлет-контейнер, а также может быть вызван из командной строки. Официальный сервис от W3C работает под управлением сервера Jigsaw, который и рекомендуется для установки локального сервиса. Однако, для простоты, в этом документе мы в основном будем рассказывать, как установить сервис проверки на Tomcat — контейнере сервлетов от Apache.</p>
<p>Ниже приводится ряд инструкций по установке сервлета на Jigsaw и запуску сервиса из командной строки.</p>
<h4 id="prereq">Требования для установки</h4>
<p>Подразумевается, что вы загрузили, установили и проверили:</p>
<ul class="instructions">
<li>рабочую среду Java;</li>
<li>средство разработки <a href="http://ant.apache.org/">Ant</a>;</li>
<li>контейнер сервлетов — например, <a href="http://www.w3.org/Jigsaw/">Jigsaw</a>, <a href="http://tomcat.apache.org/">Tomcat</a> или <a href="http://www.mortbay.org/">Jetty</a> — если планируете создать сетевой сервис; в этой инструкции подробно рассказывается только про Jigsaw и Tomcat.</li>
</ul>
<p id="prereq-libs">Для установки сервиса в своей системе необходимо загрузить или найти у себя на компьютере ряд библиотек Java:</p>
<ul class="instructions">
<li>servlet.jar (если Tomcat установлен в [<span class="const">TOMCAT_DIR</span>], то можете найти этот файл в [<span class="const">TOMCAT_DIR</span>]/common/lib/); возможно, он будет называться «servlet-api.jar»; если его нет, загрузите с <a href="http://java.sun.com/products/servlet/download.html">java.sun.com</a>;</li>
<li><a href="http://jigsaw.w3.org/Devel/classes-2.2/20060329/">jigsaw.jar</a>;</li>
<li>xercesImpl.jar и xml-apis.jar (могут быть загружены с <a href="http://www.apache.org/dist/xml/xerces-j/">xerces-j-bin</a>);</li>
<li><a href="http://ccil.org/~cowan/XML/tagsoup/">tagsoup.jar</a>.</li>
</ul>
<h4>Установка сервиса проверки CSS на сервере Tomcat</h4>
<ol class="instructions">
<li>Загрузите установочные файлы, как описано <a href="#source">выше</a>.</li>
<li>Скопируйте всю директорию <span class="dir">.../css-validator/</span> в директорию <span class="dir">webapps</span> сервера Tomcat; обычно это <span class="dir">[<span class="const">TOMCAT_DIR</span>]/webapps/</span>. Исходный код сервиса проверки теперь находится в <span class="dir">[<span class="const">TOMCAT_DIR</span>]/webapps/css-validator</span>, которую мы обозначим как <span class="dir">[<span class="const">VALIDATOR_DIR</span>]</span>.</li>
<li>В директории <span class="dir">[<span class="const">VALIDATOR_DIR</span>]</span> создайте поддиректорию <span class="dir">WEB-INF</span>, а в <span class="dir">[<span class="const">VALIDATOR_DIR</span>]/WEB-INF</span> — поддиректорию <span class="dir">lib</span>:<br /><kbd>mkdir -p WEB-INF/lib</kbd></li>
<li>Скопируйте все файлы с расширением jar, перечисленные в <a href="#prereq-libs">требованиях для установки</a>, в директорию <span class="dir">[<span class="const">VALIDATOR_DIR</span>]/WEB-INF/lib</span></li>
<li>Скомпилируйте исходный код: в <span class="dir">[<span class="const">VALIDATOR_DIR</span>]</span> запустите <kbd>ant</kbd> и убедитесь, что загруженные jar-файлы корректно прописаны в переменной окружения CLASSPATH. В общем случае работает следующая конструкция:<br /><kbd>CLASSPATH=.:./WEB-INF/lib:$CLASSPATH ant</kbd></li>
<li>Скопируйте или переместите <span class="dir">[<span class="const">VALIDATOR_DIR</span>]/</span><span class="file">css-validator.jar</span> в <span class="dir">[<span class="const">VALIDATOR_DIR</span>]/WEB-INF/lib/</span>.</li>
<li>Скопируйте или переместите файл <span class="file">web.xml</span> из <span class="dir">[<span class="const">VALIDATOR_DIR</span>]/</span> в <span class="dir">[<span class="const">VALIDATOR_DIR</span>]/WEB-INF/</span>.
</li>
<li>Последний шаг: перезапустите Tomcat:<br /><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></li>
</ol>
<h4>Установка на сервере Jigsaw</h4>
<ol class="instructions">
<li>Как описано выше, загрузите исходный код и необходимые jar-файлы; скомпилируйте исходники при помощи <kbd>ant</kbd>.</li>
<li>Настройте корневую директорию сервиса (обычно «css-validator») для того, чтобы он мог работать как сервлет. Для этого установите Jigsaw (краткие инструкции смотрите на страницах поддержки Jigsaw — они действительно не сложные) и запустите администрирование сервера Jigsaw. Измените HTTPFrame на ServletDirectoryFrame.</li>
<li>Создайте ресурс validator в качестве класса ServletWrapper и фрейма ServletWrapperFrame; всё остальное будет сделано автоматически. Класс сервлета — org.w3c.css.servlet.CssValidator. Если уже существует файл validator, то переименуйте его. Важно, чтобы этот alias всегда назывался «validator».</li>
<li>Последний шаг: запустите Jigsaw и откройте в браузере сервис проверки. Обычно URL выглядит как<br />http://localhost:8001/css-validator/validator.html</li>
</ol>
<h3>Использование из командной строки</h3>
<p>Если на компьютере установлена виртуальная машина Java, то сервис проверки CSS может также вызываться из командной строки. Скомпилируйте css-validator.jar, как указано выше, и запустите следующим образом:<br />
<kbd>java -jar css-validator.jar http://www.w3.org/</kbd></p>
</div>
<ul class="navbar" id="menu">
<li><strong><a href="./" title="Главная страница сервиса W3C по проверке CSS">Главная страница</a></strong> <span class="hideme">|</span></li>
<li><a href="documentation.html" title="Документация по сервису W3C для проверки CSS">Документация</a> <span class="hideme">|</span></li>
<li><a href="DOWNLOAD.html" title="Скачивание приложения проверки CSS">Скачивание</a> <span class="hideme">|</span></li>
<li><a href="Email.html" title="Как оставить отзыв">Отзывы</a> <span class="hideme">|</span></li>
<li><a href="thanks.html" title="Создатели и участники">Создатели</a><span class="hideme">|</span></li>
</ul>
<ul id="lang_choice">
<li><a href="DOWNLOAD.html.de"
lang="de"
xml:lang="de"
hreflang="de"
rel="alternate">Deutsch</a></li>
<li><a href="DOWNLOAD.html.en"
lang="en"
xml:lang="en"
hreflang="en"
rel="alternate">English</a> </li>
<li><a href="DOWNLOAD.html.es"
lang="es" xml:lang="es" hreflang="es"
rel="alternate">Español</a></li>
<li><a href="DOWNLOAD.html.fr"
lang="fr"
xml:lang="fr"
hreflang="fr"
rel="alternate">Français</a> </li>
<li><a href="DOWNLOAD.html.it"
lang="it"
xml:lang="it"
hreflang="it"
rel="alternate">Italiano</a> </li>
<li><a href="DOWNLOAD.html.nl"
lang="nl"
xml:lang="nl"
hreflang="nl"
rel="alternate">Nederlands</a> </li>
<li><a href="DOWNLOAD.html.ja"
lang="ja"
xml:lang="ja"
hreflang="ja"
rel="alternate">日本語</a> </li>
<li><a href="DOWNLOAD.html.pl-PL"
lang="pl"
xml:lang="pl"
hreflang="pl"
rel="alternate">Polski</a> </li>
<li><a href="DOWNLOAD.html.zh-cn"
lang="zh-hans"
xml:lang="zh-hans"
hreflang="zh-hans"
rel="alternate">中文</a></li>
</ul>
<div id="footer">
<p id="activity_logos">
<a href="http://www.w3.org/QA/" title="Сообщество контроля качества W3C, распространяющее бесплатные утилиты"><img src="http://www.w3.org/QA/2002/12/qa-small.png" alt="Сообщество контроля качества" /></a><a href="http://www.w3.org/Style/CSS/learning" title="Узнайте больше о CSS"><img src="images/woolly-icon" alt="CSS" /></a>
</p>
<p id="support_logo">Поддержите проект — внесите пожертвования.<br />
<a href="http://www.w3.org/Consortium/supporters"><img src="http://www.w3.org/Consortium/supporter-logos/csupporter.png" alt="Люди, поддерживающие W3C" /></a>
</p>
<p class="copyright">
<a rel="Copyright" href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 1994-2007
<a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a>®
(<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>,
<a href="http://www.ercim.org/"><acronym title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>,
<a href="http://www.keio.ac.jp/">Keio</a>),
All Rights Reserved.
W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
<a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a>,
<a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a>
and <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-software">software licensing</a>
rules apply. Your interactions with this site are in accordance
with our <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Public">public</a> and
<a href="http://www.w3.org/Consortium/Legal/privacy-statement#Members">Member</a> privacy
statements.
</p>
</div>
</body>
</html>
Received on Monday, 7 July 2008 19:06:05 UTC