PO4A-TRANSLATE.1P(1)  User Contributed Perl Documentation PO4A-TRANSLATE.1P(1)


NOME
       po4a-translate - converter um ficheiro PO de volta ao formato de
       documentacao

RESUMO
       po4a-translate -f fmt -m master.doc -p XX.po -l XX.doc

       (XX.doc e a saida, todos os outros sao entradas)

DESCRICAO
       O objetivo do projeto po4a (PO for anything: PO para qualquer coisa) e
       facilitar traducoes (e o mais interessante, a manutencao das traducoes)
       a usar as ferramentas do gettext em areas em que nao se esperava, como
       na documentacao.

       O script po4a-translate e responsavel por converter a traducao (que foi
       feita num ficheiro PO) de volta para o formato de documentacao. O
       ficheiro PO fornecido devera ser a traducao do ficheiro POT que foi
       produzido por po4a-gettextize(1).

OPCOES
       -f, --format
           O formato da documentacao que pretende processar. Use a opcao
           --help-format para ver a lista de formatos disponiveis.

       -a, --addendum
           Adicionar um ficheiro ao ficheiro resultante (para por o nome do
           tradutor ou uma seccao "Sobre esta traducao", por exemplo). A
           primeira linha do ficheiro para insercao deve ser um cabecalho PO4A
           a indicar onde ele deve ser adicionado (ver seccao COMO adicionar
           texto extra para traducoes em po4a(7)).

       -A, --addendum-charset
           Conjunto de caracteres da adenda. Note-se que todas as adendas
           devem estar no mesmo conjunto de caracteres.

       -m, --master
           Ficheiro a conter o documento principal para traduzir.

       -M, --master-charset
           Conjunto de caracteres do ficheiro que contem o documento a
           traduzir.

       -l, --localized
           Ficheiro onde o documento localizado (traduzido) deve ser escrito.

       -L, --localized-charset
           Conjunto de caracteres do ficheiro que contem o documento
           localizado.

       -p, --po
           Ficheiro a partir do qual o catalogo de mensagens deve ser lido.

       -o, --option
           Opcao/coes adicional/ais para passar ao plugin de formato. Veja a
           documentacao de cada plugin para mais informacoes sobre as opcoes
           validas e os significados deles. Por exemplo, poderia passar '-o
           tablecells' para o analisador AsciiDoc, enquanto o analisador de
           texto aceitaria '-o tabs=split'.

       -k, --keep
           Limite minimo de percentagem de traducao para manter (ou seja,
           escrever) o ficheiro resultante (predefinicao: 80). Isto e, por
           predefinicao, ficheiros tem que ser traduzidos a pelo menos 80%
           para serem escritos.

       -w, --width
           Coluna na qual devemos quebrar linha no ficheiro resultante se o
           formato suportar (padrao: 76). Se o valor fornecido for 0 ou
           negativo, o ficheiro resultante nao tera quebra de linha. Isto e
           util com alguns formatos que podem ficar danificados ao quebrar
           linha novamente.

       -h, --help
           Mostrar uma pequena mensagem de ajuda.

       --help-format
           Lista os formatos de documentacao compreendidos por po4a.

       -V, --version
           Mostrar a versao do script e sai.

       -v, --verbose
           Aumenta os detalhes do programa.

       -d, --debug
           Produz alguma informacao de depuracao.

Adicionar conteudo (alem de traducoes) para ficheiros gerados
       Para adicionar algum conteudo extra ao documento gerado alem do que
       traduziu (como o nome do tradutor ou uma seccao "Sobre essa traducao"),
       deve usar a opcao --addendum.

       A primeira linha da adenda deve ser um cabecalho a indicar onde
       coloca-lo no documento (que pode ser antes ou depois de uma determinada
       parte do documento). O resto do ficheiro sera adicionado na integra
       para o ficheiro resultante sem processamento posterior.

       Note que se po4a-translate nao conseguir adicionar um dos ficheiros
       dados, ele descarta toda a traducao (porque o ficheiro que falta
       poderia ser o que indica o autor, o que impediria aos utilizadores o
       contato com ele para reportar erros na traducao).

       O cabecalho tem uma sintaxe bastante rigida. Para mais informacoes
       sobre como usar esse recurso e como ele funciona, consulte o manual do
       po4a(7).

VEJA TAMBEM
       po4a-gettextize(1), po4a-normalize(1), po4a-updatepo(1), po4a(7)

AUTORES
        Denis Barbier <barbier@linuxfr.org>
        Nicolas Francois <nicolas.francois@centraliens.net>
        Martin Quinson (mquinson#debian.org)

DIREITOS DE AUTOR E LICENCA
       Copyright 2002-2023 por SPI, inc.

       Este programa e um software livre; pode redistribui-lo e/ou modifica-lo
       sob os termos da GPL v2.0 ou posterior (veja o ficheiro COPYING).

perl v5.42.0                      2025-11-22              PO4A-TRANSLATE.1P(1)