- From: Olivier Thereaux via cvs-syncmail <cvsmail@w3.org>
- Date: Tue, 01 Jul 2008 13:53:54 +0000
- To: www-validator-cvs@w3.org
Update of /sources/public/2002/css-validator
In directory hutz:/tmp/cvs-serv10167
Added Files:
documentation.html.pt-BR about.html.pt-BR DOWNLOAD.html.pt-BR
manual.html.pt-BR
Removed Files:
documentation.html.pt-br about.html.pt-br DOWNLOAD.html.pt-br
manual.html.pt-br
Log Message:
rename
--- NEW FILE: documentation.html.pt-BR ---
<?xml version="1.0" encoding="utf-8"?>
<!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="pt-br" lang="pt-br">
<head>
<title>Documentação para o validador CSS do W3C</title>
<link rev="made" href="mailto:www-validator-css@w3.org" />
<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: documentation.html.pt-BR,v 1.1 2008/07/01 13:53:52 ot Exp $" />
<!-- SSI Template Version: $Id: documentation.html.pt-BR,v 1.1 2008/07/01 13:53:52 ot Exp $ -->
</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>Serviço de validação CSS</span></a></h1>
<p id="tagline">
Verifica folhas de estilo em cascata (CSS) e documentos (X)HTML com folhas de estilo
</p>
</div>
<div id="main">
<!-- This DIV encapsulates everything in this page - necessary for the positioning -->
<div class="doc">
<h2>Índice da documentação para o validador CSS </h2>
<p id="skip"></p>
<h3 id="use">Recursos para usuários </h3>
<dl>
<dt><a href="./manual.html">Manual do usuário</a></dt>
<dd>Documento sobre o uso do validador.</dd>
<dt><a href="about.html">Sobre esse serviço </a></dt>
<dd>Informações sobre o validador CSS e respostas a algumas questões mais comuns. </dd>
<dt><a href="http://www.websitedev.de/css/validator-faq">
FAQ para o validador CSS
</a></dt>
<dd>Respostas à perguntas técnicas mais frequentes.</dd>
</dl>
<h3 id="devel">Recursos para o desenvolvedor </h3>
<dl>
<dt><a href="DOWNLOAD.html">Download/Instalação</a></dt>
<dd>Como baixar o código do validador CSS e rodá-lo tanto via uma linha de comando quanto como uma extensão do servidor (Web Servlet).</dd>
<dt><a href="README">LEIA-ME do desenvolvedor </a></dt>
<dd>Uma visão geral do código do validador CSS.</dd>
<dt><a href="./api.html">Serviço Web API</a></dt>
<dd>Documentação para a interface de validação SOAP 1.2.</dd>
<dt><a href="http://www.w3.org/Bugs/Public/buglist.cgi?bug_status=__open__;product=CSSValidator">Bugs</a></dt>
<dd>Questões conhecidas sobre a versão corrente do validador e uma interface para reportar novos bugs e questões.
Ver também <a href="Email.html">instruções para feedback</a>.</dd>
</dl>
</div>
</div>
<!-- End of "main" DIV. -->
<ul class="navbar" id="menu">
<li><strong><a href="./" title="Home page do serviço de validação CSS do W3C">Home</a></strong> <span class="hideme">|</span></li>
<li><a href="about.html" title="Sobre esse serviço">Sobre</a> <span class="hideme">|</span></li>
<li><a href="DOWNLOAD.html" title="Download do validador CSS">Download</a> <span class="hideme">|</span></li>
<li><a href="Email.html" title="Como enviar seu feedback sobre esse serviço">Feedback</a> <span class="hideme">|</span></li>
<li><a href="thanks.html" title="Créditos e agradecimentos">Créditos</a><span class="hideme">|</span></li>
</ul>
<ul id="lang_choice">
<li><a href="documentation.html.de"
lang="de"
xml:lang="de"
hreflang="de"
rel="alternate">Deutsch</a></li>
<li><a href="documentation.html.en"
lang="en"
xml:lang="en"
hreflang="en"
rel="alternate">English</a> </li>
<li><a href="documentation.html.es"
lang="es" xml:lang="es" hreflang="es"
rel="alternate">Español</a></li>
<li><a href="documentation.html.fr"
lang="fr"
xml:lang="fr"
hreflang="fr"
rel="alternate">Français</a> </li>
<li><a href="documentation.html.it"
lang="it"
xml:lang="it"
hreflang="it"
rel="alternate">Italiano</a> </li>
<li><a href="documentation.html.nl"
lang="nl"
xml:lang="nl"
hreflang="nl"
rel="alternate">Nederlands</a> </li>
<li><a href="documentation.html.ja"
lang="ja"
xml:lang="ja"
hreflang="ja"
rel="alternate">日本語</a> </li>
<li><a href="documentation.html.pl-PL"
lang="pl"
xml:lang="pl"
hreflang="pl"
rel="alternate">Polski</a> </li>
<li><a href="documentation.html.zh-cn"
lang="zh-hans"
xml:lang="zh-hans"
hreflang="zh-hans"
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, 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>
</p>
<p id="support_logo">
Dê suporte a essa ferramenta, torne-se um <br />
<a href="http://www.w3.org/Consortium/supporters"><img src="http://www.w3.org/Consortium/supporter-logos/csupporter.png" alt="Suporte ao W3C" /></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="Consórcio da World Wide Web">W3C</acronym></a>®
(<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>,
<a href="http://www.ercim.org/"><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>
--- documentation.html.pt-br DELETED ---
--- NEW FILE: about.html.pt-BR ---
<?xml version="1.0" encoding="utf-8"?>
<!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="pt-br" lang="pt-br">
<head>
<title>Sobre o serviço de validação do W3C</title>
<link rev="made" href="mailto:www-validator-css@w3.org" />
<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: about.html.pt-BR,v 1.1 2008/07/01 13:53:52 ot Exp $" />
</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="./">Serviço de validação CSS</a></h1>
<p id="tagline">Verifica folhas de estilo em cascata (CSS) e documentos (X)HTML com folhas de estilo</p>
</div>
<div class="doc">
<h2>Sobre o validador CSS</h2>
<h3 id="TableOfContents">Índice</h3>
<div id="toc">
<ol>
<li>Sobre esse serviço
<ol>
<li><a href="#what">Que serviço é esse? Eu preciso dele?</a></li>
<li><a href="#help">A explicação acima é confusa! Socorro!</a></li>
<li><a href="#reference">Então, essa é a autoridade que determina se a CSS está ou não correta?</a></li>
<li><a href="#free">Quanta custa?</a></li>
<li><a href="#who">Quem escreveu o código dessa ferramenta ? Quem a mantém?</a></li>
<li><a href="#contact">Como posso entrar em contato com o autor ? Relatar um bug?</a></li>
<li><a href="#participate">Posso ajudar ?</a></li>
</ol>
</li>
<li>Cantinho do desenvolvedor
<ol>
<li><a href="#code">Como foi escrito o código do validador CSS ? Ele está disponível em algum lugar?</a></li>
<li><a href="#install">Posso instalar e rodar o validador?</a></li>
<li><a href="#api">Posso construir uma aplicação para o validador? Existe uma API?</a></li>
</ol>
</li>
</ol>
</div><!-- toc -->
<h3 id="about">Sobre esse serviço </h3>
<h4 id="what">Que serviço é esse ? Eu preciso dele?</h4>
<p>O serviço de validação do W3C é um software livre criado pelo W3C para auxiliar web designers e desenvolvedores web na verificação de folhas de estilo em cascata (CSS).
Ele pode ser <a href="./">usado livremente</a> na web, ou você pode fazer o download e usá-lo tanto como um programa java independente ou como uma extensão (servlet) em um servidor web.</p>
<p><em>Você</em> precisa dele? se você é um desenvolvedor web ou um web designer está ferramenta será uma poderosa aliada. Ela não só é capaz de comparar uma folha de estilo com as especificações para as CSS, apontando erros, grafia incorreta ou uso impróprio das CSS, mas também alertará você para potenciais riscos à usabilidade.</p>
<h4 id="help">A explicação acima é confusa! Socorro!</h4>
<p>A maioria dos documentos para a web são escritos em uma linguagem para computador denominada HTML. Essa linguagem pode ser usada para criar informação estruturada, links e multimídia em geral. Para definir cores, formatos de textos e layout a HTML usa uma linguagem de estilização denominada CSS, abreviatura para "Cascading Style Sheets" (folhas de estilo em cascata) .
A finalidade da ferramenta validador CSS é a de auxiliar o desenvolvedor na tarefa de verificar e corrigir quando necessário as folhas de estilo por ele desenvolvidas.</p>
<h4 id="reference">Então, essa é a autoridade que determina se a CSS está ou não correta?</h4>
<p>Não. É apenas uma ferramenta valiosa e confiável, ressalvado que, sendo uma ferramenta baseada em um software, está sujeita a
<a href="http://www.w3.org/Bugs/Public/buglist.cgi?product=CSSValidator">bugs e incorreções </a>.
A referência atual para folhas de estilo é a <a href="http://www.w3.org/Style/CSS/#specs">especificação para CSS</a>.</p>
<h4 id="free">Quanto custa ?</h4>
<p>Nada. O serviço é gratuito. O código é <a href="DOWNLOAD.html">aberto</a> e você é livre para baixar, usar, modificar, distribuir e <a href="http://www.w3.org/Consortium/Legal/copyright-software">muito mais</a>.
Se você gosta do validador está convidado a <a href="#participate">participar do seu projeto</a> ou fazer uma doação ao W3C via o
<a href="http://www.w3.org/Consortium/sup">programa de suporte ao W3C</a>, mas isto não é uma obrigatoriadade.</p>
<h4 id="who">Quem escreveu o código dessa ferramenta ? Quem a mantém?</h4>
<p>O W3C mantém, hospeda a ferramenta e agradece o trabalho do staff do W3C, aos desenvolvedores voluntários e tradutores. Ver a <a href="thanks.html">página de créditos e agradecimentos</a>
para maiores detalhes. <a href="#participate">Você pode participar.</a></p>
<h4 id="participate">Posso ajudar ?</h4>
<p>Certamente que sim . Se você é um programador java você pode ajudar a desenvolver o projeto do validador conferindo o <a href="#code">código</a>,
analisando e corrigindo <a href="http://www.w3.org/Bugs/Public/buglist.cgi?product=CSSValidator">bugs</a>,
ou criando novas funcionalidades.</p>
<p>Mas, você não precisa ser um programador para manutenir e aperfeiçoar essa ferramenta: você pode ajudar na melhoria da documentação, participar de traduções do validador ou mesmo se inscrever na
<a href="http://lists.w3.org/Archives/Public/www-validator-css/">lista de discussão</a> para participar das discussões e ajudar usuários com dúvidas.</p>
<h4 id="contact">Ficou alguma dúvida ?</h4>
<p>Se você tem alguma dúvida sobre CSS ou validador CSS consulte as
<a href="Email">listas de discussão e fóruns</a>. Mas, antes disso, certifique-se de que sua dúvida não está respondida no <a href="http://www.websitedev.de/css/validator-faq">FAQ para o validador CSS</a>.</p>
<h3 id="dev">Cantinho do desenvolvedor </h3>
<h4 id="code">Como foi escrito o código do validador CSS ? Ele está disponível em algum lugar?</h4>
<p>O validador CSS do W3C foi escrito em linguagem java e seu código está disponível usando CVS: você pode
<a href="http://dev.w3.org/cvsweb/2002/css-validator/">navegar online pelo código</a>
ou baixar o código seguindo as instruções ali contidas. Para uma visão rápida das classses usadas pelo código ao validador CSS veja o arquivo
<a href="README.html">LEIA-ME</a>.</p>
<h4 id="install">Posso instalar e rodar o validador?</h4>
<p>É sim, possível baixar, instalar o validador e rodá-lo via linha de comando ou como servlet em um servidor web. Leia as <a href="RUN.html">instruções</a> para instalação e uso.</p>
<h4 id="api">Posso construir uma aplicação para o validador? Existe uma API?</h4>
<p>Sim e <a href="api.html">sim</a>. O validor CSS possui uma (RESTful) <a href="api.html">interface SOAP</a>
que torna bem simples a tarefa de construir uma aplicação (seja web ou outra qualquer). Uma forma civilizada e respeitosa para com os demais usuários de uma ferramenta pública é construir aplicações com uso de comando sleep() entre chamadas da ferramenta (no caso o validador) ou ainda instalar e rodar uma instância própria da ferramenta.</p>
</div>
<ul class="navbar" id="menu">
<li><strong><a href="./" title="Home page do serviço de validação CSS do W3C">Home</a></strong> <span class="hideme">|</span></li>
<li><a href="documentation.html" title="Documentação para o serviço de validação CSS">Documentação</a> <span class="hideme">|</span></li>
<li><a href="DOWNLOAD.html" title="Download do validador CSS">Download</a> <span class="hideme">|</span></li>
<li><a href="Email.html" title="Como enviar seu feedback sobre esse serviço">Feedback</a> <span class="hideme">|</span></li>
<li><a href="thanks.html" title="Créditos e agradecimentos">Créditos</a><span class="hideme">|</span></li>
</ul>
<ul id="lang_choice">
<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.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"
xml:lang="pl"
hreflang="pl"
rel="alternate">Polski</a> </li>
<li><a href="about.html.zh-cn"
lang="zh-hans"
xml:lang="zh-hans"
hreflang="zh-hans"
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, 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>
</p>
<p id="support_logo">
Dê suporte a essa ferramenta, torne-se um<br />
<a href="http://www.w3.org/Consortium/supporters"><img src="http://www.w3.org/Consortium/supporter-logos/csupporter.png" alt="Suporte ao W3C" /></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="Consórcio da World Wide Web">W3C</acronym></a>®
(<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>,
<a href="http://www.ercim.org/"><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>
--- about.html.pt-br DELETED ---
--- NEW FILE: manual.html.pt-BR ---
<?xml version="1.0" encoding="utf-8"?>
<!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="pt-br" lang="pt-br">
<head>
<title>CSS Validator User Manual</title>
<link rev="made" href="mailto:www-validator-css@w3.org" />
<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: manual.html.pt-BR,v 1.1 2008/07/01 13:53:52 ot Exp $" />
<!-- SSI Template Version: $Id: manual.html.pt-BR,v 1.1 2008/07/01 13:53:52 ot Exp $ -->
</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>Serviço de validação CSS</span></a></h1>
<p id="tagline">
Verifica folhas de estilo em cascata (CSS) e documentos (X)HTML com folhas de estilo</p>
</div>
<div id="main">
<!-- This DIV encapsulates everything in this page - necessary for the positioning -->
<div class="doc">
<h2>Manual do usuário para o validador CSS</h2>
<h3 id="TableOfContents">Índice</h3>
<div id="toc">
<ul>
<li><a href="#use">Como usar o validador CSS</a>
<ul>
<li><a href="#url">Validação por entrada de URL</a></li>
<li><a href="#fileupload">Validação por upload de arquivo</a></li>
<li><a href="#directinput">Validação por entrada direta</a></li>
<li><a href="#basicvalidation">O que é validação básica?</a></li>
</ul>
</li>
<li><a href="#advanced">Validação avançada </a>
<ul>
<li><a href="#paramwarnings">Alertas</a></li>
<li><a href="#paramprofile">Perfil</a></li>
<li><a href="#parammedium">Mídias</a></li>
</ul>
</li>
<li><a href="#expert">Para especialistas </a>
<ul>
<li><a href="#requestformat">Formato para requisição de validação</a></li>
<li><a href="#api">API do serviço web de validação </a></li>
</ul>
</li>
</ul>
</div>
<p id="skip"></p>
<h3 id="use">Como usar o validador CSS</h3>
<p>
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>
<h4 id="url">Validação por entrada da URL</h4>
<p>
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>
<img style="display: block; margin-left:auto; margin-right: auto;"
src="./images/uri_basic.png" alt="Formulário para validação por URI" />
<h4 id="fileupload">Validação por upload de arquivo</h4>
<p>
Esta solução permite validar um arquivo local. Clique no botão
"Arquivo..." e selecione o arquivo a verificar.</p>
<img style="display: block; margin-left:auto; margin-right: auto;"
src="./images/file_upload_basic.png"
alt="Formulário para validação por upload de arquivo" />
<p>
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
@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>
<h4 id="directinput">Validação por entrada direta</h4>
<p>
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>
<img style="display: block; margin-left:auto; margin-right: auto;"
src="./images/direct_input_basic.png"
alt="Formulário para validação por entrada direta" />
<p>
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>
<h4 id="basicvalidation">O que é validação básica?</h4>
<p>
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 />
O relatório de resultados do validador é uma página XHTML mostrando somente os erros CSS (não há relatório de alertas).<br />
A mídia é configurada para "todas", ou seja, o validador considera que a folha de estilo é servida para todos os dispositivos de usuário
(para uma descrição completa de tipos de mídia ver <a href="http://www.w3.org/TR/CSS2/media.html">
http://www.w3.org/TR/CSS2/media.html</a>).</p>
<h3 id="advanced">Validação avançada </h3>
<p>
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>
<h4 id="paramwarnings">Alertas</h4>
<p>
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
alertas.
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>
<p>
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>
<h4 id="paramprofile">Perfil</h4>
<p>
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
<a href="http://www.w3.org/Style/2004/css-charter-long.html#modules-and-profiles0">
site CSS</a>. O perfil padrão corresponde à especificação corrente e mais usada:
<a href="http://www.w3.org/TR/CSS2">CSS 2</a>.</p>
<h4 id="parammedium">Mídia</h4>
<p>
O parâmetro mídia é equivalente à diretiva @media aplicada ao documento. Você encontra mais informações sobre mídia em
<a href="http://www.w3.org/TR/CSS2/media.html">
http://www.w3.org/TR/CSS2/media.html </a>.</p>
<h3 id="expert">Para especialistas </h3>
<h4 id="requestformat">Formato para requisição de validação</h4>
<p>A seguir apresentamos uma tabela com os parâmetros a serem usados para enviar uma requisição ao validador
CSS do W3C.</p>
<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 />
<kbd>http://jigsaw.w3.org/css-validator/validator</kbd><br />
caso esteja usando uma instância própria do validador, use o endereço base do seu servidor.</p>
<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.
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>
<table class="refdoc">
<tbody>
<tr>
<th>Parâmetro</th>
<th>Descrição</th>
<th>Valor padrão </th>
</tr>
<tr>
<th>uri</th>
<td>Ae <acronym title="Universal Resource Locator">URL</acronym> do documento a validar. São permitidos documentos CSS e HTML.</td>
<td>Não há, mas esse parâmetro ou o parâmetro <code>text</code> deve ser fornecido.</td>
</tr>
<tr>
<th>text</th>
<td>O documento a validar, somente CSS é permitida.</td>
<td>Não há, mas esse parâmetro ou o parâmetro <code>uri</code> deve ser fornecido</td>
</tr>
<tr>
<th>usermedium</th>
<td>A <a href="http://www.w3.org/TR/CSS2/media.html">mídia</a> usada para validar, como por exemplo: <code>screen</code>,
<code>print</code>, <code>braille</code>...(tela, impressora, braille...)</td>
<td><code>all</code></td>
</tr>
<tr>
<th>output</th>
<td>Habilita os vários formatos de saída do validador. Os formatos possíveis são:
<code>text/html</code> e <code>html</code> (documentos XHTML,
Content-Type: text/html),
<code>application/xhtml+xml</code> e <code>xhtml</code> (documentos XHTML, Content-Type: application/xhtml+xml),
<code>application/soap+xml</code> e <code>soap12</code> (documentos SOAP 1.2, Content-Type: application/soap+xml),
<code>text/plain</code> e <code>text</code> (documentos de texto,
Content-Type: text/plain),
demais (documentos XHTML, Content-Type: text/html) </td>
<td>html</td>
</tr>
<tr>
<th>profile</th>
<td>O perfil CSS usado para validar. Pode ser:
<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> or <code>none</code></td>
<td>a mais recente Recomendação do W3C: CSS 2</td>
</tr>
<tr>
<th>lang</th>
<td>O idioma usado para retornar os resultados da validação, atualmente as possibilidades são: <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>inglês (<code>en</code>).</td>
</tr>
<tr>
<th>warning</th>
<td>Nível de alerta , <code>no</code> para ausência de alertas, <code>0</code>
para menos alertas, <code>1</code>ou <code>2</code> para mais alertas
</td>
<td>2</td>
</tr>
</tbody>
</table>
<h4 id="api">API do serviço web de validação: Documentação da interface de validação SOAP 1.2</h4>
<p>
Para mais informações técnicas, em particular sobre saída SOAP 1.2 e demais métodos de chamada do validador ver
<a href="./api.html">CSS Validator Web Service API</a>.</p>
</div>
</div>
<!-- End of "main" DIV. -->
<ul class="navbar" id="menu">
<li><strong><a href="./" title="Home page do serviço de validação CSS do W3C">Home</a></strong> <span class="hideme">|</span></li>
<li><a href="about.html" title="Sobre esse serviço">Sobre</a> <span class="hideme">|</span></li>
<li><a href="documentation.html" title="Documentação para o serviço de validação CSS">Documentação</a> <span class="hideme">|</span></li>
<li><a href="DOWNLOAD.html" title="Download do validador CSS">Download</a> <span class="hideme">|</span></li>
<li><a href="Email.html" title="Como enviar seu feedback sobre esse serviço">Feedback</a> <span class="hideme">|</span></li>
<li><a href="thanks.html" title="Créditos e agradecimentos">Créditos</a><span class="hideme">|</span></li>
</ul>
<ul id="lang_choice">
<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.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"
xml:lang="pl"
hreflang="pl"
rel="alternate">Polski</a> </li>
<li><a href="manual.html.zh-cn"
lang="zh-hans"
xml:lang="zh-hans"
hreflang="zh-hans"
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, 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>
</p>
<p id="support_logo">
Dê suporte a essa ferramenta, torne-se um<br />
<a href="http://www.w3.org/Consortium/supporters"><img src="http://www.w3.org/Consortium/supporter-logos/csupporter.png" alt="Suporte ao W3C" /></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="Consórcio da World Wide Web">W3C</acronym></a>®
(<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>,
<a href="http://www.ercim.org/"><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>
--- DOWNLOAD.html.pt-br DELETED ---
--- manual.html.pt-br DELETED ---
--- NEW FILE: DOWNLOAD.html.pt-BR ---
<?xml version="1.0" encoding="utf-8"?>
<!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="pt-br" lang="pt-br">
<head>
<title>Download and Install the CSS Validator</title>
<link rev="made" href="mailto:www-validator-css@w3.org" />
<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: DOWNLOAD.html.pt-BR,v 1.1 2008/07/01 13:53:52 ot Exp $" />
<!-- SSI Template Version: $Id: DOWNLOAD.html.pt-BR,v 1.1 2008/07/01 13:53:52 ot Exp $ -->
</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>Serviço de validação CSS</span></a></h1>
<p id="tagline">
Verifica folhas de estilo em cascata (CSS) e documentos (X)HTML com folhas de estilo</p>
</div>
<div class="doc">
<h2>Download e instalação do validador CSS</h2>
<h3 id="download">Download do validador CSS</h3>
<h4 id="source">Download do código-fonte</h4>
<p>
O <a href='http://dev.w3.org/cvsweb/2002/css-validator'>validator CSS</a> está disponível para download usando CVS.
Siga as <a href='http://dev.w3.org/cvsweb/'>instruções</a> para acessar o serviço público CVS do W3C e escolha o 2002/css-validator. Notar que a versão online do validador geralmente é mais antiga que a versão
CVS
portanto não estranhe se houver pequenas diferenças de apresentação entre elas.</p>
<h4>Download como um pacote java (jar ou war)</h4>
<!-- <p>TBD... we just need a stable location to put jar/war archives on a regular basis</p>-->
<p><a href="http://www.w3.org/QA/Tools/css-validator/css-validator.jar">css-validator.jar</a></p>
<h3>Guia de instalação </h3>
<p>O serviço de validação CSS é um software tipo servlet escrito em Java. Ele pode ser instalado em qualquer engine para servlet, mas pode também ser usado via linha de comando.
O Serviço oficial de validação CSS do W3C roda em servidor Jigsaw, que é a configuração recomendada.
Contudo, para simplificar a situação, iremos explicar a instalação como um servlet online em Apache com engine Tomcat.</p>
<p>Seguem também algumas orientações sobre a instalação como servlet em Jigsaw, bem como para rodar com uso de linha de comando. </p>
<h4 id="prereq">Prerequisitos</h4>
<p>Esse guia de instalação considera que você baixou, instalou e testou o seguinte: </p>
<ul class="instructions">
<li>Um ambiente java em funcionamento,</li>
<li>A ferramenta <a href="http://ant.apache.org/">Ant</a> para desenvolvimento java</li>
<li>Um container para servlet java, tal como, <a href="http://www.w3.org/Jigsaw/">Jigsaw</a>, <a href="http://tomcat.apache.org/">Tomcat</a> ou
<a href="http://www.mortbay.org/">Jetty</a> caso você pretenda configurar um validador online.
Esse guia contempla detalhes de instalação apenas para Tomcat e Jigsaw.</li>
</ul>
<p id="prereq-libs">Para instalar o validador no seu sistema você precisa ter disponível algumas bibliotecas java como mostrado a seguir:</p>
<ul class="instructions">
<li>servlet.jar
(se você tiver Tomcat instalado em [<span class="const">TOMCAT_DIR</span>],
procure em [<span class="const">TOMCAT_DIR</span>]/common/lib/) possivelmente com o nome
servlet-api.jar. Caso contrário baixe em
<a href="http://java.sun.com/products/servlet/download.html">java.sun.com</a></li>
<li><a href="http://jigsaw.w3.org/Devel/classes-2.2/20060329/">jigsaw.jar</a></li>
<li>xercesImpl.jar e xml-apis.jar (podem ser baixados em
<a href="http://www.apache.org/dist/xml/xerces-j/">xerces-j-bin</a>).</li>
<li><a href="http://ccil.org/~cowan/XML/tagsoup/">tagsoup.jar</a></li>
</ul>
<h4>Instalação do validador CSS em Tomcat</h4>
<ol class="instructions">
<li>
Baixe o validador como explicado <a href="#source">acima</a>. </li>
<li>Insira uma cópia do diretório ("<span class="dir">.../css-validator/</span>"), com todo seu conteúdo, no diretório <span class="dir">webapps</span>
da sua instalação do Tomcat. Normalmente está em
<span class="dir">[<span class="const">TOMCAT_DIR</span>]/webapps/</span>.
O código do validador agora está em <span class="dir">[<span class="const">TOMCAT_DIR</span>]/webapps/css-validator</span>,
que chamaremos de <span class="dir">[<span class="const">VALIDATOR_DIR</span>]</span>. </li>
<li>No "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]</span>" crie um diretório com o nome "<span class="dir">WEB-INF</span>", e em "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]/WEB-INF</span>" crie um diretório chamado "<span class="dir">lib</span>":<br />
<kbd>mkdir -p WEB-INF/lib</kbd> </li>
<li>Copie todos os arquivos jar (acima citados em <a href="#prereq-libs">prerequisitos</a>) para o diretório "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]/WEB-INF/lib</span>"</li>
<li>Compile o código do validador: a partir do diretório <span class="dir">[<span class="const">VALIDATOR_DIR</span>]</span>,
rode <kbd>ant</kbd>, mas esteja certo de que todos os arquivos jar que você baixou estão corretamente configurados na variável CLASSPATH do ambiente.
Em geral é suficiente o seguinte:<br />
<kbd>CLASSPATH=.:./WEB-INF/lib:$CLASSPATH ant</kbd> </li>
<li>Copie ou transfira "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]/</span><span class="file">css-validator.jar</span>"
para "<span class="dir">[<span class="const">VALIDATOR_DIR</span>]/WEB-INF/lib/</span>".</li>
<li>
Copie ou transfira o arquivo "<span class="file">web.xml</span>" de
"<span class="dir">[<span class="const">VALIDATOR_DIR</span>]/</span>" para
"<span class="dir">[<span class="const">VALIDATOR_DIR</span>]/WEB-INF/</span>". </li>
<li>
Reinicie o servidor Tomcat:<br />
<kbd>"cd <span class="dir">[<span class="const">TOMCAT_DIR</span>]</span>; <span class="dir">./bin/</span><span class="file">shutdown.sh</span>; <span class="dir">./bin/</span><span class="file">startup.sh</span>;"</kbd> </li>
</ol>
<h4>Instalação em servidor Jigsaw</h4>
<ol class="instructions">
<li>Baixe o código como explicado anteriormente, tenha todos os arquivos jars e monte o código com <kbd>ant</kbd>.</li>
<li>Agora você precisa configurar o diretório home do validador (em geral é o diretório
css-validator) de modo a que ele possa funcionar como um container para servlet. Para isso você precisa ter o Jigsaw instalado (ver a documentação do Jigsaw para instruções (é bem fácil)) e a seguir inicie Jigsaw Admin. Modifique
HTTPFrame para ServletDirectoryFrame.</li>
<li>A seguir crie um recurso "validator", com a classe
'ServletWrapper' e como 'ServletWrapperFrame'. O último se auto adicionará automagicamente. A classe do servlet é
org.w3c.css.servlet.CssValidator. Se já existir um arquivo chamado
'validator', por favor, renomeie ele. É importante que esse 'alias' tenha sempre o nome de 'validator'.</li>
<li>Finalmente, inicie Jigsaw e rode o validador. Verifique qual o HTML que você deseja invocar. Usualmente sua URL terá o seguinte formato:<br />
http://localhost:8001/css-validator/validator.html</li>
</ol>
<h3>Uso com linha de comando</h3>
<p>O validador CSS pode ainda ser usado como uma ferramenta iniciada via linha de comando, caso seu cumputador tenha java instalado. Construa o css-validator.jar como explicado anteriormente e rode assim:<br />
<kbd>java -jar css-validator.jar http://www.w3.org/</kbd>
</p>
</div>
<ul class="navbar" id="menu">
<li><strong><a href="./" title="Home page do serviço de validação CSS do W3C">Home</a></strong> <span class="hideme">|</span></li>
<li><a href="about.html" title="Sobre esse serviço">Sobre</a> <span class="hideme">|</span></li>
<li><a href="documentation.html" title="Documentação para o serviço de validação CSS">Documentação</a> <span class="hideme">|</span></li>
<li><a href="Email.html" title="Como enviar seu feedback sobre esse serviço">Feedback</a> <span class="hideme">|</span></li>
<li><a href="thanks.html" title="Créditos e agradecimentos">Créditos</a><span class="hideme">|</span></li>
</ul>
<ul id="lang_choice">
<li><a href="DOWNLOAD.html.de"
lang="de"
xml:lang="de"
hreflang="de"
rel="alternate">Deutsch</a></li>
<li><a href="DOWNLOAD.html.en"
lang="en"
xml:lang="en"
hreflang="en"
rel="alternate">English</a> </li>
<li><a href="DOWNLOAD.html.es"
lang="es" xml:lang="es" hreflang="es"
rel="alternate">Español</a></li>
<li><a href="DOWNLOAD.html.fr"
lang="fr"
xml:lang="fr"
hreflang="fr"
rel="alternate">Français</a> </li>
<li><a href="DOWNLOAD.html.it"
lang="it"
xml:lang="it"
hreflang="it"
rel="alternate">Italiano</a> </li>
<li><a href="DOWNLOAD.html.nl"
lang="nl"
xml:lang="nl"
hreflang="nl"
rel="alternate">Nederlands</a> </li>
<li><a href="DOWNLOAD.html.ja"
lang="ja"
xml:lang="ja"
hreflang="ja"
rel="alternate">日本語</a> </li>
<li><a href="DOWNLOAD.html.pl-PL"
lang="pl"
xml:lang="pl"
hreflang="pl"
rel="alternate">Polski</a> </li>
<li><a href="DOWNLOAD.html.zh-cn"
lang="zh-hans"
xml:lang="zh-hans"
hreflang="zh-hans"
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, 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>
</p>
<p id="support_logo">
Dê suporte a essa ferramenta, torne-se um<br />
<a href="http://www.w3.org/Consortium/supporters"><img src="http://www.w3.org/Consortium/supporter-logos/csupporter.png" alt="Suporte ao W3C" /></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="Consórcio da World Wide Web">W3C</acronym></a>®
(<a href="http://www.csail.mit.edu/"><acronym title="Massachusetts Institute of Technology">MIT</acronym></a>,
<a href="http://www.ercim.org/"><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>
Received on Tuesday, 1 July 2008 13:54:32 UTC