Manual do usuário do dpo-tools

O dpo-tools é um conjunto de shell scripts que podem auxiliar na tradução de arquivos podebconf do Debian.

Para mais informações sobre o dpo-tools, visite a página do dpo-tools na Internet.

Obtendo o dpo-tools

Para obter uma cópia do dpo-tools, visite a página do dpo-tools na Internet e baixe uma cópia do seu código fonte.

Lembre-se de substituir o número de versão nos exemplos a seguir pelo número da última versão disponível do dpo-tools:

  1. Baixe o código fonte do dpo-tools:

    wget https://www.arg.eti.br/blog/pages/software/dpo-tools/dpo-tools_1.2.tgz
    
    
  2. Descompacte o arquivo com o código fonte:

    tar zxvf dpo-tools_1.2.tgz
    
    
  3. Copie os arquivos executáveis para algum diretório do seu PATH:

    cp dpo-* ~/bin/
    
    

    ou:

    sudo cp dpo-* /usr/local/bin/
    
    

Dependências

O dpo-tools depende de outros programas para funcionar corretamente. Você deve ter os seguintes programas principais instalados em seu computador:

  • utilitários do gettext: msgfmt, msgcat, msgmerge
  • awk
  • colordiff

Para instalá-los em um sistema Debian ou derivado:

sudo aptitude install gettext gawk colordiff

Você vai querer também usar o programa podebconf-display-po. Para instalá-lo em um sistema Debian ou derivado:

sudo aptitude install po-debconf

README

A seguir está o conteúdo do arquivo README distribuído com o código fonte do dpo-tools:

README

dpo-tools é um conjunto de shell scripts que podem auxiliar na tradução de arquivos podebconf. dpo-tools não dita nenhuma regra de como as traduções devem ser feitas, ele apenas tenta refletir as convenções usadas na lista debian-l10n-portuguese@lists.debian.org.

Os scripts são os seguintes:

  • dpo-get-templates faz o download de um arquivo templates.pot a partir do repositório de templates podebconf
  • dpo-init-po cria e inicializa um arquivo podebconf a partir de um arquivo de templates
  • dpo-apply-templates atualiza um arquivo podebconf com uma nova versão de seu arquivo de templates
  • dpo-apply-compendium atualiza um arquivo podebconf com strings já traduzidas, a partir de um arquivo compendium
  • dpo-check verifica se o arquivo podebconf está bem formado
  • dpo-diff apresenta informações no formato diff de forma colorida e paginada
  • dpo-make-patch cria um arquivo de patch baseado em duas versões de um arquivo podebconf
  • dpo-wrap quebra as linhas de um arquivo podebconf na coluna 80

INSTALAÇÃO

Copie os scripts para algum diretório que fique em seu PATH.

CONFIGURAÇÃO

  • dpo-init-po.awk: ajuste as variáveis NOME e EMAIL. Se você usa o gawk, a variável ANO deve ser ajustada no início de cada ano. Você pode descomentar a linha que detecta automaticamente o ano, se o seu interpretador awk tiver suporte à função strftime().
  • dpo-init.po: edite a última linha do arquivo para refletir o caminho completo do arquivo dpo-init.po.awk, por exemplo: ~/bin/dpo-init-po.awk
  • dpo-make-patch: ajuste a variável ID com as iniciais do seu nome.
  • dpo-apply-compendium: ajuste a variável COMPENDIUM para refletir o caminho completo do arquivo de compendium, baixado de http://i18n.debian.org/compendia/pt_BR/

DESINSTALAÇÃO

Apenas remova os scripts.

EXEMPLOS

  1. Para iniciar uma nova tradução: a seguinte sequência de comandos faz o download de um arquivo de templates podebconf, cria um arquivo podebconf baseado no arquivo de templates baixado, inicializa o arquivo podebconf com informações frequentemente usadas, atualiza o arquivo podebconf com strings do compendium, edita o arquivo podebconf, quebra as linhas do arquivo podebconf na coluna 80, verifica se o arquivo podebconf está bem formado e testa a exibição do arquivo podebconf:

    $ dpo-get-templates pacote
    $ dpo-init-po pacote_version_templates.pot
    $ dpo-apply-compendium pacote_pt_BR.po
    $ vi pacote_pt_BR.po
    $ dpo-wrap pacote_pt_BR.po
    $ dpo-check pacote_pt_BR.po
    $ podebconf-display-po pacote_pt_BR.po
    $ # envie o arquivo pacote_pt_BR.po para RFR
    
    
  2. Para revisar uma tradução feita por outro tradutor e gerar um patch com sugestões de alteração:

    # substitua "eu" por suas iniciais nos comandos a seguir
    $ cp pacote_pt_BR.po pacote_pt_BR.eu.po
    $ vi pacote_pt_BR.eu.po
    $ dpo-wrap pacote_pt_BR.eu.po
    $ dpo-check pacote_pt_BR.eu.po
    $ podebconf-display-po pacote_pt_BR.eu.po
    $ dpo-make-patch pacote_pt_BR.po
    $ # envie o arquivo de patch gerado, respondendo ao RFR
    
    
  3. Para aplicar uma nova versão do arquivo de templates a um arquivo podebconf já traduzido anteriormente:

    $ dpo-get-templates pacote_pt_BR.po
    $ dpo-apply-templates pacote_pt_BR.po
    
    

AUTOR

Escrito por Adriano Rafael Gomes adrianorg@arg.eti.br.

COPYRIGHT

Copyright (C) 2008,2012 Adriano Rafael Gomes.
Licença GPLv3+: GNU GPL versão 3 ou posterior http://gnu.org/licenses/gpl.html.
This is free software: you are free to change and redistribute it.
There is NO WARRANTY, to the extent permitted by law.