[RFR] wml://www.debian.org/devel/website/translating.wml
Mais um wml para revisão.
O original em inglês encontra-sem em:
http://alioth.debian.org/scm/viewvc.php/webwml/english/devel/website/translating.wml?view=markup&revision=1.51&root=webwml
Obrigado,
--
Eder L. Marques
#use wml::debian::template title="Traduzindo páginas Debian" BARETITLE=true
#use wml::fmt::verbatim
#use wml::debian::translation-check translation="1.51" translation_maintainer="Eder L. Marques (frolic)"
<p>Para tornar o trabalho dos tradutores o mais fácil possível as páginas
são geradas de modo um pouco diferente ao que muitos de vocês estão
acostumados. As páginas web são geradas usando fontes que são marcados com
<a href="http://www.engelschall.com/sw/wml/";><tt>wml</tt></a>.
Há diretórios separados para cada idioma.
<p>Se você planeja começar uma tradução inteiramente nova do site web do
Debian, veja a <a href="#completenew">seção sobre começar uma tradução
nova</a>.
<h2><a name="singlepages">Traduzindo páginas individuais</a></h2>
<p>Nós usamos o WML para separar o conteúdo específico de uma página dos
elementos comuns entre múltiplas páginas. Isto significa que o tradutor
precisa editar alguns arquivos fonte WML ao invés dos arquivos HTML. Por
favor, <a href="using_cvs">use o CVS</a> para obter os fontes atuais.
Você precisará pegar pelo menos dois diretórios: <tt>webwml/english/</tt>
e <tt>webwml/<var><idioma></var>/</tt>.</p>
<p>Para traduzir uma única página do inglês para seu idioma, o arquivo .wml
original deve ser traduzido e colocado dentro do diretório do outro idioma.
O caminho relativo e o nome precisam ser os mesmos do diretório inglês para
que os links continuem funcionando.</p>
<h3>Cabeçalhos de tradução</h3>
<p>É fortemente recomendado que o tradutor inclua uma linha adicional
aos cabeçalhos depois do último <code>#use</code> para registrar a revisão
exata do arquivo original que foi traduzida, para que a <a href="uptodate">\
atualização seja fácil</a>. A linha se parece com isto:
<kbd>#use wml::debian::translation-check translation="<var>x.y</var>"</kbd>
<p>Algumas equipes de tradução também usam esta linha para marcar o
tradutor oficial de cada página. Fazendo-o, você receberá mensagens
automáticas quando as páginas que você mantêm são atualizadas em inglês,
e precisam de sua atenção para atualizar a tradução. Para isso, simplesmente
adicione o seu nome como mantenedor no fim da linha <code>#use</code>
deixando-a parecida com esta:
<kbd>#use wml::debian::translation-check translation="<var>x.y</var>" maintainer="<var>seu nome</var>"</kbd>.
O <tt>copypage.pl</tt> irá fazer isso automaticamente se você configurar a variável
de ambiente <tt>DWWW_MAINT</tt> ou usar o parâmetro de linha de comando <tt>-m</tt>.
</p>
<p>Você também precisa explicar para o robô quem é você, com qual
freqüência você deseja receber mensagens automáticas e com qual conteúdo.
Para fazê-lo, edite (ou deixe que seu coordenador o faça) o arquivo
webwml/<var>idioma</var>/international/<var>idioma</var>/translator.db.pl
no CVS. A sintaxe deve ser inteligível e você pode usar o arquivo da
equipe francesa como modelo se ele não existe para o seu idioma ainda.
O robô pode enviar vários tipos de informações, e você pode escolher a
freqüência com a qual elas serão enviadas para você. Os tipos diferentes
de informação são:
</p>
<ul>
<li><b>summary</b>: um sumário de quais documentos estão desatualizados</li>
<li><b>logs</b>: o "cvs log" entre a versão traduzida e a atual</li>
<li><b>diff</b>: "cvs diff"</li>
<li><b>tdiff</b>: o script tentará encontrar as partes do texto traduzido
modificadas pelo patch inglês.</li>
<li><b>file</b>: adiciona a versão atual do arquivo a ser traduzido</li>
</ul>
<p>Para cada uma delas, o valor deve estar entre: 0 (nunca), 1 (mensalmente),
2 (semanalmente) ou 3 (diariamente).</p>
<p>Um exemplo poderia ser:
</p>
<verbatim>
'Martin Quinson' => {
email => 'martin.quinson@tuxfamily.org',
summary => 3,
logs => 3,
diff => 3,
tdiff => 0,
file => 0
},
</verbatim>
<p>O cabeçalho da página web pode ser facilmente produzido usando o
script <tt>copypage.pl</tt> no diretório raiz webwml. O script
copiará a página no lugar correto, criará diretórios e makefiles
se necessário e adicionará o cabeçalho necessário automaticamente.
Você será avisado se uma página a ser copiada existe no repositório, seja porque
a página foi removida do repositório (por estar bastante desatualizada) ou
porque alguém já enviou uma tradução e a sua cópia local do repositório não
está atualizada.
</p>
<p>Após ter executado <kbd>./copypage.pl <var>arquivo</var>.wml</kbd>,
traduza o texto original dentro do arquivo. Comentários nos arquivos
indicarão se há itens que não devem ser traduzidos; respeite-os.
Não faça nenhuma alteração desnecessária na formatação; se alguma
coisa precisa ser corrigida, a correção provavelmente deve ser feita
no arquivo original.</p>
<h3>Construção e publicação das páginas</h3>
<p>Como nós usamos <a href="content_negotiation">negociação de conteúdo</a>,
arquivos HTML não são nomeados <tt><var>arquivo</var>.html</tt>; são nomeados
<tt><var>arquivo</var>.<var><idioma></var>.html</tt>, onde
<var><idioma></var> é o código de duas letras para o idioma, de acordo
com a
<a href="http://ftp.ics.uci.edu/pub/ietf/http/related/iso639.txt";>ISO 639</a>
(e.g. <tt>fr</tt> para francês).</p>
<p>Você pode construir o HTML a partir do WML executando
<kbd>make <var>arquivo</var>.<var><idioma></var>.html</kbd>.
Se isto funcionar, cheque se a sintaxe está completamente válida com
<kbd>weblint <var>arquivo</var>.<var><idioma></var>.html</kbd>.</p>
<p>As páginas são reconstruídas a partir do CVS no servidor www-master e
este processo é na maior parte resistente a erros. No entanto, se você
colocar um arquivo quebrado no primeiro nível de sua tradução (e.g. o arquivo
index.wml no nível mais alto da estrutura), ele quebrará o processo de
construção e interromperá todas as outras atualizações do site web. Por favor,
preste atenção especial nestes arquivos.</p>
<p>Uma vez que a página esteja pronta para ser publicada, você pode enviá-la
ao CVS. Se você tem as permissões para fazê-lo, execute <kbd>cvs commit</kbd>;
se não, envie-a para <a href="translation_coordinators">alguém com acesso de
escrita ao repositório</a>.</p>
<h2><a name="completenew">Começando uma tradução nova</a></h2>
<p>Se você gostaria de começar a tradução das páginas web do Debian
em um novo idioma, envie uma mensagem (em inglês) para
<a href="mailto:webmaster@debian.org";>webmaster@debian.org</a>.
<p>Antes de qualquer coisa, tenha certeza de que você fez um checkout de
nossa árvore de código fonte, como descrito <a href="using_cvs">na nossa
página de introdução ao CVS</a>.</p>
<p>Depois que você tiver feito uma cópia do diretório webwml/ e (pelo menos)
do webwml/english/, comece criando um novo diretório para sua tradução,
junto com o english/ e outros. O nome do diretório de tradução deve estar
em inglês e completamente em letras minúsculas (e.g. <q>german</q>, não
<q>Deutsch</q>).</p>
<p>Copie os arquivos <tt>Make.lang</tt> e <tt>.wmlrc</tt> do diretório
english/ para o diretório da nova tradução. Estes arquivos são essenciais
para construção de sua tradução a partir dos arquivos WML. Eles foram
projetados de forma que, depois de copiá-los para o diretório do novo idioma,
você só precise alterar estas coisas:</p>
<ol>
<li>A variável LANGUAGE deve ser alterada no arquivo <tt>Make.lang</tt>.
<li>As variáveis CUR_LANG, CUR_ISO_LANG e CHARSET devem ser alteradas
no arquivo <tt>.wmlrc</tt>. Adicione CUR_LOCALE nele, caso precise
disso para ordenação.
<li>Alguns idiomas podem precisar de processamento extra para lidar com
o conjunto de caracteres (<q>charset</q>). Isto pode ser feito usando
as opções --prolog e --epilog do wml. Use as variáveis WMLPROLOG e
WMLEPILOG no <tt>Make.lang</tt> para fazê-lo.
<li>A variável LANGUAGES deve ser alterada no arquivo
<tt>webwml/Makefile</tt> para que o seu idioma seja construído junto
com os outros em www.debian.org. Nós preferimos que você deixe esta
alteração em particular para os webmasters, porque a sua tradução pode
estar quebrada sem que você esteja ciente, o que poderia parar o
processo de construção do resto de nosso site web.
</ol>
<p>Depois que isto esteja feito, coloque a seguinte linha em um novo arquivo
chamado <q>Makefile</q> nesse diretório:
<pre>
<protect>include $(subst webwml/<var>seudiretório</var>,webwml/english,$(CURDIR))/Makefile</protect>
</pre>
<p>(Substitua <var>seudiretório</var> com o nome do diretório de seu
idioma).</p>
<p>Agora crie um subdiretório em seu diretório de idioma chamado <q>po</q>,
e copie o mesmo Makefile para este subdiretório (<kbd>cp ../Makefile .</kbd>).
</p>
<p>No diretório po/, execute <kbd>make init-po</kbd> para gerar o conjunto
inicial de arquivos *.po.</p>
<p>Agora que o esqueleto está configurado, você pode começar a adicionar
suas traduções em nossas tags WML compartilhadas usadas em modelos
(<q>templates</q>). Os primeiros modelos que você deve traduzir são aqueles
que aparecem em todas as páginas, como as palavras chave do cabeçalho, as
entradas da barra de navegação e o rodapé.</p>
# The page on <a href="using_wml">using WML</a> has more information on this.
<p>Comece traduzindo o arquivo <code>po/templates.<var>xy</var>.po</code>
(onde <var>xy</var> é o código de duas letras de seu idioma). Para cada
<code>msgid "<var>alguma coisa</var>"</code> há inicialmente um
<code>msgstr ""</code>. Você deve colocar a tradução de <var>alguma coisa</var>
entre aspas duplas depois de <code>msgstr</code>.</p>
<p>Você não tem que traduzir todas as strings em todos os arquivos .po,
somente aquelas que suas páginas traduzidas realmente precisam. Para ver
se você precisa traduzir uma string, leia os comentários no arquivo .po
acima de cada <code>msgid</code>. Se o arquivo referenciado estiver em
<tt>english/template/debian</tt>, então você provavelmente deve traduzí-la.
Se não, você pode deixá-la para depois, quando você traduzir a seção
relevante das páginas que a utilizam.</p>
<p>O objetivos dos arquivos po/ é tornar as coisas mais fáceis para os
tradutores, de forma que eles (quase) nunca tenham que editar algo no
diretório <tt>english/template/debian</tt>.
Se você encontrar qualquer coisa errada com a forma com que algo está
configurado no diretório template, por favor, tenha certeza que o problema
pode ser corrigido de maneira genérica (sinta-se à vontade para pedir para
que outra pessoa faça isso por você), ao invés de adicionar traduções nos
modelos, o que (usualmente) é um grande problema.</p>
<p>Se você não tem certeza se fez alguma coisa de maneira apropriada, pergunte
na lista de discussão debian-www antes de fazer o commit.</p>
<p>Nota: se você descobrir que precisa fazer qualquer outra alteração,
envie uma mensagem para debian-www dizendo o que você alterou e por que,
para que o problema seja corrigido.
<p>Depois que o esqueleto dos templates estiver feito, você pode começar
com a tradução da página frontal e outros arquivos *.wml. Para uma lista
de arquivos que devem ser traduzidos primeiro, veja
<a href="translation_hints">a página de dicas</a>.
Traduza páginas *.wml como descrito <a href="#singlepages">no
topo desta página</a>.</p>
<h3>Revivendo traduções desatualizadas</h3>
<p>Como descrito em <a href="uptodate">como manter as traduções atualizadas</a>,
traduções desatualizadas do website pode ser automaticamente removidas quando um
longo período de tempo passou sem haver atualização.</p>
<p>Se você usa o script <tt>copypage.pl</tt> com um arquivo que foi removido do
CVS ele recusará copiar a página e perguntará a você para no lugar da cópia
revivê-lo. Você pode checar as razões pelas quais o arquivo foi removido do cvs
usando <tt>cvs log</tt> no arquivo removido (ou use a interface web,
os arquivos removidos podem ser encontrados no sub-diretório "Attic".
</p>
<p>Para reviver uma tradução desatualizada use <tt>cvs status</tt>
(ou <tt>cvs log</tt>) para anotar o número de versão da versão removida e então
fazer uma <q>mesclagem para trás</q>.</p>
<p>Por exemplo, se o arquivo removido é o "deleted.wml", e
a versão removida é 1.7, a versão antes da remoção é 1.6 (a versão removida menos um).
Você pode restaurar o arquivo executando:
<verbatim>
cvs update -j 1.7 -j 1.6 deleted.wml
</verbatim>
<p>Ao fazer isso você tem que, é claro, atualizar o documento antes de
enviá-lo ao repositório novamente, ou caso contrário ele pode ser removido.
<h3>O resto da história</h3>
<p>A descrição acima provavelmente será o suficiente para você
começar. Após isso, você pode querer ver os seguintes documentos
que dão explicações mas detalhadas e informações adicionais.</p>
<ul>
<li>Vários <a href="examples">exemplos</a> são fornecidos para dar uma
idéia clara de como começar.
<li>Várias questões comuns são respondidas e dicas de grande ajuda são
dadas na página de <a href="translation_hints">dicas de tradução</a>.
<li>Nós temos mecanismos para ajudar a <a href="uptodate">manter as
traduções atualizadas</a>.
<li>Para ver o estado da sua tradução e como ela está em comparação a
outras, verifique a página de <a href="stats/">estatísticas</a>.
</ul>
<p>Nós esperamos que o trabalho que nós realizados torne a tradução
das páginas o mais fácil possível. Como já mencionado, se você tiver
alguma questão, pergunte-a na lista de discussão <a
href="mailto:debian-www@lists.debian.org";>debian-www</a>.
Reply to: