
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 NOME

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

=head1 DESCRIÇÃO

O objetivo do projeto po4a (PO for anything: PO para qualquer coisa) é
facilitar traduções (e o mais interessante, a manutenção das traduções) a
usar as ferramentas do gettext em áreas em que não se esperava, como na
documentação.

Locale::Po4a::Docbook é um módulo para ajudar a tradução de documentos
DocBook XML em outras línguas [humanas].

=head1 ESTADO DESTE MÓDULO

Este módulo é totalmente funcional, uma vez que depende do módulo
L<Locale::Po4a::Xml>. Isso só define as etiquetas e atributos traduzíveis.

O único problema conhecido é que ele ainda não manipula entidades e este
inclui as entidades de inclusão de ficheiros, mas pode traduzir sozinho a
maioria destes ficheiros (exceto os ficheiros de entidades típicas), e é
geralmente melhor mantê-los separados.

=head1 SOBREPOR O COMPORTAMENTO PREDEFINIDO COM AS OPÇÕES DE LINHA DE COMANDO

O comportamento predefinido dos módulos fornecidos pelo sistema é
configurado para estar no lado seguro.

Por exemplo, a predefinição da etiqueta B<< <author> >> está a apontar para
aparecer em B<< <para> >>. Mas pode estar a usar apenas em B<< <bookinfo>
>>. Para este caso, pode traduzi-lo independentemente para cada autor.

Se não gostar do comportamento predefinido do módulo xml e os módulos
derivados dele, poderá fornecer opções de linha de comando para alterar o
comportamento deles. Por exemplo, pode adicionar o seguinte ao ficheiro de
configuração po4a:

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

Isto substitui o comportamento predefinido para B<< <bookinfo> >> e B<<
<author> >>, define B<< <bookinfo> >> e B<< <author> >> para interromper o
fluxo de dados de entrada nessas etiquetas , define B<< <bookinfo> >> para
não traduzir o conteúdo marcado dele e define B<< <author> >> para traduzir
o conteúdo marcado dele.

=head1 VEJA TAMBÉM

L<Locale::Po4a::TransTractor(3pm)>, L<Locale::Po4a::Xml(3pm)>,
L<po4a(7)|po4a.7>

=head1 AUTORES

 Jordi Vilalta <jvprat@gmail.com>

=head1 DIREITOS DE AUTOR E LICENÇA

 Copyright © 2004 Jordi Vilalta  <jvprat@gmail.com>
 Copyright © 2007-2009 Nicolas François <nicolas.francois@centraliens.net>

Este programa é um software livre; pode redistribuí-lo e/ou modificá-lo sob
os termos da GPL v2.0 ou posterior (veja o ficheiro COPYING).
