NOME

       debconf-gettextize - extrair traduções de templates debconf para ficheiros PO

SINOPSE

       debconf-gettextize [-v] [-h] [--podir=DIR] [--choices] [--merge] master [master ...]

DESCRIÇÃO

       Os ficheiros /var/lib/dpkg/info/*.templates lidos pelo debconf contêm texto em Inglês e traduções no
       mesmo ficheiro.  Mas nos pacotes fonte, as traduções são geridas em ficheiros separados para ajudar os
       tradutores.  Na implementação inicial, um ficheiro mestre templates continha apenas o texto em Inglês, e
       os ficheiros templates.xx continham as mensagens originais e as mensagens traduzidas para o idioma xx.  O
       programa debconf-mergetemplate juntava os ficheiros mestre e traduzidos.

       A nova implementação com "po-debconf" é baseada em "gettext".  Os maintainers marcam os campos a traduzir
       acrescentando no seu inicio um underscore, as mensagens em Inglês são automaticamente extraídas para um
       ficheiro POT, os tradutores trabalham em ficheiros PO normais, e o po2debconf gera um ficheiro combinado
       de templates com a mesma estrutura.

       O programa debconf-gettextize foi desenvolvido inicialmente para ajudar a migrar para a nova
       implementação.

       • Lê  uma  lista  de  ficheiros mestre e as suas traduções associadas, e gera ficheiros po/*.po para cada
         idioma contendo as mensagens traduzidas.

       • Cada ficheiro de entrada recebe um sufixo ".old", e um novo ficheiro mestre  sobrescreve  o  antigo;  é
         idêntico  ao  ficheiro  mestre  anterior  excepto que acrescentado no inicio um underscore aos campos a
         traduzir.  Os developers podem então escolher quais os campos em que os tradutores têm de  trabalhar  e
         quais são evitados porque os seus valores não dependem de definições locais.

       • Também  é  criado  um ficheiro po/POTFILES.in, que contém a lista de ficheiros templates que o debconf-
         updatepo tem de processar.

       Normalmente o programa debconf-gettextize tem de ser executado apenas uma vez  quando  se  transforma  da
       primeira  implementação  para  o  formato "po-debconf", mas também pode ser utilizado posteriormente para
       transformar um campo "_Choices" em "__Choices" (ou vice-versa) sem perder traduções,  quando  utilizar  a
       flag "--merge" (juntamente com "--choices", ou não).  O template desejado que contém os campos "_Choices"
       ou  "__Choices"  a modificar tem de ser copiado para um ficheiro template temporário, que é passado, como
       argumento, ao debconf-gettextize .  De seguida são executados os seguintes passos:

       1. O po2debconf é executado neste ficheiro template para gerar um ficheiro templates traduzido.

       2. O ficheiro templates traduzido é processado conforme é descrito acima e são gerados os ficheiros PO.

       3. Os ficheiros PO acabados de criar são combinados com os existentes.

       Quando os ficheiros PO são combinados, os campos "_Choices" têm de ser substituídos por  "__Choices"  (ou
       vice-versa)  no  ficheiro  templates original antes de executar debconf-updatepo, caso contrário as novas
       traduções serão marcadas como 'fuzzy'.

OPÇÕES

       -h, --help
           Mostrar um sumário de utilização para o programa e sair.

       -v, --verbose
           Processar em modo detalhado.

       --podir=DIR
           Definir o directório para os ficheiros PO.  O pré-definido é procurar ficheiros PO no  sub-directório
           po por baixo da localização do primeiro ficheiro mestre.

       --choices
           Por  omissão,  o  debconf-gettextize substitui os campos "Choices" por "_Choices". Com esta opção são
           sobrescritos, em vez disso, os campos "__Choices".

       --merge
           Quando for esta opção for definida, as mensagens são combinadas com os ficheiros PO  existentes.   Os
           ficheiros templates e po/POTFILES.in não são modificados.

AVISOS

       O  campo  "Default" é especial quando o tipo de template for "Select" ou "Multiselect", porque tem de ser
       escolhido um valor entre a lista de escolhas em Inglês, mesmo para valores traduzidos.  Normalmente  este
       campo  não  pode  ser  alterado,  mas  em  raras circunstâncias os valores traduzidos fazem sentido (e.g.
       escolher o idioma de uma aplicação).  De modo a deixar os tradutores saberem  que  este  campo  traduzido
       "Default" é especial, você tem de, por convenção, chama-lo de "_DefaultChoice" em vez de "_Default".

VEJA TAMBÉM

       debconf-updatepo(1), po2debconf(1), debconf-devel(7), po-debconf(7).

AUTORES

         Denis Barbier <barbier@linuxfr.org>
         Martin Quinson <martin.quinson@ens-lyon.fr>

                                                   2020-12-30                              DEBCONF-GETTEXTIZE(1)