forked from w3c/css-validator
-
Notifications
You must be signed in to change notification settings - Fork 0
/
manual.html.ru
329 lines (264 loc) · 19.2 KB
/
manual.html.ru
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
<!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>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>Руководство пользователя сервиса проверки CSS</title>
<link rev="made" href="mailto:[email protected]" />
<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$" />
<!-- SSI Template Version: $Id$ -->
</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.bg"
lang="bg"
xml:lang="bg"
hreflang="bg"
rel="alternate">Български</a></li>
<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.ko"
lang="ko"
xml:lang="ko"
hreflang="ko"
rel="alternate">한국어</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-PL"
xml:lang="pl-PL"
hreflang="pl-PL"
rel="alternate">Polski</a>
</li>
<li><a href="manual.html.pt-BR"
lang="pt-BR"
xml:lang="pt-BR"
hreflang="pt-BR"
rel="alternate">Português</a>
</li>
<li><a href="manual.html.ru"
lang="ru"
xml:lang="ru"
hreflang="ru"
rel="alternate">Русский</a>
</li>
<li><a href="manual.html.sv"
lang="sv"
xml:lang="sv"
hreflang="sv"
rel="alternate">Svenska</a>
</li>
<li><a href="manual.html.zh-cn"
lang="zh-cn"
xml:lang="zh-cn"
hreflang="zh-cn"
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">
<a href="http://www.w3.org/QA/Tools/Donate">
<img src="http://www.w3.org/QA/Tools/I_heart_validator" alt="I heart Validator logo" title=" Validators Donation Program" />
</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.eu/"><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>