Differences between revisions 1 and 47 (spanning 46 versions)
⇤ ← Revision 1 as of 2017-04-18 12:27:59 →
Size: 9832
Editor: DanielLenharo
Comment:
← Revision 47 as of 2020-06-26 16:08:07 → ⇥
Size: 15373
Editor: PauloSantana
Comment:
Deletions are marked like this. Additions are marked like this.
Line 5: Line 5:
Através das páginas web todos podem obter informações a respeito do Projeto Debian e suas diversas iniciativas. Para que as mesmas estejam disponíveis no idioma Português Brasileiro, uma equipe de tradutores, coordenada através da lista de discussão [[http://lists.debian.org/debian-l10n-portuguese|debian-l10n-portuguese|target="_blank"]], utiliza um [[http://www.debian.org/devel/website/using_cvs|sistema de controle de versão (CVS)|target="_blank"]] onde os arquivos fonte, em formato WML, ficam armazenados. Os mesmos são utilizados para geração das páginas em formato HTML durante o processo de reconstrução automática do site, que ocorre periodicamente.

Apenas algumas pessoas têm acesso de escrita ao CVS, por isso tudo deve ser muito bem coordenado.

== Ajudando: ==

Caso você tenha interesse em colaborar com as traduções das páginas web, recomendamos que leia atentamente as instruções detalhadas na [[http://www.debian.org/devel/website|página do Debian|target="_blank"]] e inscreva-se na lista de discussão [[http://lists.debian.org/debian-l10n-portuguese|debian-l10n-portuguese|target="_blank"]].

A seguir faremos um resumo dos principais pontos, considerando um acesso apenas de leitura ao CVS.

Instale os pacotes cvs, gettext, wml (para geração de páginas HTML a partir de arquivos WML) e tidy (para testar o código HTML gerado):
{{{
# aptitude install cvs gettext wml tidy
}}}
Defina a variável de ambiente '''{{{CVSROOT}}}''':
{{{
$ export CVSROOT=:pserver:anonymous@anonscm.debian.org:/cvs/webwml
}}}
Faça o login no CVS, teclando "ENTER" quando for solicitada a senha:
{{{
$ cvs login
Logging in to :pserver:anonymous@anonscm.debian.org:2401/cvs/webwml
CVS password:
}}}
Faça uma cópia dos arquivos WML em sua máquina (isso baixará os arquivos de todos os idiomas existentes):
{{{
$ cvs checkout webwml
}}}
Se preferir, você poderá fazer uma cópia parcial apenas da estrutura principal e dos idiomas Inglês e Português assim:
{{{
$ cvs checkout -l webwml
$ cvs checkout webwml/Perl
$ cvs checkout webwml/english
$ cvs checkout webwml/portuguese
}}}

Agora você está pronto para começar a trabalhar. Antes de alterar alguma página, sempre execute o comando '''"{{{cvs update}}}"''', ou se preferir, '''"{{{cvs update -d}}}"''', e avise à lista debian-l10n-portuguese@lists.debian.org no que vai trabalhar, para evitar a duplicação de esforços.

Para mais dicas de como traduzir um arquivo WML, por exemplo, a prioridade que cada WML deve receber na tradução, visite a [[http://www.debian.org/devel/website/translation_hints|página de dicas de tradução|target="_blank"]]. Na [[http://www.debian.org/devel/website/stats/pt|página de estatísticas de tradução|target="_blank"]] você encontra uma lista das páginas traduzidas que estão desatualizadas, as páginas que ainda não estão traduzidas e outras estatísticas sobre as traduções.

== Trabalhando com os arquivos ==

=== Atualizando uma tradução ===

Por favor, antes de começar a traduzir qualquer arquivo que esteja constando como desatualizado, envie uma mensagem para a lista debian-l10n-portuguese@lists.debian.org, escrevendo no assunto a pseudo-url conforme descrito no final deste tutorial, informando em qual arquivo que você pretende trabalhar, evitando assim que duas pessoas peguem o mesmo arquivo para traduzir.

Para atualizar uma tradução, basta entrar no diretório do arquivo em questão e fazer as devidas mudanças em relação ao original em inglês. Supondo que você vá atualizar o arquivo {{{/webwml/portuguese/legal/index.wml}}}, o original do mesmo estará em {{{/webwml/english/legal/index.wml}}}.
{{{
$ cd webwml/portuguese/legal
$ $EDITOR index.wml
}}}

Após concluir a atualização do arquivo, faça um teste para verificar se o arquivo HTML está sendo gerado corretamente. Esse teste é '''muito importante''', pois se um arquivo WML estiver com alguma falha, seja devido a uma tag faltando ou qualquer outro motivo, o processo de reconstrução do site do Debian poderá falhar. Portanto, não esqueça de fazer o seguinte (no diretório do arquivo WML):		 Através das páginas web, todos podem obter informações a respeito do Projeto Debian e suas diversas iniciativas. Para que as mesmas estejam disponíveis no idioma Português Brasileiro, uma equipe de tradutores, coordenada através da lista de discussão [[http://lists.debian.org/debian-l10n-portuguese|debian-l10n-portuguese]], utiliza um sistema de controle de versão (GIT) onde os arquivos fonte, em formato WML, ficam armazenados. Os mesmos são utilizados para geração das páginas em formato HTML durante o processo de reconstrução automática do site, que ocorre periodicamente.

O repositório está em: https://salsa.debian.org/webmaster-team/webwml.git

Apenas algumas pessoas têm acesso de escrita ao GIT, por isso tudo deve ser muito bem coordenado.

== Como ajudar ==

Caso você tenha interesse em colaborar com as traduções das páginas web, recomendamos que leia atentamente as instruções detalhadas na [[http://www.debian.org/devel/website|página do Debian]] e inscreva-se na lista de discussão [[http://lists.debian.org/debian-l10n-portuguese|debian-l10n-portuguese]].

Para mais dicas de como traduzir um arquivo WML, por exemplo, a prioridade que cada WML deve receber na tradução, visite a [[http://www.debian.org/devel/website/translation_hints|página de dicas de tradução]].

Na [[http://www.debian.org/devel/website/stats/pt|página de estatísticas de tradução]] você encontra uma lista das páginas traduzidas que estão desatualizadas, as páginas que ainda não estão traduzidas e outras estatísticas sobre as traduções.

== Como criar seu ambiente de trabalho ==

A seguir, faremos um resumo dos principais pontos, considerando um acesso apenas de leitura ao GIT.

Instale os pacotes git, gettext, wml (para geração de páginas HTML a partir de arquivos WML) e tidy (para testar o código HTML gerado):
{{{
# apt install git gettext wml tidy
}}}

Faça uma cópia dos arquivos WML em sua máquina. Recomendamos que você baixe apenas as páginas originais (em inglês) e as traduções em português:
{{{
$ git clone --no-checkout https://salsa.debian.org/webmaster-team/webwml.git
$ cd webwml
$ git config core.sparseCheckout true

Dentro do diretório webwml: Crie o arquivo
.git/info/sparse-checkout
com o conteúdo:
/*
!/[a-z]*/
/english/
/portuguese/

Em seguida faça:
$ git checkout --
}}}

Alternativamente, para baixar os arquivos de todos os idiomas existentes:
{{{
$ git clone https://salsa.debian.org/webmaster-team/webwml.git
}}}

Agora você está pronto para começar a trabalhar. Antes de alterar alguma página, no diretório webwml, sempre execute o comando
'''{{{
$ git pull
}}}'''


== Como atualizar e revisar uma tradução ==

=== Para quem vai atualizar uma tradução ===

Veja este [[https://www.youtube.com/watch?v=qH6XxMdiZ3A|tutorial em vídeo]] para ajudar a entender o processo de atualização.

Para escolher um arquivo para atualizar, você deve acessar as duas páginas abaixo:
 1. Acesse https://www.debian.org/devel/website/stats/pt#outdated e veja a lista de arquivos no tópico "Traduções desatualizadas". Escolha um desses arquivos.
 1. Depois acesse a página https://l10n.debian.org/coordination/brazilian/pt_BR.by_status.html e pesquise se o arquivo que você escolheu na outra página está listado em algum dos tópícos. Se o arquivo estiver lá, significa que alguém já está trabalhando nele. Então você deverá escolher outro arquiva na página anterior.

Antes de começar a traduzir qualquer arquivo que esteja constando como desatualizado, por favor envie uma mensagem para a lista debian-l10n-portuguese@lists.debian.org, escrevendo no assunto a pseudo-url {{{[ITT]}}} conforme descrito [[https://wiki.debian.org/Brasil/Traduzir/WebWML#Como_enviar_e-mails_com_os_status_das_tradu.2BAOcA9Q-es|no final desse tutorial]], informando em qual arquivo que você pretende trabalhar, evitando assim que duas pessoas peguem o mesmo arquivo para traduzir.

Para atualizar uma tradução, basta entrar no diretório do arquivo em questão e fazer as devidas mudanças em relação ao original em inglês. Comece por atualizar o cabeçalho do arquivo com o identificador do commit do original em inglês, de acordo com o git. Por exemplo, se o commit do arquivo em inglés é 257c21bc3adb2b3c7174439a605ea9010623492d então você deve inserir o campo:

#use wml::debian::translation-check translation="257c21bc3adb2b3c7174439a605ea9010623492d"

Em seguida, siga com a edição do conteúdo.

Supondo que você vá atualizar o arquivo {{{webwml/portuguese/legal/index.wml}}}, o original do mesmo estará em {{{webwml/english/legal/index.wml}}}.
No terminal faça:
{{{
$ git log webwml/english/legal/index.wml
}}}
Então edite o arquivo {{{webwml/portuguese/legal/index.wml}}} usando o seu editor preferido.

Após concluir a atualização do arquivo, faça um teste para verificar se o arquivo HTML está sendo gerado corretamente. Esse teste é '''muito importante''', pois se um arquivo WML estiver com alguma falha, seja devido a uma tag faltando ou qualquer outro motivo, o processo de reconstrução do site do Debian poderá falhar. Portanto, não esqueça de fazer o seguinte no terminal (no diretório do arquivo WML):
Line 66: Line 91:
Após a atualização da tradução e devido teste de geração do HTML, é necessário gerar o arquivo com as alterações que foram feitas em relação ao arquivo original, que deverá ser enviado para a lista de discussão, da seguinte forma:
{{{
$ cvs diff -uN index.wml > index.wml.patch
}}}

Então, basta enviar uma mensagem para a lista debian-l10n-portuguese@lists.debian.org, escrevendo no assunto a pseudo-url conforme descrito no final deste tutorial, anexando o arquivo com as alterações para que outra pessoal possa realizar a revisão.

=== Revisando uma tradução atualizada ===

Para revisar uma tradução que foi atualizada e encontra-se com status '''{{{RFR}}}''', é necessário baixar o arquivo que estiver anexado na mensagem para sua a cópia local do CVS, lembrando-se que o diretório raiz será {{{portuguese}}}, e aplicar as alterações à versão antiga do arquivo em questão. Suponhamos uma pseudo-url com '''{{{[RFR] wml://www.debian.org/intro/index.wml}}}'''. Nesse caso, o arquivo index.wml.patch será copiado para o diretório {{{/webwml/portuguese/intro}}}, não esquecendo de antes atualizar a cópia local do CVS, e aplicaremos as alterações da seguinte forma:		 Após a atualização da tradução e devido teste de geração do HTML, é necessário gerar o arquivo com as alterações que foram feitas em relação ao arquivo original, que deverá ser enviado para a lista de discussão. No terminal faça:
{{{
$ git diff -u index.wml > index.wml.patch
}}}

Agora você deve enviar uma mensagem para a lista debian-l10n-portuguese@lists.debian.org, respondendo o seu primeiro e-mail e mudando no assunto a pseudo-url de {{{[ITT]}}} para {{{[RFR]}}} conforme descrito [[https://wiki.debian.org/Brasil/Traduzir/WebWML#Como_enviar_e-mails_com_os_status_das_tradu.2BAOcA9Q-es|no final desse tutorial]], anexando o arquivo .patch com as alterações para que outra pessoal possa realizar a revisão. O assunto da mensagem deve começar com {{{[RFR]}}}, por isso remova qualquer "Re" no início.

Alguém irá revisar a sua atualização, e se ela tiver alguma correção a ser feita, enviará um novo arquivo .patch. Após ver quais são as correções que o revisor enviou, você pode aceitar essas alterações ou debater na lista se elas são mesmo necessárias ou não.

=== Para quem vai revisar uma tradução atualizada ===

Para revisar uma tradução que foi atualizada e encontra-se com status '''{{{RFR}}}''', é necessário baixar o arquivo que estiver anexado na mensagem para sua a cópia local do GIT, lembrando-se que o diretório raiz será {{{portuguese}}}, e aplicar as alterações à versão antiga do arquivo em questão. Suponhamos uma pseudo-url com '''{{{[RFR] wml://www.debian.org/intro/index.wml}}}'''. Nesse caso, o arquivo index.wml.patch será copiado para o diretório {{{webwml/portuguese/intro}}}, não esquecendo de antes atualizar a cópia local do GIT, e aplicaremos as alterações da seguinte forma:
Line 78: Line 105:
$ patch -p0 < index.wml.patch (você pode usar "patch -p0 --dry-run" para testar antes se o patch será aplicado corretamente)
patching file index.wml
}}}

Após aplicado o patch, você já pode proceder a revisão da tradução, cujo original estará em {{{webwml/english/intro/index.wml}}}. Ao final da revisão, caso tenha feito alguma correção, será necessário gerar um novo arquivo com as alterações, como descrito anteriormente, que será anexado em sua resposta à mensagem na qual foi solicitada a revisão.

=== Criando uma nova tradução ===

Para criar novas traduções é recomendado utilizar o script '''{{{copypage.pl}}}''' existente no diretório principal {{{webwml}}}. Supondo que queremos traduzir o arquivo {{{/webwml/english/intro/help.wml}}}, é necessário definirmos a variável '''{{{DWWW_LANG}}}''' e executar o script da seguinte forma:		 $ git apply index.wml.patch (você pode usar "git apply --check" para testar antes se o patch será aplicado corretamente)
}}}

Após aplicado o patch, você já pode proceder a revisão da tradução, cujo original estará em {{{webwml/english/intro/index.wml}}}, usando o seu editor preferido. É importante que você faça a revisão em todo o arquivo, porque a pessoa que fez a atualização pode ter esquecido de atualizar alguma parte do texto.

Ao final da revisão, caso tenha feito alguma correção, será necessário gerar um novo arquivo .patch com as alterações, que será anexado em sua resposta à mensagem na qual foi solicitada a revisão.
{{{
$ git diff -u index.wml > index.seu-nome.wml.patch
}}}

== Como criar e revisar uma nova tradução ==

=== Para quem vai criar uma nova tradução ===

Veja este [[https://www.youtube.com/watch?v=RmXGnIAZShU|tutorial em vídeo]] para ajudar a entender o processo de tradução.

Para escolher um arquivo para traduzir, você deve acessar as duas páginas abaixo:
 1. Acesse https://www.debian.org/devel/website/stats/pt#untranslated e veja a lista de arquivos no tópico "Páginas gerais não traduzidas". Escolha um desses arquivos.
 1. Depois acesse a página https://l10n.debian.org/coordination/brazilian/pt_BR.by_status.html e pesquise se o arquivo que você escolheu na outra página está listado em algum dos tópícos. Se o arquivo estiver lá, significa que alguém já está trabalhando nele. Então você deverá escolher outro arquiva na página anterior.

Antes de começar a traduzir qualquer arquivo que esteja constando como não traduzido, por favor envie uma mensagem para a lista debian-l10n-portuguese@lists.debian.org, escrevendo no assunto a pseudo-url conforme descrito [[https://wiki.debian.org/Brasil/Traduzir/WebWML#Como_enviar_e-mails_com_os_status_das_tradu.2BAOcA9Q-es|no final desse tutorial]], informando em qual arquivo que você pretende trabalhar, evitando assim que duas pessoas peguem o mesmo arquivo para traduzir.

Para criar novas traduções vocẽ deve utilizar o script '''{{{copypage.pl}}}''' existente no diretório principal {{{webwml}}}. Supondo que queremos traduzir o arquivo {{{webwml/english/News/2018/20180601.wml}}}, é necessário definirmos a variável '''{{{DWWW_LANG}}}''' e executar o script da seguinte forma:
Line 90: Line 131:
$ ./copypage.pl english/intro/help.wml
}}}

Após isso, basta traduzir o arquivo em {{{/webwml/portuguese/intro/help.wml}}}, e adicionar a seguinte linha no cabeçalho:
{{{
#use wml::debian::translation-check translation="<versão_do_original>" maintainer="<Nome_do_tradutor>"		 $ ./copypage.pl english/News/2018/20180601.wml
}}}

Após isso, basta traduzir o arquivo em {{{webwml/portuguese/News/2018/20180601.wml}}}, usando o seu editor preferido, e adicionar a seguinte linha no cabeçalho:
{{{
#use wml::debian::translation-check translation="<versão_do_original>"
Line 99: Line 140:
$ cvs status webwml/english/intro/help.wml
}}}

O restante do processo é praticamente igual ao descrito para atualização de uma tradução. Logicamente, como em uma nova tradução não existe um arquivo original já traduzido, ao final do processo, deveremos enviar o arquivo completo para a lista de discussão.

=== Revisando uma nova tradução ===

O processo de revisão de uma nova tradução é praticamente igual ao de uma atualização de tradução. Entretanto, como não dispomos de um arquivo original já traduzido, deveremos apenas revisar o arquivo que estiver anexado à mensagem com a solicitação de revisão. Recomendamos que sejam feitas duas cópias do arquivo anexado, uma com o nome original e outra com uma variação do nome do arquivo em questão (ex: help_rev.wml), para que após a conclusão da revisão, caso haja alguma correção a ser feita, possamos criar o arquivo com as alterações, da seguinte forma:
{{{
$ diff -uN help.wml help_rev.wml > help.wml.patch
}}}

== Enviando as atualizações ==

Todo o processo de tradução e revisão se dá através da lista de discussão, com o envio de mensagens que utilizam [[Traduzir/Pseudo-urls|pseudo-urls]]. Suponhamos que você vá traduzir/atualizar o arquivo {{{/webwml/portuguese/legal/index.wml}}}. O ciclo de trabalho da tradução ficará assim:		 $ git log webwml/english/News/2018/20180601.wml
}}}

Após concluir a tradução do arquivo, faça um teste para verificar se o arquivo HTML está sendo gerado corretamente. Esse teste é '''muito importante''', pois se um arquivo WML estiver com alguma falha, seja devido a uma tag faltando ou qualquer outro motivo, o processo de reconstrução do site do Debian poderá falhar. Portanto, não esqueça de fazer o seguinte no terminal (no diretório do arquivo WML):
{{{
$ cd webwml/portuguese/News/2018/
$ make 20180601.pt.html
$ tidy -e 20180601.pt.html
Info: Doctype given is "-//W3C//DTD HTML 4.01//EN"
Info: Document content looks like HTML 4.01 Strict
No warnings or errors were found.
}}}

Após a tradução e devido teste de geração do HTML, é necessário enviar uma mensagem para a lista debian-l10n-portuguese@lists.debian.org, escrevendo no assunto a pseudo-url conforme descrito [[https://wiki.debian.org/Brasil/Traduzir/WebWML#Como_enviar_e-mails_com_os_status_das_tradu.2BAOcA9Q-es|no final desse tutorial]], anexando o arquivo completo .wml para que outra pessoal possa realizar a revisão.

Alguém irá revisar a sua tradução, e se ela tiver alguma correção a ser feita, enviará um arquivo .patch. Após ver quais são as correções que o revisor enviou, você pode aceitar essas alterações ou debater na lista se elas são mesmo necessárias ou não. Para aplicar o patch enviado pelo revisor, no terminal faça:
{{{
$ cd webwml/portuguese/News/2018/
$ patch -p0 < arquivo-enviado-pelo-revisor.patch (você pode usar "patch -p0 --dry-run" para testar antes se o patch será aplicado corretamente)
patching file index.wml
}}}

=== Para quem vai revisar uma nova tradução ===

O processo de revisão de uma nova tradução é praticamente igual ao de uma atualização de tradução. Entretanto, como não dispomos de um arquivo original já traduzido, deveremos apenas revisar o arquivo que estiver anexado à mensagem com a solicitação de revisão. Recomendamos que sejam feitas duas cópias do arquivo anexado, uma com o nome original e outra com uma variação do nome do arquivo em questão (ex: 20180601_rev.wml), para que após a conclusão da revisão, caso haja alguma correção a ser feita, possamos criar o arquivo com as alterações, da seguinte forma:
{{{
$ diff -uN 20180601.wml 20180601_rev.wml > 20180601.wml.patch
}}}

Envie esse arquivo .patch para a lista de discussão, anexado em sua resposta à mensagem na qual foi solicitada a revisão.

== Como enviar e-mails com os status das traduções ==

Todo o processo de tradução e revisão se dá através da lista de discussão, com o envio de mensagens que utilizam [[Brasil/Traduzir/Pseudo-urls|pseudo-urls]]. Suponhamos que você vá traduzir/atualizar o arquivo {{{webwml/portuguese/legal/index.wml}}}. O ciclo de trabalho da tradução ficará assim:
Line 123: Line 183:
Após conclusão da tradução/atualização do arquivo, solicite a revisão da mesma (envie o arquivo {{{.patch}}} anexado), respondendo à mensagem anterior com: Após conclusão da tradução/atualização do arquivo, solicite a revisão da mesma (envie o arquivo {{{.patch}}} anexado), respondendo à mensagem anterior trocando o [ITT] por [RFR] no assunto, e removendo coisas como "Re:". O campo de assunto deve ter apenas:
Line 136: Line 196:
Após o seu arquivo ser enviado para o CVS do Debian, por uma pessoa que tenha permissão de escrita (commiter), a mesma se encarregará de responder à mensagem anterior com: Após o seu arquivo ser enviado para o GIT do Debian, por uma pessoa que tenha permissão de escrita (commiter), a mesma se encarregará de responder à mensagem anterior com:
Line 143: Line 203:


= Fluxograma de tradução de páginas web =

No intuito de ajudar as pessoas que não estão familiarizadas com o processo de tradução, resolvemos criar um fluxograma com as informações acima. Ajude-nos a melhorá-lo e envie um e-mail com sugestões para a nossa lista.
{{https://l10n-br-team.pages.debian.net/fluxograma/Fluxograma.svg}}

Outros formatos do fluxograma estão disponíveis em [[https://l10n-br-team.pages.debian.net/fluxograma/|https://l10n-br-team.pages.debian.net/fluxograma/]]. O repositório usado na organização do fluxograma está em [[https://salsa.debian.org/l10n-br-team/fluxograma|https://salsa.debian.org/l10n-br-team/fluxograma]].

## {{attachment:Fluxograma03.svg}}

Contents

  1. Tradução das Páginas Web do Debian
    1. Como ajudar
    2. Como criar seu ambiente de trabalho
    3. Como atualizar e revisar uma tradução
      1. Para quem vai atualizar uma tradução
      2. Para quem vai revisar uma tradução atualizada
    4. Como criar e revisar uma nova tradução
      1. Para quem vai criar uma nova tradução
      2. Para quem vai revisar uma nova tradução
    5. Como enviar e-mails com os status das traduções
  2. Fluxograma de tradução de páginas web

Tradução das Páginas Web do Debian

Através das páginas web, todos podem obter informações a respeito do Projeto Debian e suas diversas iniciativas. Para que as mesmas estejam disponíveis no idioma Português Brasileiro, uma equipe de tradutores, coordenada através da lista de discussão debian-l10n-portuguese, utiliza um sistema de controle de versão (GIT) onde os arquivos fonte, em formato WML, ficam armazenados. Os mesmos são utilizados para geração das páginas em formato HTML durante o processo de reconstrução automática do site, que ocorre periodicamente.

O repositório está em: https://salsa.debian.org/webmaster-team/webwml.git

Apenas algumas pessoas têm acesso de escrita ao GIT, por isso tudo deve ser muito bem coordenado.

Como ajudar

Caso você tenha interesse em colaborar com as traduções das páginas web, recomendamos que leia atentamente as instruções detalhadas na página do Debian e inscreva-se na lista de discussão debian-l10n-portuguese.

Para mais dicas de como traduzir um arquivo WML, por exemplo, a prioridade que cada WML deve receber na tradução, visite a página de dicas de tradução.

Na página de estatísticas de tradução você encontra uma lista das páginas traduzidas que estão desatualizadas, as páginas que ainda não estão traduzidas e outras estatísticas sobre as traduções.

Como criar seu ambiente de trabalho

A seguir, faremos um resumo dos principais pontos, considerando um acesso apenas de leitura ao GIT.

Instale os pacotes git, gettext, wml (para geração de páginas HTML a partir de arquivos WML) e tidy (para testar o código HTML gerado): 

# apt install git gettext wml tidy

Faça uma cópia dos arquivos WML em sua máquina. Recomendamos que você baixe apenas as páginas originais (em inglês) e as traduções em português: 

$ git clone --no-checkout https://salsa.debian.org/webmaster-team/webwml.git
$ cd webwml
$ git config core.sparseCheckout true

Dentro do diretório webwml: Crie o arquivo
.git/info/sparse-checkout
com o conteúdo:
/*
!/[a-z]*/
/english/
/portuguese/

Em seguida faça:
$ git checkout --

Alternativamente, para baixar os arquivos de todos os idiomas existentes: 

$ git clone https://salsa.debian.org/webmaster-team/webwml.git

Agora você está pronto para começar a trabalhar. Antes de alterar alguma página, no diretório webwml, sempre execute o comando 

$ git pull

Como atualizar e revisar uma tradução

Para quem vai atualizar uma tradução

Veja este tutorial em vídeo para ajudar a entender o processo de atualização.

Para escolher um arquivo para atualizar, você deve acessar as duas páginas abaixo:

  1. Acesse https://www.debian.org/devel/website/stats/pt#outdated e veja a lista de arquivos no tópico "Traduções desatualizadas". Escolha um desses arquivos.

  2. Depois acesse a página https://l10n.debian.org/coordination/brazilian/pt_BR.by_status.html e pesquise se o arquivo que você escolheu na outra página está listado em algum dos tópícos. Se o arquivo estiver lá, significa que alguém já está trabalhando nele. Então você deverá escolher outro arquiva na página anterior.

Antes de começar a traduzir qualquer arquivo que esteja constando como desatualizado, por favor envie uma mensagem para a lista debian-l10n-portuguese@lists.debian.org, escrevendo no assunto a pseudo-url [ITT] conforme descrito no final desse tutorial, informando em qual arquivo que você pretende trabalhar, evitando assim que duas pessoas peguem o mesmo arquivo para traduzir.

Para atualizar uma tradução, basta entrar no diretório do arquivo em questão e fazer as devidas mudanças em relação ao original em inglês. Comece por atualizar o cabeçalho do arquivo com o identificador do commit do original em inglês, de acordo com o git. Por exemplo, se o commit do arquivo em inglés é 257c21bc3adb2b3c7174439a605ea9010623492d então você deve inserir o campo:

#use wml::debian::translation-check translation="257c21bc3adb2b3c7174439a605ea9010623492d"

Em seguida, siga com a edição do conteúdo.

Supondo que você vá atualizar o arquivo webwml/portuguese/legal/index.wml, o original do mesmo estará em webwml/english/legal/index.wml. No terminal faça: 

$ git log webwml/english/legal/index.wml

Então edite o arquivo webwml/portuguese/legal/index.wml usando o seu editor preferido.

Após concluir a atualização do arquivo, faça um teste para verificar se o arquivo HTML está sendo gerado corretamente. Esse teste é muito importante, pois se um arquivo WML estiver com alguma falha, seja devido a uma tag faltando ou qualquer outro motivo, o processo de reconstrução do site do Debian poderá falhar. Portanto, não esqueça de fazer o seguinte no terminal (no diretório do arquivo WML): 

$ make index.pt.html
$ tidy -e index.pt.html
Info: Doctype given is "-//W3C//DTD HTML 4.01//EN"
Info: Document content looks like HTML 4.01 Strict
No warnings or errors were found.

Após a atualização da tradução e devido teste de geração do HTML, é necessário gerar o arquivo com as alterações que foram feitas em relação ao arquivo original, que deverá ser enviado para a lista de discussão. No terminal faça: 

$ git diff -u index.wml > index.wml.patch

Agora você deve enviar uma mensagem para a lista debian-l10n-portuguese@lists.debian.org, respondendo o seu primeiro e-mail e mudando no assunto a pseudo-url de [ITT] para [RFR] conforme descrito no final desse tutorial, anexando o arquivo .patch com as alterações para que outra pessoal possa realizar a revisão. O assunto da mensagem deve começar com [RFR], por isso remova qualquer "Re" no início.

Alguém irá revisar a sua atualização, e se ela tiver alguma correção a ser feita, enviará um novo arquivo .patch. Após ver quais são as correções que o revisor enviou, você pode aceitar essas alterações ou debater na lista se elas são mesmo necessárias ou não.

Para quem vai revisar uma tradução atualizada

Para revisar uma tradução que foi atualizada e encontra-se com status RFR, é necessário baixar o arquivo que estiver anexado na mensagem para sua a cópia local do GIT, lembrando-se que o diretório raiz será portuguese, e aplicar as alterações à versão antiga do arquivo em questão. Suponhamos uma pseudo-url com [RFR] wml://www.debian.org/intro/index.wml. Nesse caso, o arquivo index.wml.patch será copiado para o diretório webwml/portuguese/intro, não esquecendo de antes atualizar a cópia local do GIT, e aplicaremos as alterações da seguinte forma: 

$ cd webwml/portuguese/intro
$ git apply index.wml.patch (você pode usar "git apply --check" para testar antes se o patch será aplicado corretamente)

Após aplicado o patch, você já pode proceder a revisão da tradução, cujo original estará em webwml/english/intro/index.wml, usando o seu editor preferido. É importante que você faça a revisão em todo o arquivo, porque a pessoa que fez a atualização pode ter esquecido de atualizar alguma parte do texto.

Ao final da revisão, caso tenha feito alguma correção, será necessário gerar um novo arquivo .patch com as alterações, que será anexado em sua resposta à mensagem na qual foi solicitada a revisão. 

$ git diff -u index.wml > index.seu-nome.wml.patch

Como criar e revisar uma nova tradução

Para quem vai criar uma nova tradução

Veja este tutorial em vídeo para ajudar a entender o processo de tradução.

Para escolher um arquivo para traduzir, você deve acessar as duas páginas abaixo:

  1. Acesse https://www.debian.org/devel/website/stats/pt#untranslated e veja a lista de arquivos no tópico "Páginas gerais não traduzidas". Escolha um desses arquivos.

  2. Depois acesse a página https://l10n.debian.org/coordination/brazilian/pt_BR.by_status.html e pesquise se o arquivo que você escolheu na outra página está listado em algum dos tópícos. Se o arquivo estiver lá, significa que alguém já está trabalhando nele. Então você deverá escolher outro arquiva na página anterior.

Antes de começar a traduzir qualquer arquivo que esteja constando como não traduzido, por favor envie uma mensagem para a lista debian-l10n-portuguese@lists.debian.org, escrevendo no assunto a pseudo-url conforme descrito no final desse tutorial, informando em qual arquivo que você pretende trabalhar, evitando assim que duas pessoas peguem o mesmo arquivo para traduzir.

Para criar novas traduções vocẽ deve utilizar o script copypage.pl existente no diretório principal webwml. Supondo que queremos traduzir o arquivo webwml/english/News/2018/20180601.wml, é necessário definirmos a variável DWWW_LANG e executar o script da seguinte forma: 

$ cd webwml
$ export DWWW_LANG=portuguese
$ ./copypage.pl english/News/2018/20180601.wml

Após isso, basta traduzir o arquivo em webwml/portuguese/News/2018/20180601.wml, usando o seu editor preferido, e adicionar a seguinte linha no cabeçalho: 

#use wml::debian::translation-check translation="<versão_do_original>"

*Obs: Para saber qual é a versão do original, basta usar o comando: 

$ git log webwml/english/News/2018/20180601.wml

Após concluir a tradução do arquivo, faça um teste para verificar se o arquivo HTML está sendo gerado corretamente. Esse teste é muito importante, pois se um arquivo WML estiver com alguma falha, seja devido a uma tag faltando ou qualquer outro motivo, o processo de reconstrução do site do Debian poderá falhar. Portanto, não esqueça de fazer o seguinte no terminal (no diretório do arquivo WML): 

$ cd webwml/portuguese/News/2018/
$ make 20180601.pt.html
$ tidy -e 20180601.pt.html
Info: Doctype given is "-//W3C//DTD HTML 4.01//EN"
Info: Document content looks like HTML 4.01 Strict
No warnings or errors were found.

Após a tradução e devido teste de geração do HTML, é necessário enviar uma mensagem para a lista debian-l10n-portuguese@lists.debian.org, escrevendo no assunto a pseudo-url conforme descrito no final desse tutorial, anexando o arquivo completo .wml para que outra pessoal possa realizar a revisão.

Alguém irá revisar a sua tradução, e se ela tiver alguma correção a ser feita, enviará um arquivo .patch. Após ver quais são as correções que o revisor enviou, você pode aceitar essas alterações ou debater na lista se elas são mesmo necessárias ou não. Para aplicar o patch enviado pelo revisor, no terminal faça: 

$ cd webwml/portuguese/News/2018/
$ patch -p0 < arquivo-enviado-pelo-revisor.patch (você pode usar "patch -p0 --dry-run" para testar antes se o patch será aplicado corretamente)
patching file index.wml

Para quem vai revisar uma nova tradução

O processo de revisão de uma nova tradução é praticamente igual ao de uma atualização de tradução. Entretanto, como não dispomos de um arquivo original já traduzido, deveremos apenas revisar o arquivo que estiver anexado à mensagem com a solicitação de revisão. Recomendamos que sejam feitas duas cópias do arquivo anexado, uma com o nome original e outra com uma variação do nome do arquivo em questão (ex: 20180601_rev.wml), para que após a conclusão da revisão, caso haja alguma correção a ser feita, possamos criar o arquivo com as alterações, da seguinte forma: 

$ diff -uN 20180601.wml 20180601_rev.wml > 20180601.wml.patch

Envie esse arquivo .patch para a lista de discussão, anexado em sua resposta à mensagem na qual foi solicitada a revisão.

Como enviar e-mails com os status das traduções

Todo o processo de tradução e revisão se dá através da lista de discussão, com o envio de mensagens que utilizam pseudo-urls. Suponhamos que você vá traduzir/atualizar o arquivo webwml/portuguese/legal/index.wml. O ciclo de trabalho da tradução ficará assim:

Para evitar que haja duas pessoas traduzindo o mesmo documento identifique o que você está traduzindo:

[ITT] wml://www.debian.org/legal/index.wml

Caso você tenha interesse em traduzir vários arquivos, você pode fazer ITT para todos de uma só vez com:

[ITT] wml://www.debian.org/legal/{index.wml,anssi.wml,patent.wml}

Após conclusão da tradução/atualização do arquivo, solicite a revisão da mesma (envie o arquivo .patch anexado), respondendo à mensagem anterior trocando o [ITT] por [RFR] no assunto, e removendo coisas como "Re:". O campo de assunto deve ter apenas:

[RFR] wml://www.debian.org/legal/index.wml

Se o primeiro revisor sugeriu muitas mudanças ou se você rejeitou várias sugestões do revisor, peça uma segunda revisão da tradução (envie o arquivo .patch anexado), respondendo à mensagem anterior com:

[RFR2] wml://www.debian.org/legal/index.wml

Adicione comentários de revisão e os envie junto com a versão final completa do arquivo, respondendo à mensagem anterior com:

[LCFC] wml://www.debian.org/legal/index.wml

Após o seu arquivo ser enviado para o GIT do Debian, por uma pessoa que tenha permissão de escrita (commiter), a mesma se encarregará de responder à mensagem anterior com:

[DONE] wml://www.debian.org/legal/index.wml

Com isso, o ciclo de trabalho da tradução estará concluído.

Qualquer dúvida entre em contato através da lista de discussão.

Fluxograma de tradução de páginas web

No intuito de ajudar as pessoas que não estão familiarizadas com o processo de tradução, resolvemos criar um fluxograma com as informações acima. Ajude-nos a melhorá-lo e envie um e-mail com sugestões para a nossa lista. https://l10n-br-team.pages.debian.net/fluxograma/Fluxograma.svg

Outros formatos do fluxograma estão disponíveis em https://l10n-br-team.pages.debian.net/fluxograma/. O repositório usado na organização do fluxograma está em https://salsa.debian.org/l10n-br-team/fluxograma.