# CSS Validation Service

Check Cascading Style Sheets (CSS) and (X)HTML documents with style sheets

## CSS验证器的用户手册

### 目录

### 如何使用CSS验证器

使用验证器来验证一个CSS文档最简单的方法就是用基本界面。这里你会发现3种不同的页面，对应有3种不同的界面：

#### 通过URL的Response来验证

只需要指定一个你需要验证的文档的URL就可以验证该文档这个文档可以是HTML或者CSS文件

#### 通过上传文件来验证

这个方法允许你上传然后验证你上传的文件。点击“浏览...”按钮，然后选择一个你的机器上的要进行验证的文件就可以进行验证

这种情况下，只允许使用CSS文档，也就是说，你不能上传HTML格式的文件。你还需要注意的一点是@import属性。只有当他们是一个明确的公开的URL的时候才会被验证(也就是说，不要使用相对路径)。

#### 通过直接输入的内容来验证

这个方法目的是为了测试一段CSS的代码。你只需要在文本输入框中输入你的CSS代码就可以了。

和上一种方法一样需要注意只能使用CSS的代码并且只能使用绝对的URL路径。这种方法在你的某一段CSS代码有问题希望得到解决的时候非常有用，也非常方便。在报告某个bug的时候也很简单，因为你可以将验证结果的URL给我们。

#### 基本验证都作了什么工作？

当使用基本界面的时候，验证器会和CSS2的标准(目前最新的标准)进行比较，
你会看到一个XHTML格式的Error输出(不会包括警告)。
媒介会设定到使用所有的设备媒介(对于媒介的描述请参考 http://www.w3.org/TR/CSS2/media.html)。

### 高级验证

如果你需要一个更精确的验证，你可以使用高级验证界面，在高级验证界面中你可以设定三个参数，下面是对每个参数的简单说明。

#### Warnings

这个参数对控制CSS验证器的输出很有用。事实上，验证器能给出两种消息：错误和警告。错误是当被检查的CSS不符合CSS标准的要求的时候产生的，警告和错误不同，它不是说和标准不符合的问题，它们只是用来警告CSS的开发人员，某些CSS代码在不同的客户端上可能会有导致奇怪动作的危险。

一个典型的警告就是使用了font-family的时候：如果你不是提供一个通用字体，你将会得到一个警告，告诉你应该在最后添加一个通用字体，否则某个客户端上可能不能识别你所设定的字体，从而转为该客户端的默认字体。而这样可能会导致一个很奇怪的显示内容。

#### 配置

CSS验证器可以检查不同的CSS配置。所谓的配置列出了一系列某一个特定平台上的的特性。配置本身的定义可以参考 CSS站点 。默认的选择就是当前最常用的 CSS 2.1标准.

#### 媒介

这个参数就等同于@media规则，适用于所有的文档。你可以在 http://www.w3.org/TR/CSS2/media.html 找到更多的关于媒介的资料。

### 写给专家的话

#### 验证请求的URL格式

下面是某个发送给W3C的CSS验证服务器的URL请求中的参数列表

如果你想使用W3C的公开验证服务器，使用下面的参数，连接在下面基本URI之后来组织一个URL：
`http://jigsaw.w3.org/css-validator/validator`
(将地址替换成你自己的服务器地址也可以)。

注意: 如果你想这样在程序中调用验证器来验证一批文档，那么请一定在你的程序中设定每两次验证之间间隔 至少1秒。CSS验证服务是给所有人免费的服务，大家会感谢你对公共资源的尊重。

参数 | 说明 | 默认值
--- | --- | ---
uri | 等待被验证的文档的URL 。CSS或者HTML都可以 | 没有。但是这个参数和下面的`text`参数，至少有一个不为空。
text | 被验证的CSS代码片断，只允许CSS代码 | 没有。但是这个参数和上面的`uri`参数，至少有一个不为空。
usermedium | 指定用于被验证的媒介(medium)，例如`screen`, `print`, `braille`... | `all`

output

设定验证器输出结果的格式。可能的格式有： `text/html` and `html` (XHTML document, Content-Type: text/html), `application/xhtml+xml` and `xhtml` (XHTML document, Content-Type: application/xhtml+xml), `application/soap+xml` and `soap12` (SOAP 1.2 document, Content-Type: application/soap+xml), `text/plain` and `text` (text document, Content-Type: text/plain), everything else (XHTML document, Content-Type: text/plain)

html

profile | 设定用于验证比较的标准CSS配置文件。可以是 `css1`, `css2`, `css21`, `css3`, `svg`, `svgbasic`, `svgtiny`, `mobile`, `atsc-tv`, `tv` or `none` | 最新的W3C标准： CSS 2
lang | 输出结果的语言，目前支持`en`, `fr`, `it`, `ko`, `ja`, `es`, `zh-cn`, `nl`, `de`. | English (`en`).
warning | 警告的级别：`no` 表示没有警告， `0` 精简的警告信息, `1`或者 `2` 详细警告信息 | 2

#### CSS验证器的Web Service API: SOAP 1.2 验证接口文档

更多的技术帮助，特别是SOAP1.2的输出，以及所有可能调用验证的方法，请参考 CSS 验证器 Web Service API.

- Български
- Deutsch
- English
- Español
- Français
- 한국어
- Italiano
- Nederlands
- 日本語
- Polski
- Português
- Русский
- Svenska
- 简体中文