Annotation of 2002/css-validator/manual.html.ru, revision 1.1

1.1     ! 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="ru" lang="ru">
        !             5: <head>
        !             6:   <title>Руководство пользователя сервиса проверки CSS</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 "style/base.css";    
        !            11:     @import "style/docs.css";
        !            12:   </style>
        !            13:   <meta name="revision"
        !            14:   content="$Id: manual.html.en,v 1.8 2007/11/13 06:31:37 ot Exp $" />
        !            15:   <!-- SSI Template Version: $Id: manual.html.en,v 1.8 2007/11/13 06:31:37 ot Exp $ -->
        !            16: </head>
        !            17: 
        !            18: <body>
        !            19:     <div id="banner">
        !            20:      <h1 id="title"><a href="http://www.w3.org/"><img alt="W3C" width="110" height="61" id="logo" src="./images/w3c.png" /></a>
        !            21:      <a href="./"><span>Сервис проверки CSS</span></a></h1>
        !            22:      <p id="tagline">
        !            23:        Проверка таблиц каскадных стилей (CSS) и документов (X)HTML с таблицами стилей
        !            24:      </p>
        !            25:     </div>
        !            26: 
        !            27: <div id="main">
        !            28: <!-- This DIV encapsulates everything in this page - necessary for the positioning -->
        !            29: 
        !            30: <div class="doc">
        !            31: <h2>Руководство пользователя сервиса проверки CSS</h2>
        !            32: 
        !            33: <h3 id="TableOfContents">Содержание</h3>
        !            34: 
        !            35: <div id="toc">
        !            36: <ul>
        !            37:   <li><a href="#use">Как использовать сервис проверки CSS</a>
        !            38:     <ul>
        !            39:       <li><a href="#url">Проверка по URL</a></li>
        !            40:       <li><a href="#fileupload">Проверка загруженного файла</a></li>
        !            41:       <li><a href="#directinput">Проверка непосредственно введенного кода</a></li>
        !            42:       <li><a href="#basicvalidation">Что делает основная проверка?</a></li>
        !            43:     </ul>
        !            44:   </li>
        !            45:   <li><a href="#advanced">Расширенная проверка</a>
        !            46:     <ul>
        !            47:        <li><a href="#paramwarnings">Предупреждения</a></li>
        !            48:        <li><a href="#paramprofile">Настройка профиля</a></li>
        !            49:        <li><a href="#parammedium">Настройка носителя информации</a></li>
        !            50:     </ul>
        !            51:   </li>
        !            52:   <li><a href="#expert">Для специалистов</a>
        !            53:     <ul>
        !            54:        <li><a href="#requestformat">Формат запроса на проверку</a></li>
        !            55:        <li><a href="#api">API веб-сервиса проверки CSS</a></li>
        !            56:     </ul>
        !            57:    </li>
        !            58: </ul>
        !            59: </div>
        !            60: 
        !            61: <p id="skip"></p>
        !            62: 
        !            63: <h3 id="use">Как использовать сервис проверки CSS</h3>
        !            64: 
        !            65: <p>Самый простой способ проверки предоставляет основной интерфейс. На его странице вы найдете описание трех форм, соответствующих трем способам проверки:</p>
        !            66: 
        !            67: <h4 id="url">Проверка по URL</h4>
        !            68: <p>Просто введите URL документа, который хотите проверить. Документ может в формате HTML или CSS.</p>
        !            69: <img style="display: block; margin-left:auto; margin-right: auto;" src="./images/uri_basic.png" alt="Проверка по URL" />
        !            70: 
        !            71: <h4 id="fileupload">Проверка загруженного файла</h4>
        !            72: <p>Этот способ позволяет вам загрузить файл на сервер и проверить его. Нажмите кнопку «Обзор...» и выберите файл, который вы хотите проверить.</p>
        !            73: <img style="display: block; margin-left:auto; margin-right: auto;" 
        !            74:     src="./images/file_upload_basic.png" 
        !            75:     alt="Проверка загруженного файла" />
        !            76: 
        !            77: <p>В этом случае допускаются только документы CSS. То есть, вы не можете загрузить документы (X)HTML. Также следует учесть наличие директив @import, так как они будут обработаны, только если явно ссылаются на общедоступный ресурс (так что не используйте в этом варианте проверки относительные пути).</p>
        !            78: 
        !            79: <h4 id="directinput">Проверка непосредственно введенного кода</h4>
        !            80: 
        !            81: <p>Этот способ идеален для проверки части CSS-файла. Вам только необходимо код в текстовое поле.</p>
        !            82: <img style="display: block; margin-left:auto; margin-right: auto;" src="./images/direct_input_basic.png" alt="Проверка непосредственно введенного кода" />
        !            83: 
        !            84: <p>Справедливы приведенные ранее замечания. Заметьте, что этот способ очень удобен, если требуется определенная помощь других людей. Также это удобно для отправки сообщения об ошибке, поскольку вы можете создать ссылаться на результаты проверки в качестве тестового примера.</p>
        !            85: 
        !            86: <h4 id="basicvalidation">Что делает основная проверка?</h4>
        !            87: 
        !            88: <p>При использовании упрощенного интерфейса, сервис проверит документы на соответствие <a href="http://www.w3.org/TR/CSS2">CSS&#x00a0;2</a>&#x00a0;— текущей технической рекомендации для CSS.<br />
        !            89: Он выдаст отчет в XHTML без каких-либо предупреждений (будет только информация об ошибках).<br />
        !            90: Опция «среда» будет установлена в значение «all», что обозначает соответствие всем устройствам (смотрите <a href="http://www.w3.org/TR/CSS2/media.html">http://www.w3.org/TR/CSS2/media.html</a> для полного описания сред).</p>
        !            91: 
        !            92: <h3 id="advanced">Расширенная проверка</h3>
        !            93: 
        !            94: <p>Если нужна более конкретная проверка, можно использовать расширенный интерфейс, позволяющий указать три параметра. Далее приводится краткая справка по каждому из них.</p>
        !            95: 
        !            96: <h4 id="paramwarnings">Предупреждения</h4>
        !            97: 
        !            98: <p>Этот параметр полезен для настройки подробности отчетов сервиса проверки CSS. Действительно, сервис может выдавать два типа сообщений: ошибки и предупреждения. Ошибки выдаются, когда проверяемый CSS не соответствует рекомендации. Предупреждения отличаются от ошибок тем, что не относятся к проблемам выполнения спецификации. Они используются, чтобы предупредить (!) разработчика CSS, что некоторые аспекты могут быть опасны и странно обрабатываться пользовательскими приложениями.</p>
        !            99: 
        !           100: <p>Типичное предупреждение касается font-family: если вы не укажете базовый тип шрифта, вы получите предупреждение, говорящее о том, что вы должны добавить таковой в конец соответствующего правила CSS, иначе пользовательские приложения, не обладающие списком перечисленных в правиле шрифтов, переключатся на шрифт по умолчанию, что может исказить отображение информации.</p>
        !           101: 
        !           102: <h4 id="paramprofile">Профиль</h4>
        !           103: 
        !           104: <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&#x00a0;2</a>.</p>
        !           105: 
        !           106: <h4 id="parammedium">Носитель</h4>
        !           107: 
        !           108: <p>Задание носителя соответствует правилу @media, применяющемуся ко всему документу. Вы можете найти больше информации о носителях по адресу <a href="http://www.w3.org/TR/CSS2/media.html">http://www.w3.org/TR/CSS2/media.html</a>.</p>
        !           109: 
        !           110: <h3 id="expert">Только для специалистов</h3>
        !           111: 
        !           112: <h4 id="requestformat">Формат запроса на проверку</h4>
        !           113: <p>Ниже приведена таблица с параметрами, которые вы можете использовать для в запросах к сервису проверки CSS от W3C.</p>
        !           114: 
        !           115: <p>Если вы хотите использовать общий сервер проверки W3C, то используйте приведенные ниже параметры с основным URI<br />
        !           116: <kbd>http://jigsaw.w3.org/css-validator/validator</kbd><br />
        !           117: замените его адресом своего сервера, если вы хотите обратиться к собственной установке сервиса проверки.</p>
        !           118: 
        !           119: <p><strong>Примечание</strong>: если нужно программно вызывать сервис для множества документов, то убедитесь в, что ваши программы используют задержку <strong>минимум в 1 секунду</strong> между обращениями.
        !           120: Сервис проверки предоставляется бесплатно для всех, поэтому будем признательны за уважительное отношение. Спасибо за понимание.</p>
        !           121: 
        !           122: <table class="refdoc">
        !           123:   <tbody>
        !           124:     <tr>
        !           125:       <th>Параметр</th>
        !           126:       <th>Описание</th>
        !           127:       <th>Значение по умолчанию</th>
        !           128:     </tr>
        !           129:     <tr>
        !           130:       <th>uri</th>
        !           131:       <td><acronym title="Universal Resource Locator">URL</acronym> документа для проверки. Документ может в формате HTML или CSS.</td>
        !           132:       <td>По умолчанию не установлен, однако для проверки документа должен быть указан либо этот параметр, либо <code>text</code>.</td>
        !           133:     </tr>
        !           134:     <tr>
        !           135:       <th>text</th>
        !           136:       <td>Документ для проверки; принимается только формат CSS.</td>
        !           137:       <td>По умолчанию не установлен, однако для проверки документа должен быть указан либо этот параметр, либо <code>uri</code>.</td>
        !           138:     </tr>
        !           139:     <tr>
        !           140:       <th>usermedium</th>
        !           141:       <td><a href="http://www.w3.org/TR/CSS2/media.html">Среда</a>, используемая для проверки; например. <code>screen</code>, <code>print</code>, <code>braille</code>...</td>
        !           142:       <td><code>all</code></td>
        !           143:     </tr>
        !           144:     <tr>
        !           145:       <th>output</th>
        !           146:       <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>
        !           147:       <td>html</td>
        !           148:     </tr>
        !           149:     <tr>
        !           150:       <th>profile</th>
        !           151:       <td>Профиль CSS, используемый для проверки. Может принимать значения
        !           152:         <code>css1</code>, <code>css2</code>, <code>css21</code>,
        !           153:         <code>css3</code>, <code>svg</code>, <code>svgbasic</code>,
        !           154:         <code>svgtiny</code>, <code>mobile</code>, <code>atsc-tv</code>,
        !           155:         <code>tv</code> или <code>none</code></td>
        !           156:       <td>Последняя рекомендация W3C: CSS&#x00a0;2</td>
        !           157:     </tr>
        !           158:     <tr>
        !           159:       <th>lang</th>
        !           160:       <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>
        !           161:       <td>Английский (<code>en</code>).</td>
        !           162:     </tr>
        !           163:     <tr>
        !           164:       <th>warning</th>
        !           165:       <td>Уровень сообщений о предупреждениях: <code>no</code>&#x00a0;— для отключения предупреждений, <code>0</code>&#x00a0;— для минимального количества предупреждений, <code>1</code> или <code>2</code>&#x00a0;— для дальнейших уровней.</td>
        !           166:       <td>2</td>
        !           167:     </tr>
        !           168:   </tbody>
        !           169: </table>
        !           170: 
        !           171: <h4 id="api">API веб-сервиса проверки CSS: документация для интерфейса SOAP&#x00a0;1.2 сервиса проверки</h4>
        !           172: 
        !           173: <p>Более подробную техническую справку, в частности, по выводу данных в SOAP&#x00a0;1.2, а также о всех возможных способах вызова сервиса проверки, смотрите <a href="./api.html">API веб-сервиса проверки CSS</a>.</p>
        !           174: 
        !           175: </div>
        !           176: </div>
        !           177: <!-- End of "main" DIV. -->
        !           178: 
        !           179:    <ul class="navbar"  id="menu">
        !           180:        <li><strong><a href="./" title="Главная страница сервиса W3C по проверке CSS">Главная страница</a></strong> <span class="hideme">|</span></li>
        !           181:         <li><a href="documentation.html" title="Документация по сервису W3C для проверки CSS">Документация</a> <span class="hideme">|</span></li>
        !           182:         <li><a href="DOWNLOAD.html" title="Скачивание приложения проверки CSS">Скачивание</a> <span class="hideme">|</span></li>
        !           183:         <li><a href="Email.html" title="Как оставить отзыв">Отзывы</a> <span class="hideme">|</span></li>
        !           184:         <li><a href="thanks.html" title="Создатели и участники">Создатели</a><span class="hideme">|</span></li>
        !           185: 
        !           186:       </ul>
        !           187: 
        !           188:       <ul id="lang_choice">
        !           189:            <li><a href="manual.html.de"
        !           190:                lang="de"
        !           191:                xml:lang="de"
        !           192:                hreflang="de"
        !           193:                rel="alternate">Deutsch</a></li>
        !           194:            <li><a href="manual.html.en"
        !           195:                lang="en"
        !           196:                xml:lang="en"
        !           197:            hreflang="en"
        !           198:            rel="alternate">English</a>  </li>
        !           199:            <li><a href="manual.html.es"
        !           200:            lang="es" xml:lang="es" hreflang="es"
        !           201:            rel="alternate">Español</a></li>
        !           202:            <li><a href="manual.html.fr"
        !           203:            lang="fr"
        !           204:            xml:lang="fr"
        !           205:            hreflang="fr"
        !           206:            rel="alternate">Français</a> </li>
        !           207:            <li><a href="manual.html.it"
        !           208:                lang="it"
        !           209:                xml:lang="it"
        !           210:                hreflang="it"
        !           211:                rel="alternate">Italiano</a> </li>
        !           212:            <li><a href="manual.html.nl"
        !           213:                lang="nl"
        !           214:                xml:lang="nl"
        !           215:                hreflang="nl"
        !           216:                rel="alternate">Nederlands</a> </li>
        !           217:            <li><a href="manual.html.ja"
        !           218:                lang="ja"
        !           219:                xml:lang="ja"
        !           220:                hreflang="ja"
        !           221:                rel="alternate">日本語</a> </li>
        !           222:            <li><a href="manual.html.pl-PL"
        !           223:                lang="pl"
        !           224:                xml:lang="pl"
        !           225:                hreflang="pl"
        !           226:                rel="alternate">Polski</a> </li>
        !           227:            <li><a href="manual.html.zh-cn"
        !           228:                lang="zh-hans"
        !           229:                xml:lang="zh-hans"
        !           230:                hreflang="zh-hans"
        !           231:                rel="alternate">中文</a></li>
        !           232:       </ul>
        !           233: 
        !           234: 
        !           235:    <div id="footer">
        !           236:    <p id="activity_logos">
        !           237: 
        !           238:       <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>
        !           239:    </p>
        !           240: 
        !           241:    <p id="support_logo">Поддержите проект&#x00a0;— внесите пожертвования.<br />
        !           242: <a href="http://www.w3.org/Consortium/supporters"><img src="http://www.w3.org/Consortium/supporter-logos/csupporter.png" alt="Люди, поддерживающие W3C" /></a>
        !           243:    </p>
        !           244: 
        !           245:     <p class="copyright">
        !           246:       <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> &copy; 1994-2007
        !           247:       <a href="http://www.w3.org/"><acronym title="World Wide Web Consortium">W3C</acronym></a>&reg;
        !           248: 
        !           249:       (<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>,
        !           250:       <a href="http://www.ercim.org/"><acronym title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>,
        !           251:       <a href="http://www.keio.ac.jp/">Keio</a>),
        !           252:       All Rights Reserved.
        !           253:       W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
        !           254:       <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a>,
        !           255:       <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a>
        !           256:       and <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-software">software licensing</a>
        !           257: 
        !           258:       rules apply. Your interactions with this site are in accordance
        !           259:       with our <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Public">public</a> and
        !           260:       <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Members">Member</a> privacy
        !           261:       statements.
        !           262:     </p>
        !           263: 
        !           264: </div>
        !           265:   </body>
        !           266: </html>
        !           267: 
        !           268: 
        !           269: 

Webmaster