Entendendo as pseudo-URLs

Visando controle de qualidade, a equipe brasileira de tradução do Debian, assim como outras que fazem parte da força-tarefa de internacionalização, adotou um procedimento padrão que utiliza pseudo-URLs na troca de mensagens por e-mail. Esse processo possibilita a coleta e a geração de informações sobre o estado das traduções utilizando certas expressões no assunto dos e-mails enviados para a lista de discussão debian-l10n-portuguese. Esta nomenclatura é comumente conhecida como pseudo-url.


Pseudo-URLs

Existe um programa (robô) que acompanha a lista debian-l10n-portuguese e que consegue compreender as pseudo-URLs no campo assunto. Uma pseudo-url tem o seguinte formato:

        [<estado>] <tipo>://<pacote>/<arquivo>

Estado

O estado pode ser escolhido entre um dos seguintes:

Tipo

O tipo relaciona-se ao documento, por exemplo: po-debconf, debian-installer, po, man ou wml.

Pacote

O pacote é o nome do pacote de onde vem o documento.

Arquivo

O arquivo é o nome do arquivo do documento e pode conter outras informações como o caminho para o arquivo ou a seção para a página de manual. Desse modo, nenhum outro documento no mesmo pacote será referenciado da mesma maneira.


Exemplos de pseudo-URLs

A estrutura do nome depende da escolha do tipo. Em princípio é apenas um identificador, mas é fortemente recomendado seguir as seguintes regras:


Processo pela lista de e-mails

Obs: uma síntese desse procedimento pode ser encontrada em Como usar a lista de e-mails.

Inicialmente, você envia um ITT para registrar no que vai trabalhar. Atente para o formato da pseudo-url. Quando estiver com a tradução pronta, responda ao seu próprio ITT e altere o campo de assunto da mensagem para RFR. Alguém vai revisar o seu trabalho, vocês poderão debater até chegar a um consenso. A seguir, mude o assunto para LCFC. Após algum tempo sem comentários, é hora de mandar sua tradução para o BTS.

Note que a pseudo-url é mantida, mudando-se apenas a etiqueta do estado. Não troque a etiqueta e nem o formato dela, senão o robô não entenderá. Mantenha-se fiel ao formato, seja cuidadoso com o nome do pacote. Se houver muitas modificações entre um RFR e um LCFC, você poderá registrar um RFR2.

Sistema de rastreamento de bugs

<!> ToDo: esta seção deve ser movida para a frente de tradução correspondente.

O estado do BTS é algo especial, é utilizado para registrar o número do BUG. Assim, o l10n-bot pode rastrear o estado da tradução desde que você envie para o BTS. Diariamente ele verificará se um bug aberto foi fechado. Um exemplo desse comando:

        [BTS#1234] po-debconf://cups/pt_BR.po

Se você tem intenção de traduzir vários pacotes, poderá fazer ITT para todos de uma só vez. Um exemplo:

        [ITT] po-debconf://{cups,courier,apache}/pt_BR.po

Coloque os pacotes entre chaves e separados por vírgulas. Sem espaços extras!


Detalhes importantes ao realizar uma tradução

<!> ToDo: esta seção deve ser movida para a frente de tradução correspondente.

Sobre a tradução em si, independente do arquivo, mantenha as linhas com até 80 colunas. Algumas pessoas trabalham no terminal em servidores remotos via SSH e não é legal ter linhas quebradas. Teste seus potfiles usando:

$ msgfmt -c -v -o /dev/null <arquivo.po>

Se for um po-debconf, teste também com:

$ podebconf-display-po <arquivo.po>

Fique atento(a) com a codificação do arquivo, pois usamos UTF-8 tanto para o site quanto para os po-debconf e demais POs. Preencha os arquivos com todos os cabeçalhos necessários, se tiver dúvidas não hesite em perguntar na lista de discussão.

Não existe um tempo máximo para finalizar as traduções. Você terá que aguardar que pelo menos uma revisão aconteça. Elas podem demorar ou podem ser bem rápidas, depende da disponibilidade da equipe.

Nas primeiras vezes, comece devagar, com um ou dois arquivos para evitar erros iguais em vários arquivos. Na primeira vez que for reportar o bug, mande o modelo para a l10n-portuguese primeiro para que possamos revisar e mandá-lo pronto para o(a) mantenedor(a).

Se estiver atualizando uma tradução, mande o arquivo original, o diff e o seu arquivo traduzido. Se estiver fazendo uma nova tradução, mande essa informação no e-mail.


CategoryTeams