Tradução webwml (era: Re: Inscrição)

["Felipe Augusto van de Wiel (faw)" <faw@funlabs.org>]

-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1

On 10-01-2009 15:18, Gandhi Alberto Schünemann wrote:
> Olá,
> venho por meio desta me inscrever na lista para ajudar nas traduções das
> páginas web do Debian.

Oi Gandhi,

	As páginas web do Debian precisam de bastante carinho e atenção.
Note que elas não são a opção mais fácil para quem quer começar, mas não
deixe que isso o intimide. :-)

	Você vai precisar entender um pouquinho de CVS e vai precisar
entender WML, que é uma espécie de HTML. Um ponto importante, é que
apenas algumas pessoas têm acesso de escrita então você terá que enviar
as páginas traduzidas para a lista usando as pseudo-urls para poder
passar por uma revisão, antes que elas sejam adicionar definitivamente
e apareçam no site do Debian.


Via WEB (CVS WEB)
=================

	Você pode optar por não usar o CVS, isso pode dar mais trabalho
à longo prazo, mas pode ser mais fácil à curto prazo. Para tentar sem o
CVS, acessa a página das estatísticas de tradução do site:

  http://www.debian.org/devel/website/stats/pt


  	No link acima, há uma lista de páginas não traduzidas, imagine
que você quer traduzir a primeira delas 'devel/buildd/operation', vá
até o CVS via web, no diretório em inglês:

 http://cvs.debian.org/webwml/english/


	A hierarquia de arquivos é a mesma, então clique em 'devel',
depois em 'buildd' e você verá o 'operation.wml', clique nele e escolha
a opção 'dowload' da revisão mais nova, neste momento é a 1.8. Você
terá uma cópia do operation.wml, agora é só traduzi-lo e enviá-lo para
a lista para revisão e para que alguém com acesso ao CVS publique-o.
Para ver mais sobre a parte de revisão e as pseudo-urls, veja o final
deste e-mail.


Via CVS
=======

	Se você preferir usar o CVS, que é o método recomendado, já
que ele tem alguns scripts que podem ajudá-lo e permite acompanhar
a atualização do site mais facilmente, aqui estão alguns passos para
você começar:

 * Instale os pacotes: libtimedate-perl e cvs
	# aptitude install libtimedate-perl cvs

 * Crie um diretório para colocar os arquivos do site e para usar como
   área de trabalho para a tradução do site web

 * Baixe os arquivos "www-cvs" e "language.conf" da URL abaixo o coloque
   no diretório que você criou no item anterior.
	http://people.debian.org/~faw/l10n-brazilian/

 * Vá para o diretório que você criou, torne o script www-cvs executável
   ($ chmod a+x www-cvs) e execute-o enquanto estiver conectado à Internet
   da seguinte forma:
	$ ./www-cvs init

   OBSERVAÇÃO: Isso fará o download de aproximadamente 80MB de arquivos
   num diretório chamado webwml.

   Se uma senha for solicitada, simplesmente aperte <ENTER>, você está
   acessando o repositório CVS de forma anônima, por isso não é necessário
   informar senha.

   O script criará o ambiente de produção, composto pelo diretório webwml
   e dentro dele vários scripts e os diretórios da página em inglês e
   português, vai demorar um pouco.

   Copie o arquivo language.conf que você baixou para dentro do diretório
   webwml e execute o script www-cvs novamente.
	$ ./www-cvs


   O script www-cvs vai gerar o arquivo needwork.txt, que contém quais
   arquivos estão desatualizados. Esses são a prioridade máxima. Eu procuro
   manter o site atualizado, então em geral você terá que traduzir _novos_
   arquivos.


Pseudo-URLs
===========

	Use as pseudo-urls para evitar duplicação de esforços e permitir
que o robô rastreie as pendências de revisão e atualização.

  http://i18n.debian.net/debian-l10n/docs/robot/pseudo-urls.html


	O procedimento que eu descrevi neste e-mail é a versão atualizada
do que está listado no Wiki de Debian Brasil (o wiki passará pela tão
aguardada atualização no começo de fevereiro). Você encontra basicamente
os mesmos passos, mas encontra mais detalhes sobre as pseudo-urls em
português.

  http://www.debianbrasil.org/?id=WebWML


	Para mais informações sobre a organização do site do Debian, veja:

  http://www.debian.org/devel/website/


Exemplo
=======

	Apenas para constar, se você fosse traduzir o 'operation.wml',
antes de traduzi-lo, você enviaria uma mensagem com o seguinte assunto:

[ITT] wml://webwml/portuguese/devel/buildd/operation.wml

	Depois de traduzido, você responderia sua própria mensagem,
anexando o operation.wml e mudando o assunto (inclusive removendo o
Re:) para:

[RFR] wml://webwml/portuguese/devel/buildd/operation.wml


	A partir daí ocorrem as revisões e você já deve ter entendido
a idéias das outras pseudo-urls. :-) Espero que isso seja o suficiente,
qualquer dúvida, questão ou sugestão, não hesite em contatar a lista.

	Obrigado pelo interesse em ajudar/contribuir. Fico no aguardo
do seu primeiro WML traduzido.

Abraço,
- --
Felipe Augusto van de Wiel (faw)
"Debian. Freedom to code. Code to freedom!"
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.9 (GNU/Linux)
Comment: Using GnuPG with Mozilla - http://enigmail.mozdev.org

iEYEARECAAYFAklqsCwACgkQCjAO0JDlykZHfwCfStmsgkOHqg+u53xwBdB8XLr8
ry0AoKoTROfUljlYMf+nhb2RixUjV9W4
=cmGW
-----END PGP SIGNATURE-----