[LCFC] wml://www.debian.org/devel/website/translating.wml
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Em 10-03-2011 13:21, Marcelo Santana escreveu:
> --- Em qua, 9/3/11, Eder L. Marques <eder@edermarques.net> escreveu:
> [...]
>> O que você acha? Alguma segunda opinião?
>
> Por mim tá tranquilo, mas não se esqueça dos acertos no texto conforme o
> novo acordo ortográfico. Por exemplo, a palavra "idéia" não tem mais
> acento.
>
>
Corrigido. Segue para LCFC.
- --
Eder L. Marques
Just another weekend hacker
http://blog.edermarques.net/ | http://www.debian.org/
http://administrando.net/ | http://www.debianbrasil.org/
http://techbits.edermarques.net | http://www.debian-ce.org/
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.11 (GNU/Linux)
iQIcBAEBAgAGBQJNeUYYAAoJED9tnxvLkedti1cP/AxB9qcfZcWYFOVyJ0oT2yrR
icNcCvw0dsVUQ7pyN/VD1ESpeX5mXd2kO9XXMq8dorT9oayihuRYY8a1VXxvDDYF
9M8OP4MzICH1j2sQ9gaT3c0incuIN+o/dE8W3v2moJz5ENye5RbQoRI8R6Cw6M+8
KUjmPEXq62GBtFO1XaV0WTNqZdRVenDBaRZm69mSpegl5Eo6crH5hBTbl6entRjY
WYBAkejsD/dfQ5Qp3l9JhcYUjLa6BERMINR4TiJG32+S4GUTCVj9gio5ZLux4CKD
A89lIhEWNiumjBOKPgXtUOSsXHSbpxPnMO9ihme4hoFrLP5baQfPo6PoTTS569Wj
lAW/EarxawMwya4DkJzEpXkbOjqlKyT6fovXreQMeY7wr2yd3ZmxLu4/ud+0v5BF
LcmZKKkWDaOyfIzV+EO0oJSgt/h3Cu7VHPm1r8iTStaNKpITzml0yQzjoPydsQWP
eO/uuNY9T/s+VmXc2ULOtbEGx2F5ZcwKVf9GsMS0aesxDsWlLkONm4IjdydgK/K7
5zVSXAD13rjZbx5LHMI8J/YCXegPXeeE2KUngfWgESte/NnUZOxWdAX1QyxIwszc
3z3ykqDfMG+fmuuBnzRWTOZPDKyR1eyBGNZfPLiV0+tsr4NeRTrEScNNpfluF5Ys
lUYMSqCOnKBYCzGBaIp8
=KQjX
-----END PGP SIGNATURE-----
#use wml::debian::template title="Traduzindo páginas Debian" BARETITLE=true
#use wml::fmt::verbatim
#use wml::debian::translation-check translation="1.51" 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. Isso 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 essa 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
frequê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
frequê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>Para começar a usar o <tt>copypage.pl</tt> você deve primeiro configurar
o arquivo <tt>language.conf</tt> que será usado para determinar o idioma
para o qual você está traduzindo. Esse arquivo precisa apenas ter uma linha
com o nome do idioma, e pronto. Você pode também definir o idioma através
do uso da variável de ambiente <tt>DWWW_LANG</tt> e usar a variável de
ambiente <tt>DWWW_MAINT</tt> para pôr o seu nome que será adicionado ao
cabeçalho dos arquivos wml gerados, como o mantenedor da tradução. Existem
outros recursos disponíveis no script, apenas execute-o sem nenhum argumento
para obter a ajuda.
</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 isso 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
esse 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 nesses 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. Esses 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>). Isso 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 essa
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 isso estiver 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 esse 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 traduzi-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 objetivo 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 como 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 site web podem ser automaticamente removidas quando
um longo período de tempo se passou sem uma 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 ao invés disso
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 excluídos podem ser encontrados no subdiretó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 excluída e então
fazer uma <q>mesclagem para trás</q>.</p>
<p>Por exemplo, se o arquivo excluído for o "deleted.wml", e
a versão excluída é 1.7, a versão antes da exclusão é 1.6 (a versão
excluída 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 CVS 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
ideia 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: