-
Notifications
You must be signed in to change notification settings - Fork 108
/
about.html.en
293 lines (243 loc) · 12.8 KB
/
about.html.en
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
<!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>About the W3C CSS Validation Service</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$" />
</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 Validation Service</span></a></h1>
<p id="tagline">
Check Cascading Style Sheets (CSS) and (X)HTML documents with style sheets
</p>
</div>
<div class="doc">
<h2>About the CSS Validator</h2>
<h3 id="TableOfContents">Table of contents</h3>
<div id="toc">
<ol>
<li>About this Service
<ol>
<li><a href="#what">What is this? Do I need it?</a></li>
<li><a href="#help">The explanation above is incomprehensible! Help!</a></li>
<li><a href="#reference">So, this is the authority on what is correct CSS and what isn't?</a></li>
<li><a href="#validCSS">What does “Valid CSS” mean? Which version of CSS does this validator use?</a></li>
<li><a href="#free">How much does it cost?</a></li>
<li><a href="#who">Who wrote this tool? Who maintains it?</a></li>
<li><a href="#contact">How do I contact the authors? Report a bug?</a></li>
<li><a href="#participate">Can I help?</a></li>
</ol>
</li>
<li>Developers' corner
<ol>
<li><a href="#code">What is the CSS Validator written in? Is the source available somewhere?</a></li>
<li><a href="#install">Can I install and run the CSS Validator myself?</a></li>
<li><a href="#api">Can I build an application upon this validator? Is there an API?</a></li>
</ol>
</li>
</ol>
</div><!-- toc -->
<h3 id="about">About this Service</h3>
<h4 id="what">What is this? Do I need it?</h4>
<p>The W3C CSS Validation Service is a free software created by the W3C
to help Web designers and Web developers check Cascading Style Sheets (CSS).
It can be used on this <a href="./">free service</a> on the web, or downloaded
and used either as a java program, or as a java servlet on a Web server.</p>
<p>Do <em>you</em> need it? If you are a Web developer or a Web designer, this
tool will be an invaluable ally. Not only will it compare your style sheets to the
CSS specifications, helping you find errors, typos, or incorrect uses of CSS, it will
also tell you when your CSS poses some risks in terms of usability.</p>
<h4 id="help">The explanation above is incomprehensible! Help!</h4>
<p>Most documents on the Web are written in a computer language called HTML. This language
can be used to create pages with structured information, links, and multimedia objects. For
color, text, and layout, HTML uses a styling language called CSS, short for "Cascading Style Sheets".
What this tool does is help people authoring CSS check, and fix if necessary, their CSS Style Sheets.</p>
<h4 id="reference">So, this is the authority on what is correct CSS and what isn't?</h4>
<p>No. It is a helpful and reliable tool, but a software tool, and like every software, it has some
<a href="https://github.com/w3c/css-validator/issues">bugs and issues</a> (and <a href="http://www.w3.org/Bugs/Public/buglist.cgi?product=CSSValidator">legacy bugs</a>).
The actual reference on Cascading Style Sheets are the <a href="http://www.w3.org/Style/CSS/#specs">CSS
Specifications</a>.</p>
<h4 id="validCSS">What does “Valid CSS” mean? Which version of CSS does this validator use?</h4>
<p>According to the <a href="http://www.w3.org/TR/CSS21/conform.html#valid-style-sheet"
title="CSS 2.1 Specification – Conformance: requirements and recommendations">CSS 2.1 Specification</a>:
<q cite="http://www.w3.org/TR/CSS21/conform.html">The validity of a style sheet depends on the level of
CSS used for the style sheet. […] valid CSS 2.1 style sheet must be written according to the grammar of CSS 2.1.
Furthermore, it must contain only at-rules, property names, and property values defined in this specification.</q></p>
<p>By default, this validator checks style sheets against the grammar, properties and values defined in the
<a href="http://www.w3.org/TR/CSS21/"
title="Cascading Style Sheets Level 2 Revision 1 (CSS 2.1) Specification">CSS 2.1</a> specification,
but other CSS profiles can be checked against by using the options.</p>
<p>CSS is an evolving language, and it is considered by many that “CSS” is a single grammar
(the one defined in the latest specification) with a number of properties and acceptable
values defined in various profiles.In a future version of this validator, the default behavior may be to check
style sheets against that latest “CSS grammar” and the cloud of all standardized CSS properties and values.</p>
<h4 id="free">How much does it cost?</h4>
<p>Nothing. The service is free. The source is <a href="DOWNLOAD.html">open</a> and you are free
to download it, use it, modify it, distribute it,
and <a href="http://www.w3.org/Consortium/Legal/copyright-software">more</a>.
If you really like it, you are welcome to <a href="#participate">join the project</a> or donate to W3C via the
<a href="http://www.w3.org/Consortium/sup">W3C supporters program</a>, but nobody forces you to.</p>
<h4 id="who">Who wrote this tool? Who maintains it?</h4>
<p>W3C maintains and hosts the tool, thanks to the work and contributions by W3C staff,
volunteer developers and translators. See the <a href="thanks.html">credits and acknowledgments page</a>
for details. <a href="#participate">You too can help</a>.</p>
<h4 id="participate">Can I help?</h4>
<p>Of course. If you are a java programmer, you can help the CSS Validator project by
checking out the <a href="#code">code</a>,
adopting and fixing <a href="https://github.com/w3c/css-validator/issues">bugs</a> & <a href="http://www.w3.org/Bugs/Public/buglist.cgi?product=CSSValidator">legacy bugs</a>,
or helping build new features.</p>
<p>But you do not need to be a coder to help build and maintain this tool: you can also help improve the
documentation, participate in translating the validator in your language, or subscribe to the
<a href="http://lists.w3.org/Archives/Public/www-validator-css/">mailing-list</a> and discuss about the tool
or help other users.</p>
<h4 id="contact">Any other question?</h4>
<p>If you have any question regarding CSS or the CSS validator, check out the available
<a href="Email">mailing-lists and forums</a>. But before that, make sure that your question
or comment is not covered already by the <a href="http://www.websitedev.de/css/validator-faq">CSS Validator
<acronym title="Frequently Asked Questions">FAQ</acronym> document</a>.</p>
<h3 id="dev">Developers' corner</h3>
<h4 id="code">What is the CSS Validator written in? Is the source available somewhere?</h4>
<p>The W3C CSS validator is written using the java language, and yes, its source
is available, using Git: you can
<a href="https://github.com/w3c/css-validator">browse the code online</a>
or follow the instructions there to download the whole source tree. For a quick
overview of the classes used in the CSS Validator code, check out the
<a href="README.html">README</a> file.</p>
<h4 id="install">Can I install and run the CSS Validator myself?</h4>
<p>It is possible to download and install the CSS validator, and to run it either from the command line, or
as a servlet in a Web server. Read the <a href="RUN.html">instructions</a> for installation and use.</p>
<h4 id="api">Can I build an application upon this validator? Is there an API?</h4>
<p>Yes, and <a href="api.html">yes</a>. The CSS Validator has a (RESTful) <a href="api.html">SOAP interface</a>
which should make it reasonably easy to build applications (Web or otherwise) upon it. Good manners and
respectful usage of shared resources are of course customary: make sure your applications sleep() between
calls to the validator, or install and run your own instance of the validator.</p>
</div>
<ul class="navbar" id="menu">
<li><strong><a href="./" title="Home page for the W3C CSS Validation Service">Home</a></strong> <span class="hideme">|</span></li>
<li><a href="documentation.html" title="Documentation for the W3C CSS Validation Service">Documentation</a> <span class="hideme">|</span></li>
<li><a href="DOWNLOAD.html" title="Download the CSS validator">Download</a> <span class="hideme">|</span></li>
<li><a href="Email.html" title="How to provide feedback on this service">Feedback</a> <span class="hideme">|</span></li>
<li><a href="thanks.html" title="Credits and Acknowlegments">Credits</a><span class="hideme">|</span></li>
</ul>
<ul id="lang_choice">
<li><a href="about.html.bg"
lang="bg"
xml:lang="bg"
hreflang="bg"
rel="alternate">Български</a></li>
<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.ko"
lang="ko"
xml:lang="ko"
hreflang="ko"
rel="alternate">한국어</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-PL"
xml:lang="pl-PL"
hreflang="pl-PL"
rel="alternate">Polski</a>
</li>
<li><a href="about.html.pt-BR"
lang="pt-BR"
xml:lang="pt-BR"
hreflang="pt-BR"
rel="alternate">Português</a>
</li>
<li><a href="about.html.ru"
lang="ru"
xml:lang="ru"
hreflang="ru"
rel="alternate">Русский</a>
</li>
<li><a href="about.html.sv"
lang="sv"
xml:lang="sv"
hreflang="sv"
rel="alternate">Svenska</a>
</li>
<li><a href="about.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's Quality Assurance Activity, bringing you free Web quality tools and more"><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="Learn more about 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-2009
<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>