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 [humana].

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

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

SUBSTITUICAO DO 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>\""

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

VER 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>

       This program is free software; you may redistribute it and/or modify it
       under the terms of GPL v2.0 or later (see the COPYING file).

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