Annotation of 2002/css-validator/manual.html.pt-BR, revision 1.7
1.1 ot 1: <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
2: "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
3: <html xmlns="http://www.w3.org/1999/xhtml" xml:lang="pt-br" lang="pt-br">
4: <head>
1.6 ot 5: <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
1.1 ot 6: <title>CSS Validator User Manual</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"
1.7 ! ot 14: content="$Id: manual.html.pt-BR,v 1.6 2009/02/04 18:41:57 ot Exp $" />
! 15: <!-- SSI Template Version: $Id: manual.html.pt-BR,v 1.6 2009/02/04 18:41:57 ot Exp $ -->
1.1 ot 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>Serviço de validação CSS</span></a></h1>
22: <p id="tagline">
23: Verifica folhas de estilo em cascata (CSS) e documentos (X)HTML com folhas de estilo</p>
24: </div>
25:
26: <div id="main">
27: <!-- This DIV encapsulates everything in this page - necessary for the positioning -->
28:
29: <div class="doc">
30:
31: <h2>Manual do usuário para o validador CSS</h2>
32:
33: <h3 id="TableOfContents">Índice</h3>
34:
35: <div id="toc">
36: <ul>
37: <li><a href="#use">Como usar o validador CSS</a>
38: <ul>
39: <li><a href="#url">Validação por entrada de URL</a></li>
40: <li><a href="#fileupload">Validação por upload de arquivo</a></li>
41: <li><a href="#directinput">Validação por entrada direta</a></li>
42: <li><a href="#basicvalidation">O que é validação básica?</a></li>
43: </ul>
44: </li>
45: <li><a href="#advanced">Validação avançada </a>
46: <ul>
47: <li><a href="#paramwarnings">Alertas</a></li>
48: <li><a href="#paramprofile">Perfil</a></li>
49: <li><a href="#parammedium">Mídias</a></li>
50: </ul>
51: </li>
52: <li><a href="#expert">Para especialistas </a>
53: <ul>
54: <li><a href="#requestformat">Formato para requisição de validação</a></li>
55: <li><a href="#api">API do serviço web de validação </a></li>
56: </ul>
57: </li>
58: </ul>
59: </div>
60:
61: <p id="skip"></p>
62:
63: <h3 id="use">Como usar o validador CSS</h3>
64:
65: <p>
66: A maneira mais simples de verificar um documento é pelo uso da interface básica do validador. Nesse manual descrevemos as três maneiras possíveis de validação:</p>
67:
68: <h4 id="url">Validação por entrada da URL</h4>
69: <p>
70: Digite, no campo de texto da interface do validador, o endereço URL do documento que você deseja verificar. O documento pode ser um arquivo HTML ou CSS.</p>
71: <img style="display: block; margin-left:auto; margin-right: auto;"
72: src="./images/uri_basic.png" alt="Formulário para validação por URI" />
73:
74: <h4 id="fileupload">Validação por upload de arquivo</h4>
75: <p>
76: Esta solução permite validar um arquivo local. Clique no botão
77: "Arquivo..." e selecione o arquivo a verificar.</p>
78: <img style="display: block; margin-left:auto; margin-right: auto;"
79: src="./images/file_upload_basic.png"
80: alt="Formulário para validação por upload de arquivo" />
81: <p>
82: Nesse caso, somente documentos CSS poderão ser submetidos à validação. Isso significa que não é permitido fazer upload de documentos (X)HTML. Você deve tomar precaução extra com relação a folha de estilo servida com a diretiva
83: @import, pois o validador será capaz de localizá-la somente se ela for declarada em um endereço URL público (assim, não use caminhos relativos quando optar por essa maneira de validação)</p>
84:
85: <h4 id="directinput">Validação por entrada direta</h4>
86: <p>
87: Esta maneira de verificação é ideal para submeter ao validador fragmentos de folhas de estilo. Basta escrever as regras CSS no campo área de texto do validador.</p>
88: <img style="display: block; margin-left:auto; margin-right: auto;"
89: src="./images/direct_input_basic.png"
90: alt="Formulário para validação por entrada direta" />
91: <p>
92: Aplicam-se aqui os mesmos comentários das soluções anteriores. Notar que esta solução é bastante conveniente para pedir ajuda à comunidade na solução de problemas ou reportar um bug, uma vez que você pode indicar a URL do resultado da validação para as pessoas vizualizarem o problema. </p>
93:
94: <h4 id="basicvalidation">O que é validação básica?</h4>
95:
96: <p>
97: Ao usar a interface básica do validador, o documento é verificado para conformidade com as <a href="http://www.w3.org/TR/CSS2">CSS 2</a>, que é a recomendação corrente para as CSS. <br />
98: O relatório de resultados do validador é uma página XHTML mostrando somente os erros CSS (não há relatório de alertas).<br />
99: A mídia é configurada para "todas", ou seja, o validador considera que a folha de estilo é servida para todos os dispositivos de usuário
100: (para uma descrição completa de tipos de mídia ver <a href="http://www.w3.org/TR/CSS2/media.html">
101: http://www.w3.org/TR/CSS2/media.html</a>).</p>
102:
103: <h3 id="advanced">Validação avançada </h3>
104:
105: <p>
106: Caso você queira uma verificação específica, use a interface avançada do validador que permite escolher três parâmetros de validação. A seguir uma descrição sumária de cada um desses parâmetros.</p>
107:
108: <h4 id="paramwarnings">Alertas</h4>
109:
110: <p>
111: Esse parâmetro habilita o validador a verificar a existência de pontos da folha de estilo que embora não sejam erros merecem ser analisados pelo desenvolvedor quanto a possíveis conseqüências não desejadas ou previstas. O validador pode retornar os resultados da verificação em dois tipos de mensagens: erros e
112: alertas.
113: Mensagens de erros são relacionadas a pontos das CSS que não estão em conformidade com as especificações. Alertas são diferentes de erros pois dizem respeito a problemas que não contrariam as especificações. Alertas são relatados com a finalidade de chamar a atenção (!) do desenvolvedor para pontos das CSS potencialmente perigosos no sentido de causar comportamento inesperado em determinados agentes de usuário.</p>
114: <p>
115: Um alerta típico diz respeito à propriedade font-family: caso você não defina uma fonte genérica o validador retorna um alerta dizendo que deverá ser definida uma fonte genérica como última opção de valor para essa propriedade, pois, caso contrário, um agente de usuário que não tenha instalado as fontes que você especificou adotará uma fonte padrão interna que poderá causar renderização imprópria.</p>
116:
117: <h4 id="paramprofile">Perfil</h4>
118:
119: <p>
120: O validador CSS permite verificação para diferentes perfis. Um perfil é constituido de uma lista de funcionalidades próprias de uma determinada implementação e que se espera serem funcionais em uma plataforma específica. Esta definição consta do
121: <a href="http://www.w3.org/Style/2004/css-charter-long.html#modules-and-profiles0">
122: site CSS</a>. O perfil padrão corresponde à especificação corrente e mais usada:
123: <a href="http://www.w3.org/TR/CSS2">CSS 2</a>.</p>
124:
125: <h4 id="parammedium">Mídia</h4>
126:
127: <p>
128: O parâmetro mídia é equivalente à diretiva @media aplicada ao documento. Você encontra mais informações sobre mídia em
129: <a href="http://www.w3.org/TR/CSS2/media.html">
130: http://www.w3.org/TR/CSS2/media.html </a>.</p>
131:
132: <h3 id="expert">Para especialistas </h3>
133:
134: <h4 id="requestformat">Formato para requisição de validação</h4>
135: <p>A seguir apresentamos uma tabela com os parâmetros a serem usados para enviar uma requisição ao validador
136: CSS do W3C.</p>
137:
138: <p>Para usar o servidor público do W3C para o serviço de validação adote os parâmetros a seguir em conjunto com a seguinte URI base:<br />
139: <kbd>http://jigsaw.w3.org/css-validator/validator</kbd><br />
140: caso esteja usando uma instância própria do validador, use o endereço base do seu servidor.</p>
141:
142: <p><strong>Nota</strong>: Se você deseja automatizar o uso do validador com auxílio de um programa para validação por lotes de documentos, programe seu script para pausar (<code>sleep) </code>por um <strong>tempo mínimo de 1 second</strong> entre cada requisição de validação.
143: O serviço de validação CSS é gratuito e aberto a todos, usá-lo respeitando as regras será por nós muito apreciado. Grato.</p>
144:
145: <table class="refdoc">
146: <tbody>
147: <tr>
148: <th>Parâmetro</th>
149: <th>Descrição</th>
150: <th>Valor padrão </th>
151: </tr>
152: <tr>
153: <th>uri</th>
154: <td>Ae <acronym title="Universal Resource Locator">URL</acronym> do documento a validar. São permitidos documentos CSS e HTML.</td>
155: <td>Não há, mas esse parâmetro ou o parâmetro <code>text</code> deve ser fornecido.</td>
156: </tr>
157: <tr>
158: <th>text</th>
159: <td>O documento a validar, somente CSS é permitida.</td>
160: <td>Não há, mas esse parâmetro ou o parâmetro <code>uri</code> deve ser fornecido</td>
161: </tr>
162: <tr>
163: <th>usermedium</th>
164: <td>A <a href="http://www.w3.org/TR/CSS2/media.html">mídia</a> usada para validar, como por exemplo: <code>screen</code>,
165: <code>print</code>, <code>braille</code>...(tela, impressora, braille...)</td>
166: <td><code>all</code></td>
167: </tr>
168: <tr>
169: <th>output</th>
170: <td>Habilita os vários formatos de saída do validador. Os formatos possíveis são:
171: <code>text/html</code> e <code>html</code> (documentos XHTML,
172: Content-Type: text/html),
173: <code>application/xhtml+xml</code> e <code>xhtml</code> (documentos XHTML, Content-Type: application/xhtml+xml),
174: <code>application/soap+xml</code> e <code>soap12</code> (documentos SOAP 1.2, Content-Type: application/soap+xml),
175: <code>text/plain</code> e <code>text</code> (documentos de texto,
176: Content-Type: text/plain),
177: demais (documentos XHTML, Content-Type: text/html) </td>
178: <td>html</td>
179: </tr>
180: <tr>
181: <th>profile</th>
182: <td>O perfil CSS usado para validar. Pode ser:
183: <code>css1</code>, <code>css2</code>, <code>css21</code>,
184: <code>css3</code>, <code>svg</code>, <code>svgbasic</code>,
185: <code>svgtiny</code>, <code>mobile</code>, <code>atsc-tv</code>,
186: <code>tv</code> or <code>none</code></td>
187: <td>a mais recente Recomendação do W3C: CSS 2</td>
188: </tr>
189: <tr>
190: <th>lang</th>
191: <td>O idioma usado para retornar os resultados da validação, atualmente as possibilidades são: <code>en</code>,
192: <code>fr</code>, <code>ja</code>, <code>es</code>,
193: <code>zh-cn</code>, <code>nl</code>, <code>de</code>, <code>it</code>,
194: <code>pl</code>.</td>
195: <td>inglês (<code>en</code>).</td>
196: </tr>
197: <tr>
198: <th>warning</th>
199: <td>Nível de alerta , <code>no</code> para ausência de alertas, <code>0</code>
200: para menos alertas, <code>1</code>ou <code>2</code> para mais alertas
201: </td>
202: <td>2</td>
203: </tr>
204: </tbody>
205: </table>
206:
207: <h4 id="api">API do serviço web de validação: Documentação da interface de validação SOAP 1.2</h4>
208: <p>
209: Para mais informações técnicas, em particular sobre saída SOAP 1.2 e demais métodos de chamada do validador ver
210: <a href="./api.html">CSS Validator Web Service API</a>.</p>
211:
212: </div>
213: </div>
214: <!-- End of "main" DIV. -->
215:
216: <ul class="navbar" id="menu">
217: <li><strong><a href="./" title="Home page do serviço de validação CSS do W3C">Home</a></strong> <span class="hideme">|</span></li>
218: <li><a href="about.html" title="Sobre esse serviço">Sobre</a> <span class="hideme">|</span></li>
219: <li><a href="documentation.html" title="Documentação para o serviço de validação CSS">Documentação</a> <span class="hideme">|</span></li>
220: <li><a href="DOWNLOAD.html" title="Download do validador CSS">Download</a> <span class="hideme">|</span></li>
221: <li><a href="Email.html" title="Como enviar seu feedback sobre esse serviço">Feedback</a> <span class="hideme">|</span></li>
222: <li><a href="thanks.html" title="Créditos e agradecimentos">Créditos</a><span class="hideme">|</span></li>
223: </ul>
224:
1.5 ot 225: <ul id="lang_choice">
226:
227: <li><a href="manual.html.de"
228: lang="de"
229: xml:lang="de"
230: hreflang="de"
231: rel="alternate">Deutsch</a>
232: </li>
233:
234: <li><a href="manual.html.en"
235: lang="en"
236: xml:lang="en"
237: hreflang="en"
238: rel="alternate">English</a>
239: </li>
240:
241: <li><a href="manual.html.es"
242: lang="es"
243: xml:lang="es"
244: hreflang="es"
245: rel="alternate">Español</a>
246: </li>
247:
248: <li><a href="manual.html.fr"
249: lang="fr"
250: xml:lang="fr"
251: hreflang="fr"
252: rel="alternate">Français</a>
253: </li>
254:
255: <li><a href="manual.html.ko"
256: lang="ko"
257: xml:lang="ko"
258: hreflang="ko"
259: rel="alternate">한국어</a>
260: </li>
261:
262: <li><a href="manual.html.it"
263: lang="it"
264: xml:lang="it"
265: hreflang="it"
266: rel="alternate">Italiano</a>
267: </li>
268:
269: <li><a href="manual.html.nl"
270: lang="nl"
271: xml:lang="nl"
272: hreflang="nl"
273: rel="alternate">Nederlands</a>
274: </li>
275:
276: <li><a href="manual.html.ja"
277: lang="ja"
278: xml:lang="ja"
279: hreflang="ja"
280: rel="alternate">日本語</a>
281: </li>
282:
283: <li><a href="manual.html.pl-PL"
284: lang="pl-PL"
285: xml:lang="pl-PL"
286: hreflang="pl-PL"
287: rel="alternate">Polski</a>
288: </li>
289:
290: <li><a href="manual.html.pt-BR"
291: lang="pt-BR"
292: xml:lang="pt-BR"
293: hreflang="pt-BR"
294: rel="alternate">Português</a>
295: </li>
296:
297: <li><a href="manual.html.ru"
298: lang="ru"
299: xml:lang="ru"
300: hreflang="ru"
301: rel="alternate">Русский</a>
302: </li>
303:
304: <li><a href="manual.html.sv"
305: lang="sv"
306: xml:lang="sv"
307: hreflang="sv"
308: rel="alternate">Svenska</a>
309: </li>
310:
311: <li><a href="manual.html.zh-cn"
312: lang="zh-cn"
313: xml:lang="zh-cn"
314: hreflang="zh-cn"
315: rel="alternate">简体中文</a>
316: </li>
317: </ul>
318:
319:
320:
321:
1.2 ot 322:
1.1 ot 323:
324:
325: <div id="footer">
326: <p id="activity_logos">
327:
328: <a href="http://www.w3.org/QA/" title="W3C's Quality Assurance Activity, trazendo até você ferramentas livres para qualidade web e muito mais"><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="Saiba mais sobre folhas de estilo em cascata"><img src="images/woolly-icon" alt="CSS" /></a>
329: </p>
330:
331: <p id="support_logo">
1.5 ot 332: <a href="http://www.w3.org/QA/Tools/Donate">
333: <img src="http://www.w3.org/QA/Tools/I_heart_validator" alt="I heart Validator logo" title=" Validators Donation Program" />
334: </a>
1.1 ot 335: </p>
336:
337: <p class="copyright">
338: <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/ipr-notice#Copyright">Copyright</a> © 1994-2007
339: <a href="http://www.w3.org/"><acronym title="Consórcio da World Wide Web">W3C</acronym></a>®
340:
341: (<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>,
342: <a href="http://www.ercim.org/"><acronym title="European Research Consortium for Informatics and Mathematics">ERCIM</acronym></a>,
343: <a href="http://www.keio.ac.jp/">Keio</a>),
344: All Rights Reserved.
345: W3C <a href="http://www.w3.org/Consortium/Legal/ipr-notice#Legal_Disclaimer">liability</a>,
346: <a href="http://www.w3.org/Consortium/Legal/ipr-notice#W3C_Trademarks">trademark</a>,
347: <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-documents">document use</a>
348: and <a rel="Copyright" href="http://www.w3.org/Consortium/Legal/copyright-software">software licensing</a>
349:
350: rules apply. Your interactions with this site are in accordance
351: with our <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Public">public</a> and
352: <a href="http://www.w3.org/Consortium/Legal/privacy-statement#Members">Member</a> privacy
353: statements.
354: </p>
355:
356: </div>
357: </body>
358: </html>
359:
360:
361:
Webmaster
![[BACK]](/prx/000/https/dev.w3.org/cvsweb/icons/back.gif,_ANDesc=img,){kind=icon}
Return to manual.html.pt-BR CVS log ![[TXT]](/prx/000/https/dev.w3.org/cvsweb/icons/text.gif,_ANDesc=img,){kind=icon}
![[DIR]](/prx/000/https/dev.w3.org/cvsweb/icons/dir.gif,_ANDesc=img,){kind=icon}
Up to [Public] / 2002 / css-validator