
        *****************************************************
        *           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::Text - converte documentos de texto 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::Text é um módulo para ajudar na tradução de documentos de
texto em outras línguas [humanas].

Os parágrafos são divididos em linhas vazias (ou linhas que contém apenas
espaços ou tabulações).

Se um parágrafo contém uma linha iniciada por um espaço (ou tabulação), este
parágrafo não será re-envolvido.

=head1 OPÇÕES ACEITES POR ESTE MÓDULO

Estas são as opções particulares deste módulo:

=over

=item B<keyvalue>

Trata como literais os parágrafos que se parecem com um par de valores-chave
separados por dois pontos (com o sinalizador C<no-wrap> no ficheiro PO). Uma
cadeia de par de valores-chave é uma cadeia como C<key: value>, contendo um
ou mais caracteres diferentes de dois pontos e não de espaço seguidos por
dois pontos seguidos por pelo menos um caractere não espacial antes do final
da linha.

=item B<nobullets>

Desativar a detecção de 'bullets'.

Por predefinição, quando um marcador é detetado, um parágrafo de marcador
não é considerado como um parágrafo literal (com a opção C<no-wrap> no
ficheiro PO). Em vez disso, realiza-se nova quebra de linha no parágrafo
correspondente na tradução.

=item B<tabs=>I<mode>

Especifica como tabulações devem ser tratadas. O I<mode> pode ser qualquer
um de:

=over

=item B<split>

Linhas com tabulações apresentam quebras no parágrafo atual.

=item B<verbatim>

Parágrafo a conter tabulações não será re-envolvido.

=back

Por predefinição, tabulações são consideradas como espaços.

=item B<breaks=>I<regex>

Uma expressão regular correspondente a linhas que introduzem pausas. A
regular expressão será ancorada de forma que toda a linha deve corresponder.

=item B<debianchangelog>

Manipula o cabeçalho e rodapé das versões de lançamento, que só podem conter
informações não traduzíveis.

=item B<fortunes>

Lida com o formato 'fortunes', que separa as 'fortunes' com uma linha que
consiste em '%' ou '%%', e usa '%%' como o início de um comentário.

=item B<markdown>

Lida com alguma marcação especial em textos formatados em Markdown.

=item B<yfm_keys> (somente Markdown)

Lista separada por vírgula de chaves para processar para tradução na secção
YAML Front Matter. Todas as outras chaves são ignoradas. As chaves são
combinadas com uma correspondência que diferencia maiúsculas de
minúsculas. Se B<yfm_paths> e B<yfm_keys> forem usadas juntas, os valores
serão incluídos se forem correspondidos por pelo menos uma das opções. Os
valores das matrizes sempre são traduzidos, a menos que a opção
B<yfm_skip_array> seja fornecida.

=item B<yfm_lenient> (somente Markdown)

Permite que o analisador YAML Front Matter falhe em cabeçalhos
malformados. Isto é particularmente útil quando o seu ficheiro começa com
uma régua horizontal em vez de YAML Front Matter, mas insiste em usar três
traços apenas para a sua régua.

=item B<yfm_paths> (somente Markdown)

=item B<yfm_paths>

Lista separada por vírgulas de caminhos hash para processar para extração na
secção YAML Front Matter; todos os outros caminhos são ignorados. Os
caminhos são combinados com uma correspondência que diferencia maiúsculas de
minúsculas. Se B<yfm_paths> e B<yfm_keys> forem usadas juntas, os valores
serão incluídos se forem correspondidos por pelo menos uma das opções. Os
valores das matrizes sempre são retornados, a menos que a opção
B<yfm_skip_array> seja fornecida.

=item B<yfm_skip_array> (somente Markdown)

Não traduz os valores de vetor na secção YAML Front Matter.

=item B<control>[B<=>I<field_list>]

Lida com ficheiros control do Debian.  Pode ser fornecida uma lista separada
por vírgulas com os campos a serem traduzidos.

=item B<neverwrap>

Evita que po4a faça a quebra de qualquer linha. Isso significa que todo
conteúdo é tratado literalmente, até mesmo parágrafos simples.

=back

=head1 ESTADO DESTE MÓDULO

Testado com sucesso em ficheiros de texto simples e ficheiros NEWS.Debian.

=head1 AUTORES

 Nicolas François <nicolas.francois@centraliens.net>

=head1 DIREITOS DE AUTOR E LICENÇA

 Copyright © 2005-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.

 Copyright © 2008-2009, 2018 Jonas Smedegaard <dr@jones.dk>.
 Copyright © 2020 Martin Quinson <mquinson#debian.org>.

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).
