LOCALE::PO4A::DOCBOOK.3PM(1)               User Contributed Perl Documentation


NOME
       Locale::Po4a::Docbook - converter documentos DocBook XML de/para
       ficheiros PO

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.

       Locale::Po4a::Docbook e um modulo para ajudar a traducao de documentos
       DocBook XML em outras linguas [humanas].

ESTADO DESTE MODULO
       Este modulo e totalmente funcional, uma vez que depende do modulo
       Locale::Po4a::Xml. Isso so define as etiquetas e atributos traduziveis.

       O unico problema conhecido e que ele ainda nao manipula entidades e
       este inclui as entidades de inclusao de ficheiros, mas pode traduzir
       sozinho a maioria destes ficheiros (exceto os ficheiros de entidades
       tipicas), e e geralmente melhor mante-los separados.

SOBREPOR O COMPORTAMENTO PREDEFINIDO COM AS OPCOES DE LINHA DE COMANDO
       O comportamento predefinido dos modulos fornecidos pelo sistema e
       configurado para estar no lado seguro.

       Por exemplo, a predefinicao da etiqueta <author> esta a apontar para
       aparecer em <para>. Mas pode estar a usar apenas em <bookinfo>. Para
       este caso, pode traduzi-lo independentemente para cada autor.

       Se nao gostar do comportamento predefinido do modulo xml e os modulos
       derivados dele, podera fornecer opcoes de linha de comando para alterar
       o comportamento deles. Por exemplo, pode adicionar o seguinte ao
       ficheiro de configuracao po4a:

         opt:"-k 0 -o nodefault=\"<bookinfo> <author>\" \
                   -o break=\"<bookinfo> <author>\" \
                   -o untranslated=\"<bookinfo>\" \
                   -o translated=\"<author>\""

       Isto substitui o comportamento predefinido para <bookinfo> e <author>,
       define <bookinfo> e <author> para interromper o fluxo de dados de
       entrada nessas etiquetas , define <bookinfo> para nao traduzir o
       conteudo marcado dele e define <author> para traduzir o conteudo
       marcado dele.

VEJA TAMBEM
       Locale::Po4a::TransTractor(3pm), Locale::Po4a::Xml(3pm), po4a(7)

AUTORES
        Jordi Vilalta <jvprat@gmail.com>

DIREITOS DE AUTOR E LICENCA
        Copyright (C) 2004 Jordi Vilalta  <jvprat@gmail.com>
        Copyright (C) 2007-2009 Nicolas Francois <nicolas.francois@centraliens.net>

       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      LOCALE::PO4A::DOCBOOK.3PM(1)