-
Notifications
You must be signed in to change notification settings - Fork 108
/
manual.html.ko
385 lines (332 loc) · 15.9 KB
/
manual.html.ko
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
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
<!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="en" lang="en">
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
<title>W3C 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)와 스타일시트를 포함한 문서를 검사
</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">CSS 검사 웹 서비스 API</a></li>
</ul>
</li>
</ul>
</div>
<p id="skip"></p>
<h3 id="use">CSS 검사 서비스를 이용하는 방법</h3>
<p>
가장 쉽게 검사하는 방법은 기본 인터페이스를 사용하는 방법입니다. 이 페이지에서는 3가지 기능을 갖고 있는 3가지 양식을 볼 수 있습니다:
</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_ko.png" alt="URL을 이용하여 검사" />
<h4 id="fileupload">파일 업로드를 통한 검사</h4>
<p>
이 기능은 컴퓨터에 있는 파일을 업로드하여 검사를 할 수 있도록 합니다. 파일 선택 버튼을 누른 다음, 검사를 원하는 파일을 선택하면 됩니다.
</p>
<img style="display: block; margin-left:auto; margin-right: auto;"
src="./images/file_upload_basic_ko.png"
alt="파일 업로드를 통한 검사" />
<p>
이 경우, CSS 문서만 가능합니다. 즉, (X)HTML 문서를 업로드할 경우 작동하지 않습니다. 또한, @import등의
규칙을 사용하였을 경우 공개된 URL일 경우에만 정상적인 검사가 가능하기 때문에 주의하여야 합니다. (즉, 이 방식을 이용할
경우 상대 경로를 이용하는 것은 불가능합니다.)
</p>
<h4 id="directinput">직접 입력 검사</h4>
<p>
이 방식은 CSS 문서의 일부분만 검사할 경우에 적합합니다. 텍스트 박스에 검사 대상 CSS를 적어 넣으면 됩니다.
</p>
<img style="display: block; margin-left:auto; margin-right: auto;"
src="./images/direct_input_basic_ko.png"
alt="직접 입력 검사" />
<p>
위와 같이 불가능한 조건이 있으므로 주의하여야 합니다. 이 기능은 온라인 상에서 누군가의 도움을 요청할 경우에도 URL만
제공하여도 되기 때문에 유용하게 사용할 수 있습니다. 또한, 이 기능은 버그를 제보할 때에도 유용하게 사용될 수 있는데,
이 때 검사 결과 URL만 제공하면 테스트 케이스로도 사용이 가능합니다.
</p>
<h4 id="basicvalidation">기본 검사에서는 무엇을 하나요?</h4>
<p>
기본 검사를 수행할 경우, 검사 서비스에서는 현재 CSS 기술에 있어서 권장되고 있고, 검증된 규약인
<a href="http://www.w3.org/TR/CSS2">CSS 2</a>에 대한 유효성 검사를 수행하게 됩니다.<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>
만일 보다 자세한 검사가 필요할 경우, 3가지 항목을 추가적으로 설정할 수 있는 고급 검사 인터페이스를 사용할 수 있습니다.
아래 내용은 그 3가지 항목을 사용하기 위한 간략한 도움말입니다.
</p>
<h4 id="paramwarnings">경고 속성</h4>
<p>
이 속성은 CSS 검사 결과을 얼마나 구체적으로 표현할 것인지 설정하는 값입니다. 검사 결과에서는 경고와 오류 두 가지
메시지를 표시할 수 있습니다. 오류는 검사된 CSS가 CSS의 권장 사항을 준수하지 않았을 경우에 표시됩니다. 하지만
경고는 CSS 규약에 명시된 사항을 위배한 것에 대한 문제점을 제기하지 않다는 점에서 다릅니다. 경고의 경우 CSS 작성자가
위험할 수 있는 몇 가지 경우와 특정 브라우저에서 이상 현상을 발생시킬 수 있는 경우를 알리기 위해서 표시됩니다.
</p>
<p>
일반적으로 많이 볼 수 있는 오류로는 font-family를 예로 들 수 있습니다: 만일 일반적인 서체를 마지막 대안으로
제시하지 않을 경우, 브라우저에서 다른 서체를 식별하지 못할 경우 기본 폰트로 바뀌게 되어 결과물이 이상해질 수 있으므로,
명시된 내용의 뒤에 일반적인 서체를 (serif, sans-serif) 추가를 해야 한다는 경고가 출력 될 것입니다.
</p>
<h4 id="paramprofile">프로파일 속성</h4>
<p>
CSS 검사 서비스에서는 서로 다른 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 검사 서비스에 대한 질의를 보낼 경우 사용될 수 있는 매개변수의 목록입니다.</p>
<p>만일 W3C의 공개 검사 서버를 사용하려면, <kbd>http://jigsaw.w3.org/css-validator/validator</kbd>의 URL을
상대로 아래에 있는 매개변수들을 이용하면 됩니다. 만일 자체적인 서비스에 사용을 할 경우에는 위 주소를 서비스를 제공하고 있는 자체 서버의 주소로
변경하면 됩니다.</p>
<p><strong>주의</strong>: 만일 프로그램을 이용하여 여러개의 문서를 체계적으로 검사를 할 경우, 스크립트 또는 프로그램이
요청을 수행하는데에 있어서 <strong>최소한 1초의</strong> 간격을 둘 수 있도록 하여 주시기 바랍니다. CSS 검사
서비스는 누구나 사용할 수 있는 무료 서비스인 만큼, 여러분의 협조가 필요합니다. 감사합니다.</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>입니다. CSS와 HTML 문서가 가능합니다.</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><code>screen</code>,
<code>print</code>, <code>braille</code>과 같은 검사 대상 <a href="http://www.w3.org/TR/CSS2/media.html">매체</a>입니다.</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 문서, Content-Type: text/html)
</td>
<td>html</td>
</tr>
<tr>
<th>profile</th>
<td>검사할 대상 프로파일입니다. 다음 중 한가지가 가능합니다.
<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">CSS 검사 웹 서비스 API: SOAP 1.2 검사 인터페이스 기술 문서</h4>
<p>
SOAP 1.2 출력에 대한 내용과 검사 기능을 이용할 수 있는 보다 자세한 방법과 기술적인 내용은
<a href="./api.html">CSS Validator Web Service API (영문)</a>을 참조하시기 바랍니다.
</p>
</div>
</div>
<!-- End of "main" DIV. -->
<ul class="navbar" id="menu">
<li><a href="./" title="W3C CSS 검사 서비스 홈페이지">홈</a> <span class="hideme">|</span></li>
<li><a href="about.html" title="이 서비스에 대하여">정보</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="QA" /></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">
<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>