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


NOME
       Locale::Po4a::Docbook - converte documentos DocBook XML de/para
       arquivos PO

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

       Locale::Po4a::Docbook e um modulo para ajudar a traducao de documentos
       DocBook XML em outros idiomas.

ESTADO DESTE MODULO
       Este modulo e completamente funcional, pois depende do modulo
       Locale::Po4a::Xml. Este apenas define as marcacoes e atributos
       traduziveis.

       O unico problema conhecido e que ele nao lida com entidades ainda e
       isso inclui as entidades de inclusao de arquivo, mas voce pode traduzir
       a maioria daqueles arquivos sozinhos (exceto os arquivos de entidades
       comuns) e normalmente e melhor mante-los separadamente.

SUBSTITUICAO DO COMPORTAMENTO PADRAO COM AS OPCOES DE LINHA DE COMANDO
       O comportamento padrao dos modulos fornecidos pelo sistema e
       configurado para estar no lado seguro.

       Por exemplo, o padrao da tag <author> esta apontando para aparecer em
       <para>. Mas voce pode estar usando apenas em <bookinfo>. Para este
       caso, voce pode querer traduzi-lo independentemente para cada autor.

       Se voce nao gostar do comportamento padrao do modulo xml e seus modulos
       derivados, podera fornecer opcoes de linha de comando para alterar seu
       comportamento. Por exemplo, voce pode adicionar o seguinte ao arquivo
       de configuracao po4a:

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

       Isso substitui o comportamento padrao para <bookinfo> e <author>,
       define <bookinfo> e <author> para interromper o fluxo de dados de
       entrada nesses tags , define <bookinfo> para nao traduzir seu conteudo
       marcado e defina <author> para traduzir seu conteudo marcado.

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

AUTORES
        Jordi Vilalta <jvprat@gmail.com>

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

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

perl v5.38.2                      2024-06-26      LOCALE::PO4A::DOCBOOK.3PM(1)