po4a 0.45 - en to pt_BR translation catalogue (998 entries)

note: type: Attribute 'xml:lang' of: <refentry>
en: en
pt_BR: pt_BR

note: type: Content of: <refentry><refmeta><refmiscinfo>
en: Po4a Tools
pt_BR: Ferramentas do Po4a

note: type: Content of: <refentry><refnamediv><refpurpose>
en: display a translated man page according to a PO
pt_BR: exibe uma página man traduzida de acordo com um PO

note: type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
en: <command>po4a-display-man</command> <arg choice='plain'><option>-p</option> </arg> <arg choice='plain'><replaceable>PO_FILE</replaceable></arg> <arg choice='opt'><arg choice='plain'><option>-m</option> </arg><arg choice='plain'><replaceable>MASTER_FILE</replaceable></arg></arg> <arg choice='opt'><arg choice='plain'><option>-o</option> </arg><arg choice='plain'><replaceable>PO4A_OPT</replaceable></arg></arg>
pt_BR: <command>po4a-display-man</command> <arg choice='plain'><option>-p</option> </arg> <arg choice='plain'><replaceable>ARQUIVO_PO</replaceable></arg> <arg choice='opt'><arg choice='plain'><option>-m</option> </arg><arg choice='plain'><replaceable>ARQUIVO_MESTRE</replaceable></arg></arg> <arg choice='opt'><arg choice='plain'><option>-o</option> </arg><arg choice='plain'><replaceable>OPT_PO4A</replaceable></arg></arg>

note: type: =head1
en: DESCRIPTION
pt_BR: DESCRIÇÃO

note: type: Content of: <refentry><refsect1><para>
en: Translators can use <command>po4a-display-man</command> to see how their translation of a man page will be rendered to the end users, without recompiling and reinstalling the whole project.
pt_BR: Os tradutores podem usar <command>po4a-display-man</command> para ver como sua tradução de uma página man será renderizada para os usuários finais, sem recompilar e reinstalar todo o projeto.

note: type: Content of: <refentry><refsect1><para>
en: This script only works with man pages written directly in <emphasis remap='I'>nroff</emphasis> and handled by the po4a's <emphasis remap='I'>man</emphasis> module.  Manual pages generated from other formats, like DocBook or POD, are not supported.  See <citerefentry><refentrytitle>po4a-display-pod</refentrytitle><manvolnum>1</manvolnum></citerefentry> for an equivalent supporting <emphasis remap='I'>POD</emphasis> documents.
pt_BR: Este script só funciona com páginas man escritas diretamente em <emphasis remap='I'>nroff</emphasis> e manipulado pelo módulo <emphasis remap='I'>man</emphasis>. Páginas de manual de outros formatos, como DocBook ou POD, não são suportadas. Veja <citerefentry><refentrytitle>po4a-display-pod</refentrytitle><manvolnum>1</manvolnum></citerefentry> para um suporte equivalente a documentos <emphasis remap='I'>POD</emphasis>.

note: type: =head1
en: OPTIONS
pt_BR: OPÇÕES

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>-p </option><replaceable>PO_FILE</replaceable>
pt_BR: <option>-p </option><replaceable>ARQUIVO_PO</replaceable>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The PO file containing the translations.
pt_BR: O arquivo PO contendo as traduções.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>-m </option><replaceable>MASTER_FILE</replaceable>
pt_BR: <option>-m </option><replaceable>ARQUIVO_MESTRE</replaceable>

note: .br type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The original man page.  It can be the absolute or relative path to the original man page (gzipped or not), the name of the man page or the name and section of the man page (using the man.section format).  When the master document is not provided with the <option>-m</option> option, <command>po4a-display-man</command> tries to find the original man page based on the line reference of the first string in the PO.
pt_BR: A página man original. Pode ser o caminho absoluto ou relativo da página man original (em gzip ou não), o nome da página man ou do nome e seção da página man (usando o formato man.seção). Quando o documento mestre não é fornecido com a opção <option>-m</option>, <command>po4a-display-pod</command> tenta localizar a página man original baseada na linha de referência da primeira string do PO.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>-o </option><replaceable>PO4A_OPT</replaceable>
pt_BR: <option>-o </option><replaceable>OPT_PO4A</replaceable>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: Some options to pass to <citerefentry><refentrytitle>po4a-translate</refentrytitle><manvolnum>1</manvolnum></citerefentry>.
pt_BR: Algumas opções para passar para <citerefentry><refentrytitle>po4a-translate</refentrytitle><manvolnum>1</manvolnum></citerefentry>.

note: type: =head1
en: SEE ALSO
pt_BR: VEJA TAMBÉM

note: type: Content of: <refentry><refsect1><title>
en: AUTHOR
pt_BR: AUTOR

note: type: Content of: <refentry><refnamediv><refpurpose>
en: display of a translated POD file according to a PO
pt_BR: exibe um arquivo POD traduzido de acordo com um PO

note: type: Content of: <refentry><refsynopsisdiv><cmdsynopsis>
en: <command>po4a-display-pod</command> <arg choice='plain'><option>-p </option></arg> <arg choice='plain'><replaceable>PO_FILE</replaceable></arg> <arg choice='plain'><option>-m </option></arg> <arg choice='plain'><replaceable>POD_FILE</replaceable></arg> <arg choice='opt'><arg choice='plain'><option>-o </option></arg><arg choice='plain'><replaceable>PO4A_OPT</replaceable></arg></arg>
pt_BR: <command>po4a-display-pod</command> <arg choice='plain'><option>-p </option></arg> <arg choice='plain'><replaceable>ARQUIVO_PO</replaceable></arg> <arg choice='plain'><option>-m </option></arg> <arg choice='plain'><replaceable>ARQUIVO_POD</replaceable></arg> <arg choice='opt'><arg choice='plain'><option>-o </option></arg><arg choice='plain'><replaceable>OPT_PO4A</replaceable></arg></arg>

note: type: Content of: <refentry><refsect1><para>
en: Translators can use <command>po4a-display-pod</command> to see how their translation of a man page will be rendered to the end users, without recompiling and reinstalling the whole project.  Most of the time, the POD file is only available in source package or embedded in Perl script.
pt_BR: Os tradutores podem usar <command>po4a-display-pod</command> para ver como sua tradução de uma página man será renderizada para os usuários finais, sem recompilar e reinstalar todo o projeto.  Na maioria das vezes, o arquivo POD só está disponível no pacote fonte ou incorporado no script Perl.

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><term>
en: <option>-m </option><replaceable>POD_FILE</replaceable>
pt_BR: <option>-m </option><replaceable>ARQUIVO_POD</replaceable>

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The original POD file used by po4a to generate PO file.
pt_BR: O arquivo POD original usado pelo po4a para gerar o arquivo PO.

note: type: =head1
en: NAME
pt_BR: NOME

note: type: textblock
en: po4a - update both the PO files and translated documents in one shot
pt_BR: po4a - atualiza ambos arquivos PO e documentações traduzidas em um tiro

note: type: =head1
en: SYNOPSIS
pt_BR: SINOPSE

note: type: textblock
en: B<po4a> [I<options>] I<config_file>
pt_BR: B<po4a> [I<opções>] I<arquivo_config>

note: type: textblock
en: po4a (PO for anything) eases the maintenance of documentation translation using the classical gettext tools. The main feature of po4a is that it decouples the translation of content from its document structure.  Please refer to the page L<po4a(7)> for a gentle introduction to this project.
pt_BR: po4a (PO for anything) facilita a manutenção de tradução da documentação usando as ferramentas clássicas do gettext. A principal característica do po4a é que ele dissocia a tradução do conteúdo da estrutura documental. Consulte a página L<po4a(7)> para uma introdução suave a este projeto.

note: type: textblock
en: Minimal threshold for translation percentage to keep (i.e. write) the resulting file (default: 80). I.e. by default, files have to be translated at least at 80% to be written on disk.
pt_BR: Limite mínimo de porcentagem de tradução para manter (i.e. escrever) o arquivo resultante (padrão: 80). Isto é, por padrão, arquivos têm que estar traduzidos em pelo menos 80% para serem escritos no disco.

note: type: textblock
en: Show a short help message.
pt_BR: Mostra uma mensagem de ajuda.

note: type: textblock
en: Charset of the files containing the documents to translate. Note that all master documents must use the same charset.
pt_BR: Conjunto de caracteres dos arquivos contendo os documentos para traduzir. Note que todos os documentos mestres devem usar o mesmo conjunto de caracteres.

note: type: textblock
en: Charset of the files containing the localized documents. Note that all translated documents will use the same charset.
pt_BR: Conjunto de caracteres dos arquivos contendo os documentos localizados. Note que todos os documentos traduzidos devem usar o mesmo conjunto de caracteres.

note: type: textblock
en: Charset of the addenda. Note that all the addenda should be in the same charset.
pt_BR: Conjunto de caracteres dos adendos. Note que todos os adendos deveriam ser do mesmo conjunto de caracteres.

note: type: textblock
en: Display the version of the script and exit.
pt_BR: Exibe a versão do script e sai.

note: type: textblock
en: Increase the verbosity of the program.
pt_BR: Aumenta o nível de detalhamento do programa.

note: type: textblock
en: Decrease the verbosity of the program.
pt_BR: Reduz o nível de detalhamento do programa.

note: type: textblock
en: Output some debugging information.
pt_BR: Imprime algumas informações de depuração.

note: type: textblock
en: Extra option(s) to pass to the format plugin. See the documentation of each plugin for more information about the valid options and their meanings. For example, you could pass '-o tablecells' to the AsciiDoc parser, while the text parser would accept '-o tabs=split'.
pt_BR: Opções extras para passar o plug-in de formato. Veja a documentação de cada plug-in para mais informações sobre as opções válidas e seus significados. Por exemplo, você poderia passar "-o tablecells" para o analisador AsciiDoc, enquanto o analisador de texto aceitaria "-o tabs=split".

note: type: textblock
en: Always generate the POT and PO files, even if B<po4a> considers it is not necessary.
pt_BR: Sempre gera os aquivos POT e PO, mesmo se B<po4a> considera isso desnecessário.

note: type: textblock
en: The default behavior (when B<--force> is not specified) is the following:
pt_BR: O comportamento padrão (quando B<--force> não é especificado) é o seguinte:

note: type: textblock
en: If the POT file already exists, it is regenerated if a master document or the configuration file is more recent (unless B<--no-update> is provided).  The POT file is also written in a temporary document and B<po4a> verifies that the changes are really needed.
pt_BR: Se o arquivo POT já existe, ele é regerado se uma documentação mestre ou arquivo de configuração for mais recente (a menos B<--no-update> seja fornecido). O POT também é escrito em um documento temporário e B<po4a> certifica-se de que as alterações são realmente necessárias.

note: type: textblock
en: Also, a translation is regenerated only if its master document, the PO file, one of its addenda or the configuration file is more recent.  To avoid trying to regenerate translations which do not pass the threshold test (see B<--keep>), a file with the F<.po4a-stamp> extension can be created (see B<--stamp>).
pt_BR: Também, uma tradução é gerada novamente apenas se seu documento mestre, o arquivo PO, um desses adendos ou arquivo de configuração é mais recente. Para evitar tentativa de gerar traduções que não passam no teste de limite (veja B<--keep>), um arquivo com a extensão F<.po4a-stamp> pode ser criada (veja B<--stamp>).

note: type: textblock
en: If a master document includes files, you should use the B<--force> flag because the modification time of these included files are not taken into account.
pt_BR: Se um documento mestre inclui arquivos, você deveria usar a opção B<--force> porque o horário de modificação desses arquivos incluídos não são levados em consideração.

note: type: textblock
en: The PO files are always re-generated based on the POT with B<msgmerge -U>.
pt_BR: Os arquivos PO são gerados novamente baseados no POT com B<msgmerge -U>.

note: type: textblock
en: Tells B<po4a> to create stamp files when a translation is not generated because it does not reach the threshold. These stamp files are named according to the expected translated document, with the F<.po4a-stamp> extension.
pt_BR: Informa ao B<po4a> para criar arquivos stamp quando uma tradução não é gerada porque ela não atingiu o limite. Esses arquivos stamp são nomeados de acordo com o documento de tradução esperado, com a extensão F<.po4a-stamp>.

note: type: textblock
en: Note: This only activates the creation of the F<.po4a-stamp> files. The stamp files are always used if they exist, and they are removed with B<--rm-translations> or when the file is finally translated.
pt_BR: Nota: Isso somente ativa a criação dos arquivos F<.po4a-stamp>. Os arquivos stamp são sempre usados se existirem e eles são removidos com B<--rm-translations> ou quando o arquivo é finalmente traduzido.

note: type: textblock
en: Do not generate the translated documents, only update the POT and PO files.
pt_BR: Não gera os documentos traduzidos, apenas atualiza os arquivos POT e PO.

note: type: textblock
en: Do not change the POT and PO files, only the translation may be updated.
pt_BR: Não altere os arquivos POT e PO, apenas a tradução pode ser atualizada.

note: type: textblock
en: Keeps the existing translation files even if the translation doesn't meet the threshold specified by B<--keep>.  This option does not create new translation files with few content, but it will save existing translations which decay because of changes to the master files.
pt_BR: Mantém os arquivos de tradução existentes mesmo se a tradução não atender o limite especificado por B<--keep>.  Essa opção não cria novos arquivos de tradução com pouco conteúdo, mas vai salvar traduções existentes que cujo nível decai por causa de alterações nos arquivos de mestre.

note: type: textblock
en: WARNING: This flag changes the po4a behavior in a rather drastic way: your translated files will not get updated at all until the translation improves. Only use this flag if you prefer shipping an outdated translated documentation rather than only shipping an accurate untranslated documentation.
pt_BR: ATENÇÃO: Esta opção muda o comportamento do po4a de uma maneira bastante drástica: seus arquivos traduzidos não serão atualizados até que a tradução melhore. Use esta opção somente se você preferir enviar uma documentação traduzida desatualizada em vez de enviar apenas uma documentação não traduzida precisa.

note: type: textblock
en: Remove the translated files (implies B<--no-translations>).
pt_BR: Remove os arquivos de tradução (implica em B<--no-translations>).

note: type: textblock
en: This flag does nothing since 0.41, and may be removed in later releases.
pt_BR: Essa opção não faz nada desde 0.41 e pode ser removida em versões posteriores.

note: type: =item
en: B<--translate-only> I<translated-file>
pt_BR: B<--translate-only> I<arquivo-traduzido>

note: type: textblock
en: Translate only the specified file.  It may be useful to speed up processing if a configuration file contains a lot of files.  Note that this option does not update PO and POT files.  This option can be used multiple times.
pt_BR: Traduz apenas o arquivo especificado. Pode ser útil para agilizar o processamento se um arquivo de configuração contém muitos arquivos. Note que essa opção não atualiza arquivos POT e PO. Essa opção pode ser usada múltiplas vezes.

note: type: =item
en: B<--variable> I<var>B<=>I<value>
pt_BR: B<--variable> I<var>B<=>I<valor>

note: type: textblock
en: Define a variable that will be expanded in the B<po4a> configuration file.  Every occurrence of I<$(var)> will be replaced by I<value>.  This option can be used multiple times.
pt_BR: Define uma variável que vai ser expandida no arquivo de configuração do B<po4a>. Toda ocorrência de I<$(var)> vai ser substituída por I<valor>. Essa opção pode ser usada múltiplas vezes.

note: type: textblock
en: Set the base directory for all input documents specified in the B<po4a> configuration file.
pt_BR: Define o diretório base para todos os documentos de entradas especificados no arquivo de configuração do B<po4a>.

note: type: textblock
en: If both I<destdir> and I<srcdir> are specified, input files are searched in the following directories, in order: I<destdir>, the current directory and I<srcdir>. Output files are written to I<destdir> if specified, or to the current directory.
pt_BR: Se I<destdir> e I<srcdir> forem especificados, os arquivos de entrada serão pesquisados nos seguintes diretórios, em ordem: I<destdir>, o diretório atual e I<srcdir>. Os arquivos de saída são gravados em I<destdir>, se especificado, ou no diretório atual.

note: type: textblock
en: Set the base directory for all the output documents specified in the B<po4a> configuration file (see B<--srcdir> above).
pt_BR: Define o diretório base para todos os documentos de saída especificados no arquivo de configuração do B<po4a> (veja B<--srcdir> acima).

note: type: =head2
en: Options modifying the POT header
pt_BR: Opções que modificam o cabeçalho do POT

note: type: =item
en: B<--porefs> I<type>
pt_BR: B<--porefs> I<tipo>

note: type: textblock
en: Specify the reference format. Argument I<type> can be one of B<never> to not produce any reference, B<file> to only specify the file without the line number, B<counter> to replace line number by an increasing counter, and B<full> to include complete references (default: full).
pt_BR: Especifica o formato de referência. O argumento I<tipo> pode ser um de: B<never> para não produzir qualquer referência, B<file> para especificar o arquivo sem o número de linha, B<counter> para substituir os números de linha aumentando o contador e B<full> para incluir referências completas. (padrão: full).

note: type: =item
en: B<--wrap-po> B<no>|B<newlines>|I<number> (default: 76)
pt_BR: B<--wrap-po> B<no>|B<newlines>|I<number> (padrão: 76)

note: type: textblock
en: Specify how the po file should be wrapped. This gives the choice between either files that are nicely wrapped but could lead to git conflicts, or files that are easier to handle automatically, but harder to read for humans.
pt_BR: Especifica como o arquivo po deve ter sua quebra de linha. Isso permite escolher entre arquivos que tem boa quebra de linha, mas que podem levar a conflitos de git, ou arquivos que são mais fáceis de manipular automaticamente, mas mais difíceis de ler para humanos.

note: type: textblock
en: Historically, the gettext suite has reformatted the po files at the 77th column for cosmetics. This option specifies the behavior of po4a. If set to a numerical value, po4a will wrap the po file after this column and after newlines in the content. If set to B<newlines>, po4a will only split the msgid and msgstr after newlines in the content. If set to B<no>, po4a will not wrap the po file at all.  The reference comments are always wrapped by the gettext tools that we use internally.
pt_BR: Historicamente, o pacote gettext reformatou os arquivos po na 77ª coluna para questões cosméticas. Esta opção especifica o comportamento de po4a. Se definido como um valor numérico, o po4a quebrará linha do arquivo po após esta coluna e após novas linhas no conteúdo. Se definido como B<newlines>, o po4a dividirá apenas o msgid e o msgstr após as novas linhas no conteúdo. Se definido como B<no>, o po4a não quebrará linha do arquivo po. Os comentários de referência têm sempre as linhas quebradas pelas ferramentas do gettext que nós usamos internamente.

note: type: textblock
en: Note that this option has no impact on how the msgid and msgstr are wrapped, i.e.  on how newlines are added to the content of these strings.
pt_BR: Observe que esta opção não afeta a maneira como o msgid e o msgstr sofrem quebra de linhas, ou seja, como os caracteres de nova linha são adicionados ao conteúdo dessas strings.

note: type: textblock
en: Language of the source files containing the documents to translate. Note that all master documents must use the same language.
pt_BR: Idioma dos arquivos fonte contendo os documentos para traduzir. Note que todos os documentos mestres devem usar o mesmo idioma.

note: type: =item
en: B<--msgid-bugs-address> I<email@address>
pt_BR: B<--msgid-bugs-address> I<e-mail@endereço>

note: type: textblock
en: Set the report address for msgid bugs. By default, the created POT files have no Report-Msgid-Bugs-To fields.
pt_BR: Define o endereço para relatórios de erros em msgids. Por padrão, os arquivos POT criados possuem nenhum campo Report-Msgid-Bugs-To.

note: type: textblock
en: Set the copyright holder in the POT header. The default value is "Free Software Foundation, Inc."
pt_BR: Define o detentor do copyright no cabeçalho do POT. O valor padrão é "Free Software Foundation, Inc."

note: type: textblock
en: Set the package name for the POT header. The default is "PACKAGE".
pt_BR: Define o nome do pacote para o cabeçalho do POT. O padrão é "PACKAGE".

note: type: textblock
en: Set the package version for the POT header. The default is "VERSION".
pt_BR: Define a versão do pacote do cabeçalho do POT. O padrão é "VERSION".

note: type: =head2
en: Options to modify the PO files
pt_BR: Opções para modificar os arquivos PO

note: type: =item
en: B<--msgmerge-opt> I<options>
pt_BR: B<--msgmerge-opt> I<opções>

note: type: textblock
en: Extra options for B<msgmerge>(1).
pt_BR: Opções extras para B<msgmerge>(1).

note: type: textblock
en: Note: B<$lang> will be extended to the current language.
pt_BR: Nota: B<$lang> vai estar estendida do idioma atual.

note: type: textblock
en: This option removes B<--previous> from the options passed to B<msgmerge>.  This is necessary to support versions of B<gettext> earlier than 0.16.
pt_BR: Essa opção remove B<--previous> das opções passadas ao B<msgmerge>. Isso é necessário para oferecer suporte a versões do B<gettext> antes de 0.16.

note: type: textblock
en: This option adds B<--previous> to the options passed to B<msgmerge>.  It requires B<gettext> 0.16 or later, and is activated by default.
pt_BR: Essa opção adiciona B<--previous> às opções passadas ao B<msgmerge>. Isso requer B<gettext> 0.16 ou posterior, e é ativada por padrão.

note: type: =head1
en: CONFIGURATION FILE
pt_BR: ARQUIVO DE CONFIGURAÇÃO

note: type: textblock
en: po4a expects a configuration file as argument. This file must contain the following elements:
pt_BR: po4a espera um arquivo de configuração como argumento. Este arquivo deve conter os seguintes elementos:

note: type: textblock
en: The path to the PO files and the list of languages existing in the project;
pt_BR: O caminho para os arquivos PO e a lista de idiomas existentes no projeto;

note: type: textblock
en: Optionally, some global options and so-called configuration aliases that are used as templates to configure individual master files;
pt_BR: Opcionalmente, algumas opções globais e os chamados aliases de configuração que são usados como modelos para configurar arquivos mestres individuais ;

note: type: textblock
en: The list of each master file to translate, along with specific parameters.
pt_BR: A lista de cada arquivo mestre a traduzir, juntamente com parâmetros específicos.

note: type: textblock
en: All lines contain a command between square braces, followed by its parameters.  Comments begin with the char '#' and run until the end of the line. You can escape the end of line to spread a command over several lines.
pt_BR: Todas as linhas contêm um comando entre colchetes, seguido dos seus parâmetros.  Os comentários começam com o caractere "#" e correm até ao fim da linha. Você pode escapar do fim da linha para espalhar um comando por várias linhas.

note: type: textblock
en: Some full examples are presented on this page, while other examples can be found in the C<t/cfg> directory of the source distribution.
pt_BR: Alguns exemplos completos são apresentados nesta página, enquanto outros exemplos podem ser encontrados no diretório C<t/cfg> da distribuição de origem.

note: type: =head2
en: Finding the PO and POT files
pt_BR: Encontrando os arquivos PO e POT

note: type: textblock
en: The simplest solution is to explicitly give the path to POT and PO files, as follows:
pt_BR: A solução mais simples é dar explicitamente o caminho para arquivos POT e PO, da seguinte forma:

note: type: textblock
en: This specifies the path to the POT file first, and then the paths to the German and French PO files.
pt_BR: Isso especifica o caminho para o arquivo POT primeiro e, em seguida, os caminhos para os arquivos PO alemão e francês.

note: type: textblock
en: The same information can be written as follows to reduce the risk of copy/paste errors:
pt_BR: A mesma informação pode ser escrita da seguinte maneira para reduzir o risco de erros de copiar/colar:

note: type: textblock
en: The C<$lang> component is automatically expanded using the provided languages list, reducing the risk of copy/paste error when a new language is added.
pt_BR: O componente C<$lang> é gasto automaticamente usando a lista de idiomas fornecidos, reduzindo o risco de erro de copiar/colar quando um novo idioma é adicionado.

note: type: textblock
en: You can further compact the same information by only providing the path to the directory containing your translation project, as follows.
pt_BR: Você pode compactar ainda mais as mesmas informações fornecendo apenas o caminho para o diretório contendo seu projeto de tradução, da forma a seguir.

note: type: textblock
en: The provided directory must contain a set of PO files, each named F<XX.po> with C<XX> the ISO 639-1 of the language used in this file. The directory must also contain a single POT file, with the C<.pot> file extension. For the first run, this file can be empty but it must exist (po4a cannot guess the name to use before the extension).
pt_BR: O diretório fornecido deve conter um conjunto de arquivos PO, cada um chamado F<XX.po> com C<XX> o ISO 631-1 do idioma utilizado neste arquivo. O diretório deve conter também um único arquivo POT, com a extensão C<.pot> file. Para a primeira execução, este arquivo pode estar vazio, mas deve existir (po4a não pode adivinhar o nome a ser usado antes da extensão).

note: type: textblock
en: Note that you must choose only one between C<po_directory> and C<po4a_paths>. The first one (C<po_directory>) is more compact, further reduces the risk of copy/paste error, but forces you to use the expected project structure and file names. The second one (C<po4a_paths>), is more explicit, probably more readable, and advised when you setup your first project with po4a.
pt_BR: Observe que você deve escolher apenas um entre C<po_directory> e C<po4a_paths>. O primeiro (C<po_directory>) é mais compacto, reduz ainda mais o risco de erro de cópia/pasta, mas força você a usar a estrutura de projeto esperada e nomes de arquivos. O segundo (C<po4a_paths>), é mais explícito, provavelmente mais legível, e aconselhado quando você configura seu primeiro projeto com po4a.

note: type: =head3
en: Centralized or split PO files?
pt_BR: Arquivos PO centralizados ou divididos?

note: type: textblock
en: By default, po4a produces one single PO file per target language, containing the whole content of your translation project. As your project grows, the size of these files may become problematic. When using weblate, it is possible to specify priorities for each translation segment (i.e., msgid) so that the important ones get translated first. Still, some translation teams prefer to split the content in several files.
pt_BR: Por padrão, o po4a produz um único arquivo PO por idioma de destino, contendo todo o conteúdo do seu projeto de tradução. Conforme o seu projeto cresce, o tamanho desses arquivos pode se tornar problemático. Ao utilizar weblate, é possível especificar prioridades para cada segmento de tradução (isto é, msgid), de modo que os importantes sejam traduzidos primeiro. Mesmo assim, algumas equipes de tradução preferem dividir o conteúdo em vários arquivos.

note: type: textblock
en: To have one PO file per master file, you simply have to use the string C<$master> in the name of your PO files on the C<[po4a_paths]> line, as follows.
pt_BR: Para ter um arquivo PO por arquivo mestre, basta usar a string C<$master> no nome dos arquivos PO na linha C<[po4a_paths]>, da seguinte maneira.

note: type: textblock
en: In split mode, B<po4a> builds a temporary compendium during the PO update, to share the translations between all the PO files. If two PO files have different translations for the same string, B<po4a> will mark this string as fuzzy and will submit both translations in all the PO files containing this string. When unfuzzied by the translator, the translation is automatically used in every PO files.
pt_BR: No modo de divisão, B<po4a> cria um compêndio temporário durante a atualização do PO, para compartilhar as traduções entre todos os arquivos do pedido. Se dois arquivos PO tiverem traduções diferentes para a mesma string, B<po4a> marcará essa string como difusa e enviará ambas as traduções em todos os arquivos PO que contêm essa string. Quando não é confundida pelo tradutor, a tradução é usada em todos os arquivos PO automaticamente.

note: type: =head2
en: Specifying the documents to translate
pt_BR: Especificando os documentos para traduzir

note: type: textblock
en: You must also list the documents that should be translated. For each master file, you must specify the format parser to use, the location of the translated document to produce, and optionally some configuration. Here is an example:
pt_BR: Você também deve listar os documentos que devem ser traduzidos. Para cada arquivo mestre, você deve especificar o analisador de formato a ser usado, o local do documento traduzido a ser produzido e, opcionalmente, alguma configuração. Aqui está um exemplo:

note: type: textblock
en: But again, these complex lines are difficult to read and modify, e.g. when adding a new language. It is much simpler to reorganize things using the C<$lang> template as follows:
pt_BR: Mas, novamente, essas linhas complexas são difíceis de ler e modificar, por exemplo, ao adicionar um novo idioma. É muito mais simples reorganizar as coisas usando o modelo C<$lang> da seguinte maneira:

note: type: =head2
en: Specifying options
pt_BR: Especificando opções

note: type: textblock
en: There is two types of options: I<po4a options> are default values to the po4a command line options while I<format options> are used to change the behavior of the format parsers. As a I<po4a options>, you could for example specify in your configuration file that the default value of the B<--keep> command line parameter is 50% instead of 80%. I<Format options> are documented on the specific page of each parsing module, e.g. L<Locale::Po4a::Xml(3pm)>. You could for example pass B<nostrip> to the XML parser to not strip the spaces around the extracted strings.
pt_BR: Há dois tipos de opções: I<opções do po4a> são valores padrão para as opções de linha de comando po4a enquanto I<opções de formato> são usadas para alterar o comportamento dos analisadores de formato. Como uma I<opções do po4a>, você pode, por exemplo, especificar em seu arquivo de configuração que o valor padrão do parâmetro de linha de comando B<--keep> é de 50% em vez de 80%. I<Opções de formato> estão documentadas na página específica de cada módulo de análise, por exemplo, L<Locale::Po4a::Xml(3pm)>. Você pode, por exemplo, passar B<nostrip> para o analisador XML para não remover os espaços ao redor das strings extraídas.

note: type: textblock
en: You can pass these options for a specific master file, or even for a specific translation of that file, using C<opt:> and C<opt_XX:> for the C<XX> language.  In the following example, the B<nostrip> option is passed to the XML parser (for all languages), while the threshold will be reduced to 0% for the French translation (that is thus always kept).
pt_BR: Você pode passar essas opções para um arquivo mestre específico, ou mesmo para uma tradução específica desse arquivo, usando C<opt:> e C<opt_XX:> para o idioma C<XX>. No exemplo a seguir, a opção B<nostrip> é passada para o analisador XML (para todos os idiomas), enquanto o limite será reduzido para 0% para a tradução em francês (que, portanto, é sempre mantida).

note: type: textblock
en: In any case, these configuration chunks must be located at the end of the line.  The declaration of files must come first, then the addendum if any (see below), and then only the options. The grouping of configuration chunks is not very important, since elements are internally concatenated as strings. The following examples are all equivalent:
pt_BR: De qualquer forma, esses blocos de configuração devem estar localizados no final da linha. A declaração dos arquivos deve vir primeiro, depois o adendo, se houver (veja abaixo), e somente as opções. O agrupamento de pedaços de configuração não é muito importante, pois os elementos são internamente concatenados como strings. Os exemplos a seguir são todos equivalentes:

note: type: textblock
en: Note that language specific options are not used when building the POT file. It is for example impossible to pass B<nostrip> to the parser only when building the French translation, because the same POT file is used to update every languages. So the only options that can be language-specific are the ones that are used when producing the translation, as the C<--keep> option.
pt_BR: Observe que as opções específicas do idioma não são usadas ao criar o arquivo POT. Por exemplo, é impossível passar B<nostrip> para o analisador apenas ao criar a tradução em francês, porque o mesmo arquivo POT é usado para atualizar todos os idiomas. Portanto, as únicas opções que podem ser específicas do idioma são as usadas na produção da tradução, como a opção C<--keep>.

note: type: =head3
en: Configuration aliases
pt_BR: Aliases de configuração

note: type: textblock
en: To pass the same options to several files, the best is to define a type alias as follows. In the next example, C<--keep 0> is passed to every Italian translation using this C<test> type, that is an extension of the C<man> type.
pt_BR: Para passar as mesmas opções para vários arquivos, o melhor é definir um alias de tipo da seguinte maneira. No próximo exemplo, C<--keep 0> é passado para todas as traduções em italiano usando este tipo C<test>, que é uma extensão do tipo C<man>.

note: type: textblock
en: You can also extend an existing type reusing the same name for the alias as follows. This is not interpreted as as an erroneous recursive definition.
pt_BR: Você também pode estender um tipo existente de reutilizar o mesmo nome para o alias da seguinte forma. Este não é interpretada como uma errônea definição recursiva.

note: type: =head3
en: Global default options
pt_BR: Opções padrão globais

note: type: textblock
en: You can also use C<[options]> lines to define options that must be used for all files, regardless of their type.
pt_BR: Você também pode usar as linhas C<[options]> para definir opções que devem ser usadas para todos os arquivos, independentemente do seu tipo.

note: type: textblock
en: As with the command line options, you can abbreviate the parameters passed in the configuration file:
pt_BR: Como nas opções da linha de comando, você pode abreviar os parâmetros passados no arquivo de configuração:

note: type: =head3
en: Option priorities
pt_BR: Prioridades das opções

note: type: textblock
en: The options of every sources are concatenated, ensuring that the default values can easily be overridden by more specific options. The order is as follows:
pt_BR: As opções de todas as fontes são concatenadas, garantindo que os valores padrão possam ser facilmente substituídos por opções mais específicas. A ordem é a seguinte:

note: type: textblock
en: C<[options]> lines provide default values that can be overridden by any other source.
pt_BR: As linhas C<[options]> fornecem valores padrão que podem ser substituídos por qualquer outra fonte.

note: type: textblock
en: Type aliases are then used. Language specific settings override the ones applicable to all languages.
pt_BR: Os aliases de tipo são então usados. As configurações específicas do idioma substituem as aplicáveis a todos os idiomas.

note: type: textblock
en: Settings that are specific to a given master file override both the default ones and the ones coming from the type alias. In this case also, language specific settings override the global ones.
pt_BR: As configurações específicas de um determinado arquivo mestre substituem as padrão e as provenientes do alias de tipo. Também neste caso, as configurações específicas do idioma substituem as globais.

note: type: textblock
en: Finally, parameters provided on the B<po4a> command line override any settings from the configuration file.
pt_BR: Finalmente, os parâmetros fornecidos na linha de comando B<po4a> substituem quaisquer configurações do arquivo de configuração.

note: type: =head3
en: Example
pt_BR: Exemplo

note: type: textblock
en: Here is an example showing how to quote the spaces and quotes:
pt_BR: Aqui está um exemplo mostrando como citar os espaços e aspas:

note: type: =head2
en: Addendum: Adding extra content in the translation
pt_BR: Adendo: Acréscimo de conteúdo extra na tradução

note: type: textblock
en: If you want to add an extra section to the translation, for example to give credit to the translator, then you need to define an addendum to the line defining your master file. Please refer to the page L<po4a(7)> for more details on the syntax of addendum files.
pt_BR: Se você deseja adicionar uma seção extra à tradução, por exemplo, para dar crédito ao tradutor, é necessário definir um adendo à linha que define seu arquivo mestre. Consulte a página L<po4a(7)> para obter mais detalhes sobre a sintaxe dos arquivos de adendo.

note: type: textblock
en: You can also use language templates as follow:
pt_BR: Você também pode usar modelos de idioma da seguinte maneira:

note: type: textblock
en: If an addendum fails to apply, the translation is discarded.
pt_BR: Se um adendo não se aplicar, a tradução será descartada.

note: type: =head3
en: Modifiers for the addendum declaration
pt_BR: Modificadores para a declaração de adendo

note: type: textblock
en: Addendum modifiers can simplify the configuration file in the case where not all languages provide an addendum, or when the list of addenda changes from one language to the other. The modifier is a single char located before the file name.
pt_BR: Os modificadores de adendo podem simplificar o arquivo de configuração no caso em que nem todos os idiomas fornecem um adendo ou quando a lista de adendos muda de um idioma para o outro. O modificador é um único caractere localizado antes do nome do arquivo.

note: type: textblock
en: Include I<addendum_path> if this file does exist, otherwise do nothing.
pt_BR: Inclua I<addendum_path> se esse arquivo não existir, do contrário nada para fazer.

note: type: textblock
en: I<addendum_path> is not a regular addendum but a file containing a list of addenda, one by line.  Each addendum may be preceded by modifiers.
pt_BR: I<addendum_path> não é um adendo regular, mas um arquivo contendo uma lista de adendos, uma por linha. Cada adendo pode ser precedido por modificadores.

note: type: textblock
en: I<addendum_path> is discarded, it is not loaded and will not be loaded by any further addendum specification.
pt_BR: I<addendum_path> está descartado, ele não é carregado e não vai ser carregado por qualquer uma especificação de adendo.

note: type: textblock
en: The following includes an addendum in any language, but if only it exists. No error is reported if the addendum does not exist.
pt_BR: O seguinte inclui um adendo em qualquer idioma, mas se existir. Nenhum erro será relatado se o adendo não existir.

note: type: textblock
en: The following includes a list of addendum for every language:
pt_BR: O seguinte inclui uma lista de adendos para cada idioma:

note: type: =head2
en: Filtering the translated strings
pt_BR: Filtrando as strings traduzidas

note: type: textblock
en: Sometimes, you want to hide some strings from the translation process. To that extend, you can give a C<pot_in> parameter to your master file to specify the name of the file to use instead of the real master when building the POT file. Here is an example:
pt_BR: Às vezes, você deseja ocultar algumas strings do processo de tradução. Nesse sentido, você pode atribuir um parâmetro C<pot_in> ao seu arquivo mestre para especificar o nome do arquivo a ser usado em vez do mestre real ao criar o arquivo POT. Aqui está um exemplo:

note: type: textblock
en: With this setting, the strings to translate will be extracted from the F<book-filtered.xml> (that must be produced before calling B<po4a>) while the translated files will be built from F<book.xml>. As a result, any string that is part of F<book.xml> but not in F<book-filtered.xml> will not be included in the PO files, preventing the translators from providing a translation for them. So these strings will be left unmodified when producing the translated documents.  This naturally decreases the level of translation, so you may need the C<--keep> option to ensure that the document is produced anyway.
pt_BR: Com essa configuração, as strings a serem traduzidas serão extraídas do F<book-filter.xml> (que deve ser produzido antes da chamada de B<po4a>) enquanto os arquivos traduzidos serão compilados a partir do F<book.xml>. Como resultado, qualquer string que faça parte de F<book.xml>, mas não em F<book-filter.xml> não será incluída nos arquivos PO, impedindo que os tradutores forneçam uma tradução para eles. Portanto, essas strings não serão modificadas ao produzir os documentos traduzidos. Isso naturalmente diminui o nível de tradução, portanto, você pode precisar da opção C<--keep> para garantir que o documento seja produzido de qualquer maneira.

note: type: =head1
en: AUTHORS
pt_BR: AUTORES

note: type: =head1
en: COPYRIGHT AND LICENSE
pt_BR: COPYRIGHT E LICENÇA

note: type: textblock
en: This program is free software; you may redistribute it and/or modify it under the terms of GPL (see the COPYING file).
pt_BR: Esse programa é um software livre; você pode redistribuí-lo e/ou modificá-lo sob os termos da GPL (veja o arquivo COPYING).

note: type: textblock
en: po4a-gettextize - convert an original file (and its translation) to a PO file
pt_BR: po4a-gettextize - converte um arquivo original (e suas traduções) para um arquivo PO

note: type: textblock
en: (I<XX.po> is the output, all others are inputs)
pt_BR: (I<XX.po> é a saída, e todo o resto é entrada)

note: type: textblock
en: Format of the documentation you want to handle. Use the B<--help-format> option to see the list of available formats.
pt_BR: Formato da documentação que você quer manipular. Use a opção B<--help-format> para ver a lista de formatos disponíveis.

note: type: textblock
en: File containing the master document to translate. You can use this option multiple times if you want to gettextize multiple documents.
pt_BR: Arquivo contendo o documento mestre para traduzir. Você pode usar esta opção múltiplas vezes, se você quiser usar gettextize em múltiplos documentos.

note: type: textblock
en: Charset of the file containing the document to translate.
pt_BR: Conjunto de caracteres do arquivo contendo o documento para traduzir.

note: type: textblock
en: File containing the localized (translated) document. If you provided multiple master files, you may wish to provide multiple localized file by using this option more than once.
pt_BR: Arquivo contendo o documento localizado (traduzido). Se você forneceu múltiplos arquivos mestre, você pode desejar fornecer múltiplos arquivos localizados usando esta opção mais de uma vez.

note: type: textblock
en: Charset of the file containing the localized document.
pt_BR: Conjunto de caracteres do arquivo contendo o documento localizado.

note: type: textblock
en: File where the message catalog should be written. If not given, the message catalog will be written to the standard output.
pt_BR: Arquivo para o qual a mensagem deve ser escrita. Se não fornecido, o catálogo de mensagens será escrito para a saída padrão.

note: type: textblock
en: List the documentation formats understood by po4a.
pt_BR: Lista os formatos de documentação compreendidos pelo po4a.

note: type: textblock
en: Keep the temporary master and localized POT files built before merging.  This can be useful to understand why these files get desynchronized, leading to gettextization problems
pt_BR: Mantém o mestre temporário e os arquivos POT localizados criados antes da mesclagem. Isso pode ser útil para entender por que esses arquivos são dessincronizados, levando a problemas de gettextização

note: type: =head2
en: Converting a manual translation to po4a
pt_BR: Convertendo uma tradução manual em po4a

note: type: verbatim
en:     Original         Translation
pt_BR:     Original           Tradução

note: type: verbatim
en:   chapter            chapter
        paragraph          paragraph
        paragraph          paragraph
        paragraph        chapter
      chapter              paragraph
        paragraph          paragraph
pt_BR:   capítulo           capítulo
        parágrafo          parágrafo
        parágrafo          parágrafo
        parágrafo        capítulo
      capítulo              parágrafo
        parágrafo          parágrafo

note: type: =head3
en: Hints and tricks for the gettextization process
pt_BR: Dicas e truques para o processo de gettextização

note: type: textblock
en: Do not hesitate to kill any original content that would not exist in the translated version. This content will be automatically reintroduced afterward, when synchronizing the PO file with the document.
pt_BR: Não hesite em eliminar qualquer conteúdo original que não exista na versão traduzida. Este conteúdo será reintroduzido automaticamente posteriormente, ao sincronizar o arquivo PO com o documento.

note: type: textblock
en: Sometimes, the paragraph content does match, but not their types. Fixing it is rather format-dependent. In POD and man, it often comes from the fact that one of them contains a line beginning with a white space while the other does not.  In those formats, such paragraph cannot be wrapped and thus become a different type. Just remove the space and you are fine. It may also be a typo in the tag name in XML.
pt_BR: Algumas vezes, o conteúdo do parágrafo não corresponde, mas não os seus tipos. Corrigir isso é até dependente do formato. No POD e man, frequentemente ele vem do fato que um deles contém uma linha começando com espaço em branco, enquanto a outra não. Naqueles formatos, tal parágrafo não pode ser dimensionado e, então, se torna um tipo diferente. Basta remover o espaço e está terminado. Pode ser um erro de escrita no nome da marcação em XML.

note: type: textblock
en: Likewise, two paragraphs may get merged together in POD when the separating line contains some spaces, or when there is no empty line between the B<=item> line and the content of the item.
pt_BR: Da mesma forma, dois parágrafos podem ser mesclados no POD quando a linha separadora contém alguns espaços ou quando não há linha vazia entre a linha B<=item> e o conteúdo do item.

note: type: textblock
en: po4a-normalize - normalize a documentation file by parsing it in po4a, and writing it back
pt_BR: po4a-normalize - normaliza um arquivo de documentação analisando-o no po4a e escrevendo de volta

note: type: textblock
en: B<po4a-normalize> B<-f> I<fmt> I<master.doc>
pt_BR: B<po4a-normalize> B<-f> I<fmt> I<mestre.doc>

note: type: textblock
en: The po4a (PO for anything) project goal is to ease translations (and more interestingly, the maintenance of translations) using gettext tools on areas where they were not expected like documentation.
pt_BR: O objetivo do projeto po4a (PO for anything, ou PO para qualquer coisa) é facilitar traduções (e o mais interessante, a manutenção das traduções) usando as ferramentas do gettext em áreas em que não se esperava, como documentação.

note: type: textblock
en: The B<po4a-normalize> script is a debugging tool used to make sure that po4a don't change the document when it's not supposed to. Only use it if you're developing a new module, or if you doubt the sanity of the tools.
pt_BR: O script B<po4a-normalize> é uma ferramenta de depuração usada para certificar-se de que po4a não altere o documento quando não deveria. Apenas use-o se você está desenvolvendo um novo módulo ou se você duvida da sanidade das ferramentas.

note: type: textblock
en: The generated document will be written to F<po4a-normalize.output> while the generated POT file will be written to F<po4a-normalize.po> by default, but you can use the B<--localized> and B<--pot> options to change that.
pt_BR: O documento gerado vai ser escrito para F<po4a-normalize.output> enquanto o arquivo POT gerado vai ser escrito para F<po4a-normalize.po> por padrão, mas você pode usar as opções B<--localized> e B<--pot> para alterar isso.

note: type: textblock
en: Create an blank translated document.  The generated translated document will be generated assuming all messages are translated by a space or new line.
pt_BR: Cria um documento traduzido em branco. O documento trazido gerado vai ser gerado supondo que todas as mensagens estão traduzidas por um espaço ou nova linha.

note: type: textblock
en: This is useful to check what parts of the document cannot be translated.
pt_BR: Isso é útil para verificar quais partes do documento não pode ser traduzido.

note: type: textblock
en: Name of the normalized file to produce (I<po4a-normalize.output> by default).
pt_BR: Nome do arquivo normalizado para produzir (I<po4a-normalize.output> por padrão).

note: type: textblock
en: Pot file to produce (I<po4a-normalize.po> by default).
pt_BR: Arquivo pot a ser produzido (I<po4a-normalize.po> por padrão).

note: type: textblock
en: Copyright 2002-2020 by SPI, inc.
pt_BR: Copyright 2002-2020 por SPI, inc.

note: type: textblock
en: po4a-translate - convert a PO file back to documentation format
pt_BR: po4a-translate - converte um arquivo PO de volta para o formato de documentação

note: type: textblock
en: B<po4a-translate> B<-f> I<fmt> B<-m> I<master.doc> B<-p> I<XX.po> B<-l> I<XX.doc>
pt_BR: B<po4a-translate> B<-f> I<fmt> B<-m> I<mestre.doc> B<-p> I<XX.po> B<-l> I<XX.doc>

note: type: textblock
en: (I<XX.doc> is the output, all others are inputs)
pt_BR: (I<XX.doc> é a saída, todos outros são entrada)

note: type: textblock
en: The B<po4a-translate> script is in charge of converting the translation (which was done in a PO file) back into the documentation format. The provided PO file should be the translation of the POT file which was produced by L<po4a-gettextize(1)>.
pt_BR: O script B<po4a-translate> está encarregado da conversão da tradução (que foi feito em um arquivo PO) de volta para o formato de documentação. O arquivo PO fornecido deveria ser a tradução do arquivo POT, o qual foi fornecido por L<po4a-gettextize(1)>.

note: type: textblock
en: Add a file to the resulting file (to put translator's name or a section "About this translation", for example). The first line of the file to insert should be a PO4A header indicating where it should be added (see section B<HOWTO add extra text to translations> in L<po4a(7)>).
pt_BR: Adiciona um arquivo ao arquivo resultante (para colocar o nome do tradutor ou uma seção "Sobre esta tradução", por exemplo). A primeira linha do arquivo para inserir deveria ser um cabeçalho PO4A indicando para onde ele deveria ser adicionado (veja a seção B<Como adicionar um texto extra a traduções> em L<po4a(7)>).

note: type: textblock
en: File containing the master document to translate.
pt_BR: Arquivo contendo o documento mestre para traduzir.

note: type: textblock
en: File where the localized (translated) document should be written.
pt_BR: Arquivo para o qual o documento localizado (traduzido) deveria ser escrito.

note: type: textblock
en: File from which the message catalog should be read.
pt_BR: Arquivo do qual o catálogo de mensagens deveria ser lido.

note: type: textblock
en: Minimal threshold for translation percentage to keep (i.e. write) the resulting file (default: 80). I.e. by default, files have to be translated at least at 80% to get written.
pt_BR: Limite mínimo de porcentagem de tradução para manter (i.e. escrever) o arquivo resultante (padrão: 80). I.e. por padrão, arquivos têm que ser traduzido em pelo menos 80% para ser escrito.

note: type: textblock
en: Column at which we should wrap the resulting file.
pt_BR: Coluna na qual nós deveríamos quebrar a linha do arquivo resultante.

note: type: =item
en: B<--porefs> I<type>[,B<wrap>|B<nowrap>]
pt_BR: B<--porefs> I<tipo>[,B<wrap>|B<nowrap>]

note: type: textblock
en: Argument can be followed by a comma and either B<wrap> or B<nowrap> keyword.  References are written by default on a single line.  The B<wrap> option wraps references on several lines, to mimic B<gettext> tools (B<xgettext> and B<msgmerge>).  This option will become the default in a future release, because it is more sensible.  The B<nowrap> option is available so that users who want to keep the old behavior can do so.
pt_BR: Argumento pode estar seguido por uma vírgula e as palavras-chaves B<wrap> ou B<nowrap>. Referências são escritas por padrão em uma única linha. A opção B<wrap> quebra as referências em várias linhas, para copiar as ferramentas do B<gettext> (B<xgettext> e B<msgmerge>). Essa opção vai se tornar o padrão em um lançamento futuro, mas ela é mais sensível. A opção B<nowrap> está disponível de forma que usuários que desejarem manter o comportamento antigo podem fazê-lo.

note: type: textblock
en: Historically, the gettext suite has reformatted the po files at the 77th column for cosmetics. This option specifies the behavior of po4a. If set to a numerical value, po4a will wrap the po file after this column and after newlines in the content. If set to B<newlines>, po4a will only split the msgid and msgstr after newlines in the content. If set to B<no>, po4a will not wrap the po file at all.  The wrapping of the reference comments is controlled by the B<--porefs> option.
pt_BR: Historicamente, o pacote gettext reformatou os arquivos po na 77ª coluna para questões cosméticas. Esta opção especifica o comportamento de po4a. Se definido como um valor numérico, o po4a quebrará linha do arquivo po após esta coluna e após novas linhas no conteúdo. Se definido como B<newlines>, o po4a dividirá apenas o msgid e o msgstr após as novas linhas no conteúdo. Se definido como B<no>, o po4a não quebrará linha do arquivo po. A quebra de linha dos comentários de referência é controlado pela opção B<--porefs>.

note: type: textblock
en: Note that this option has no impact on how the msgid and msgstr are wrapped, ie on how newlines are added to the content of these strings.
pt_BR: Observe que esta opção não afeta a maneira como o msgid e o msgstr sofrem quebra de linhas, ou seja, como os caracteres de nova linha são adicionados ao conteúdo dessas strings.

note: type: =head1
en: Adding content (beside translations) to generated files
pt_BR: Adicionando conteúdo (além de traduções) a arquivos gerados

note: type: textblock
en: To add some extra content to the generated document beside what you translated (like the name of the translator, or an "About this translation" section), you should use the B<--addendum> option.
pt_BR: Para adicionar algum conteúdo extra para o documento gerado além do que você traduziu (como o nome do tradutor ou uma seção "Sobre essa tradução"), você deveria usar a opção B<--addendum>.

note: type: textblock
en: The first line of the addendum must be a header indicating where to put it in the document (it can be before or after a given part of the document).  The rest of the file will be added verbatim to the resulting file without further processing.
pt_BR: A primeira linha do adendo deve ser um cabeçalho indicando onde colocá-lo no documento (pode ser antes ou depois de uma parte determinada do documento). O resto do arquivo será adicionado literalmente ao arquivo resultante sem processamento adicional.

note: type: textblock
en: Note that if po4a-translate fails to add one of the given files, it discards the whole translation (because the missing file could be the one indicating the author, what would prevent the users to contact him to report bugs in the translation).
pt_BR: Note que se o po4a-translate falha ao adicionar um dos arquivos fornecidos, ele descarta toda a tradução (porque o arquivo que faltou poderia ser um indicando o autor, o que iria evitar que usuários contatassem-no para relatar erros na tradução).

note: type: textblock
en: The header has a pretty rigid syntax. For more information on how to use this feature and how it works, please refer to the L<po4a(7)> man page.
pt_BR: O cabeçalho possui uma sintaxe bem rígida. Para mais informações sobre como usar esse recurso ou como ele funciona, veja a página man L<po4a(7)>.

note: type: textblock
en: po4a-updatepo - update the translation (in PO format) of documentation
pt_BR: po4a-updatepo - atualiza a tradução (no formato PO) da documentação

note: type: textblock
en: B<po4a-updatepo> B<-f> I<fmt> (B<-m> I<master.doc>)+ (B<-p> I<XX.po>)+
pt_BR: B<po4a-updatepo> B<-f> I<fmt> (B<-m> I<mestre.doc>)+ (B<-p> I<XX.po>)+

note: type: textblock
en: (I<XX.po> are the outputs, all others are inputs)
pt_BR: (I<XX.po> são as saídas, todos os outros são entradas)

note: type: textblock
en: The B<po4a-updatepo> script is in charge of updating PO files to make them reflect the changes made to the original documentation file. For that, it converts the documentation file to a POT file, and call L<msgmerge(1)> on this new POT and on the provided PO files.
pt_BR: O script B<po4a-updatepo> está encarregado da atualização de arquivos PO para que eles reflitam as alterações feitas no arquivo original de documentação. Para isso, ele converte o arquivo de documentação para um arquivo POT e chama L<msgmerge(1)> neste novo POT e nos arquivos PO fornecidos.

note: type: textblock
en: It is possible to give more than one PO file (if you want to update several languages at once), and several documentation files (if you want to store the translations of several documents in the same PO file).
pt_BR: É possível informar mais do que um arquivo PO (se você quer atualizar vários idiomas de uma só vez) e vários arquivos de documentação (se você quiser armazenar as traduções de vários documentos no mesmo arquivo PO).

note: type: textblock
en: If the master document has non-ASCII characters, this script will convert the PO files to UTF-8 (if they weren't already), for a transparent handling of non-standard characters.
pt_BR: Se a documentação mestre possui caracteres não-ASCII, este script vai converter os arquivos PO para UTF-8 (se eles não já estão), para uma manipulação transparente de caracteres fora do padrão.

note: type: textblock
en: File(s) containing the master document to translate.
pt_BR: Arquivo(s) contendo o documento mestre para traduzir.

note: type: textblock
en: Charset of the files containing the document to translate. Note that all files must have the same charset.
pt_BR: Conjunto de caracteres dos arquivos contendo o documento para traduzir. Note que todos os arquivos devem possuir o mesmo conjunto de caracteres.

note: type: textblock
en: PO file(s) to update. If these files do not exist, they are created by B<po4a-updatepo>.
pt_BR: Arquivo(s) PO para atualizar. Se esses arquivos não existirem, eles serão criados pelo B<po4a-updatepo>.

note: type: textblock
en: msguntypot - update PO files when a typo is fixed in POT file
pt_BR: msguntypot - atualiza arquivos PO quando um erro é corrigido no arquivo POT

note: type: textblock
en: B<msguntypot> B<-o> I<old_pot> B<-n> I<new_pot> I<pofiles> ...
pt_BR: B<msguntypot> B<-o> I<pot_antigo> B<-n> I<pot_novo> I<arquivospo> ...

note: type: textblock
en: When you fix a trivial error which surely doesn't affect translations (e.g.  a typo) in a POT file, you should unfuzzy the corresponding msgstr in the translated PO files to avoid so extra work to the translators.
pt_BR: Quando você corrigir um arquivo trivial que com certeza não afeta as traduções (ex: um erro de escrita) em um arquivo POT, você deveria retirar a marcação de aproximada ("fuzzy") da msgstr correspondente nos arquivos PO traduzidos para evitar trabalho extra para os tradutores.

note: type: textblock
en: This task is difficult and error prone when done manually, and this tool is there to help doing so correctly. You just need to provide the two versions of the POT file: before the edition and after as marked in the above synopsis, and it all becomes automatic.
pt_BR: Essa tarefa é difícil e propensa a erros quando feita manualmente, e essa ferramenta está aqui para ajudá-lo a fazê-la corretamente. Você apenas precisa fornecer as duas versões do arquivo POT: antes da edição e depois como marcado na sinopse acima e tudo se torna automático.

note: type: =head1
en: HOW TO USE IT
pt_BR: COMO USAR ELE

note: type: textblock
en: In short, when you discover a typo in one of your [english] message, do the following:
pt_BR: Em poucas palavras, quando você descobre um erro de escrita me uma das suas mensagens [em inglês], faça o seguinte:

note: type: =item
en: - Regenerate your POT and PO files.
pt_BR: - Gere seus arquivo POT e PO novamente.

note: type: verbatim
en:   make -C po/ update-po # for message program translations
      debconf-updatepo      # for debconf translations
      po4a po4a.conf        # for po4a based documentation translations
pt_BR:   make -C po/ update-po # para tradução de mensagens de programas
      debconf-updatepo      # para traduções de debconf
      po4a po4a.conf        # para traduções de documentação baseada em po4a

note: type: textblock
en: or something else, depending on your project's building settings. You know how to make sure your POT and PO files are uptodate, don't you??
pt_BR: Ou outra coisa, dependendo das configurações de compilação do seu projeto. Você sabe como certificar-se de que seus arquivos POT e PO estão atualizados, não é??

note: type: =item
en: - Make a copy of your POT file.
pt_BR: - Faça uma cópia do seu arquivo POT.

note: type: verbatim
en:   cp myfile.pot myfile.pot.orig
pt_BR:   cp meuarquivo.pot meuarquivo.pot.orig

note: type: =item
en: - Make a copy of all your PO files.
pt_BR: - Faça uma cópia dos seus arquivos PO.

note: type: verbatim
en:   mkdir po_fridge; cp *.po po_fridge
pt_BR:   mkdir geladeira_de_po; cp *.po geladeira_de_po

note: type: =item
en: - Fix your typo.
pt_BR: - Corrija seu erro de escrita.

note: type: textblock
en: $EDITOR the_file_in_which_there_is_a_typo
pt_BR: $EDITOR o_arquivo_no_qual_está_o_erro

note: type: textblock
en: See above.
pt_BR: Veja acima.

note: type: textblock
en: At this point, the typo fix fuzzied all the translations, and this unfortunate change is the only one between the PO files of your main directory and the one from the fridge. Here is how to solve this.
pt_BR: A esse ponto, a correção do erro marca como aproximada (fuzzy) todas as traduções e esta alteração infeliz é a única entre os arquivos PO no seu diretório principal e aquele dentro da geladeira. Aqui está o como podemos resolver isso.

note: type: =item
en: - Discard fuzzy translation, restore the ones from the fridge.
pt_BR: - Descarte as traduções aproximadas, restaurar aquelas da geladeira.

note: type: verbatim
en:   cp po_fridge/*.po .
pt_BR:   cp geladeira_de_po/*.po .

note: type: =item
en: - Manually merge the PO files with the new POT file, but taking the useless fuzzy into account.
pt_BR: - Mescle manualmente os arquivos PO com o novo arquivo POT, mas levando em consideração as mensagens inutilmente marcadas como aproximadas.

note: type: verbatim
en:   msguntypot -o myfile.pot.orig -n myfile.pot *.po
pt_BR:   msguntypot -o meuarquivo.pot.orig -n meuarquivo.pot *.po

note: type: =item
en: - Cleanups.
pt_BR: - Limpezas.

note: type: verbatim
en:   rm -rf myfile.pot.orig po_fridge
pt_BR:   rm -rf meuarquivo.pot.orig geladeira_de_po

note: type: textblock
en: You're done. The typo was eradicated from msgstr of both your POT and PO files, and the PO files were not fuzzyied in the process. Your translators love you already.
pt_BR: Está concluído. O erro foi erradicado do msgstr de ambos seus arquivos POT e PO, e as traduções dos arquivos PO não foram marcados como aproximadas no processo. Seus tradutores já amam você.

note: type: textblock
en: Despite its name, this tool is not part of the gettext tool suite. It is instead part of po4a. More precisely, it's a random Perl script using the fine po4a modules. For more information about po4a, please see:
pt_BR: Apesar do seu nome, essa ferramenta não é parte da suíte de ferramentas do gettext. Ela tem a intenção de ser parte do po4a. Mais precisamente, é um script Perl nos ótimos módulos do po4a. Para mais informações sobre po4a, por favor espere:

note: type: textblock
en: Copyright 2005 by SPI, inc.
pt_BR: Copyright 2005 por SPI, inc.

note: type: textblock
en: po4a - framework to translate documentation and other materials
pt_BR: po4a - framework para traduzir documentação e outros materiais

note: type: =head1
en: Introduction
pt_BR: Introdução

note: type: textblock
en: po4a (PO for anything) eases the maintenance of documentation translation using the classical gettext tools. The main feature of po4a is that it decouples the translation of content from its document structure.
pt_BR: po4a (PO for anything) facilita a manutenção da tradução de documentação usando as ferramentas gettext clássicas. A principal característica do po4a é que ele dissocia a tradução do conteúdo de sua estrutura documental.

note: type: textblock
en: This document serves as an introduction to the po4a project with a focus on potential users considering whether to use this tool and on the curious wanting to understand why things are the way they are.
pt_BR: Este documento serve como uma introdução ao projeto po4a, com foco nos usuários em potencial, considerando a possibilidade de usar essa ferramenta e no desejo curioso de entender por que as coisas são do jeito que são.

note: type: =head1
en: Why po4a?
pt_BR: Por que o po4a?

note: type: textblock
en: The philosophy of Free Software is to make the technology truly available to everyone. But licensing is not the only consideration: untranslated free software is useless for non-English speakers. Therefore, we still have some work to do to make software available to everybody.
pt_BR: A filosofia do software livre é tornar a tecnologia verdadeiramente disponível para todos. Mas o licenciamento não é a única consideração: o software livre não traduzido é inútil para quem não fala inglês. Portanto, ainda temos algum trabalho a fazer para disponibilizar o software para todos.

note: type: textblock
en: This situation is well understood by most projects and everybody is now convinced of the necessity to translate everything. Yet, the actual translations represent a huge effort of many individuals, crippled by small technical difficulties.
pt_BR: Essa situação é bem compreendida pela maioria dos projetos e agora todos estão convencidos da necessidade de traduzir tudo. No entanto, as traduções reais representam um enorme esforço de muitas pessoas, prejudicadas por pequenas dificuldades técnicas.

note: type: textblock
en: Thankfully, Open Source software is actually very well translated using the gettext tool suite. These tools are used to extract the strings to translate from a program and present the strings to translate in a standardized format (called PO files, or translation catalogs). A whole ecosystem of tools has emerged to help the translators actually translate these PO files. The result is then used by gettext at run time to display translated messages to the end users.
pt_BR: Felizmente, o software de código aberto é realmente muito bem traduzido usando o conjunto de ferramentas gettext. Essas ferramentas são usadas para extrair as strings a serem traduzidas de um programa e apresentar as strings em um formato padronizado (chamado de arquivos PO ou catálogos de tradução). Um ecossistema inteiro de ferramentas surgiu para ajudar os tradutores a traduzir esses arquivos PO. O resultado é usado pelo gettext no tempo de execução para exibir mensagens traduzidas para os usuários finais.

note: type: textblock
en: Regarding documentation, however, the situation still somewhat disappointing.  At first translating documentation may seem to be easier than translating a program as it would seem that you just have to copy the documentation source file and start translating the content. However, when the original documentation is modified, keeping track of the modifications quickly turns into a nightmare for the translators. If done manually, this task is unpleasant and error prone.
pt_BR: Em relação à documentação, no entanto, a situação ainda é um pouco decepcionante. No início, traduzir a documentação pode parecer mais fácil do que traduzir um programa, pois parece que você apenas precisa copiar o arquivo-fonte da documentação e começar a traduzir o conteúdo. No entanto, quando a documentação original é modificada, acompanhar as modificações rapidamente se transforma em um pesadelo para os tradutores. Se realizada manualmente, esta tarefa é desagradável e propensa a erros.

note: type: textblock
en: Outdated translations are often worse than no translation at all. End-users can be tricked by documentation describing an old behavior of the program.  Furthermore, they cannot interact directly with the maintainers since they don't speak English. Additionally, the maintainer cannot fix the problem as they don't know every language in which their documentation is translated.  These difficulties, often caused by poor tooling, can undermine the motivation of volunteer translators, further aggravating the problem.
pt_BR: Traduções desatualizadas geralmente são piores do que nenhuma tradução. Os usuários finais podem ser enganados pela documentação que descreve um comportamento antigo do programa. Além disso, eles não podem interagir diretamente com os mantenedores, pois não falam inglês. Além disso, o mantenedor não pode resolver o problema, pois não conhece todos os idiomas em que sua documentação está traduzida. Essas dificuldades, muitas vezes causadas por ferramentas precárias, podem minar a motivação de tradutores voluntários, agravando ainda mais o problema.

note: type: textblock
en: B<The goal of the po4a project is to ease the work of documentation translators>.  In particular, it makes documentation translations I<maintainable>.
pt_BR: B<O objetivo do projeto po4a é facilitar o trabalho dos tradutores de documentação>. Em particular, ele torna possível I<manter> traduções de documentações.

note: type: textblock
en: The idea is to reuse and adapt the gettext approach to this field. As with gettext, texts are extracted from their original locations and presented to translators as PO translation catalogs. The translators can leverage the classical gettext tools to monitor the work to do, collaborate and organize as teams. po4a then injects the translations directly into the documentation structure to produce translated source files that can be processed and distributed just like the English files. Any paragraph that is not translated is left in English in the resulting document, ensuring that the end users never see an outdated translation in the documentation.
pt_BR: A ideia é reutilizar e adaptar a abordagem gettext a esse campo. Assim como o gettext, os textos são extraídos de seus locais originais e apresentados aos tradutores como catálogos de tradução de pedidos. Os tradutores podem aproveitar as ferramentas gettext clássicas para monitorar o trabalho a realizar, colaborar e organizar em equipe. O po4a injeta as traduções diretamente na estrutura da documentação para produzir arquivos de origem traduzidos que podem ser processados e distribuídos da mesma forma que os arquivos em inglês. Qualquer parágrafo que não seja traduzido é deixado em inglês no documento resultante, garantindo que os usuários finais nunca vejam uma tradução desatualizada na documentação.

note: type: textblock
en: This automates most of the grunt work of the translation maintenance.  Discovering the paragraphs needing an update becomes very easy, and the process is completely automated when elements are reordered without further modification. Specific verification can also be used to reduce the chance of formatting errors that would result in a broken document.
pt_BR: Isso automatiza a maior parte do trabalho pesado da manutenção da tradução. A descoberta dos parágrafos que precisam de atualização se torna muito fácil e o processo é completamente automatizado quando os elementos são reordenados sem modificações adicionais. A verificação específica também pode ser usada para reduzir a chance de erros de formatação que resultariam em um documento quebrado.

note: type: textblock
en: Please also see the B<FAQ> below in this document for a more complete list of the advantages and disadvantages of this approach.
pt_BR: Por favor, veja também o B<FAQ> abaixo neste documento para uma lista mais completa de vantagens e desvantagens desta abordagem.

note: type: =head2
en: Supported formats
pt_BR: Formatos suportados

note: type: textblock
en: Currently, this approach has been successfully implemented to several kinds of text formatting formats:
pt_BR: Atualmente, essa abordagem tem sido implementada com sucesso em vários formatos de formatação de texto:

note: type: =item
en: man (mature parser)
pt_BR: man (analisador maduro)

note: type: textblock
en: The good old manual pages' format, used by so many programs out there. po4a support is very welcome here since this format is somewhat difficult to use and not really friendly to newbies.
pt_BR: O bom e velho formato de páginas de manual, usado por muitos programas por aí. Suporte do po4a é muito bem-vindo, considerando que esse formato é de certa forma difícil de usar e não exatamente amigável para novatos.

note: type: textblock
en: The L<Locale::Po4a::Man(3pm)|Man> module also supports the mdoc format, used by the BSD man pages (they are also quite common on Linux).
pt_BR: O módulo L<Locale::Po4a::Man(3pm)|Man> também possui suporte ao formato mdoc usado pelas páginas man do BSD (elas também são bastante comuns no Linux).

note: type: =item
en: AsciiDoc (mature parser)
pt_BR: AsciiDoc (analisador maduro)

note: type: textblock
en: This format is a lightweight markup format intended to ease the authoring of documentation. It is for example used to document the git system. Those manpages are translated using po4a.
pt_BR: Esse formato é um formato de marcação leve, destinado a facilitar a criação da documentação. Por exemplo, é usado para documentar o sistema git. Essas páginas man são traduzidas usando po4a.

note: type: textblock
en: See L<Locale::Po4a::AsciiDoc> for details.
pt_BR: Veja L<Locale::Po4a::AsciiDoc> para detalhes.

note: type: =item
en: pod (mature parser)
pt_BR: pod (analisador maduro)

note: type: textblock
en: This is the Perl Online Documentation format. The language and extensions themselves are documented using this format in addition to most existing Perl scripts. It makes easy to keep the documentation close to the actual code by embedding them both in the same file. It makes programmer's life easier, but unfortunately, not the translator's, until you use po4a.
pt_BR: Esse é o formato da documentação online de Perl, ou Perl Online Documentation. A própria linguagem e extensões são documentadas usando este formato além da maioria dos scripts Perl existentes. Isso facilita a manter a documentação ferto do real código embutindo-os no mesmo arquivo. Isso torna a vida dos programadores mais fácil, mas infelizmente, não a do tradutor, até você usar o po4a.

note: type: textblock
en: See L<Locale::Po4a::Pod> for details.
pt_BR: Veja L<Locale::Po4a::Pod> para detalhes.

note: type: =item
en: sgml (mature parser)
pt_BR: sgml (analisador maduro)

note: type: textblock
en: Even if superseded by XML nowadays, this format is still used for documents which are more than a few screens long. It can even be used for complete books.  Documents of this length can be very challenging to update. B<diff> often reveals useless when the original text was re-indented after update.  Fortunately, po4a can help you after that process.
pt_BR: Mesmo que substituído pelo XML hoje em dia, esse formato ainda é usado para documentos que têm mais de algumas telas. Pode até ser usado para livros completos.  Documentos deste comprimento podem ser muito desafiadores para atualizar. B<diff> muitas vezes revela inútil quando o texto original era recuado novamente após a atualização.  Felizmente, po4a pode lhe ajudar depois desse processo.

note: type: textblock
en: Currently, only DebianDoc and DocBook DTD are supported, but adding support for a new one is really easy. It is even possible to use po4a on an unknown SGML DTD without changing the code by providing the needed information on the command line. See L<Locale::Po4a::Sgml(3pm)> for details.
pt_BR: Atualmente, há suporte apenas ao DebianDoc e o DocBook DTD, mas a adição de suporte a um novo é realmente fácil. É possível até mesmo usar po4a em um SGML DTD desconhecido sem alterar o código, desde que sejam fornecidas as informações necessárias na linha de comando. Veja L<Locale::Po4a::Sgml(3pm)> para mais detalhes.

note: type: =item
en: TeX / LaTeX (mature parser)
pt_BR: TeX / LaTeX (analisador maduro)

note: type: textblock
en: The LaTeX format is a major documentation format used in the Free Software world and for publications.
pt_BR: O formato LaTeX é um formato de documentação mais usado no mundo de software livre e para publicações.

note: type: textblock
en: The L<Locale::Po4a::LaTeX(3pm)|LaTeX> module was tested with the Python documentation, a book and some presentations.
pt_BR: O módulo L<Locale::Po4a::LaTeX(3pm)|LaTeX> foi testado com a documentação do Python, um livro e algumas apresentações.

note: type: =item
en: text (mature parser)
pt_BR: text (analisador maduro)

note: type: textblock
en: The Text format is the base format for many formats that include long blocks of text, including Markdown, fortunes, YAML front matter section, debian/changelog, and debian/control.
pt_BR: O formato Text é of formato base para muitos formatos que incluem longos blocos de texto, incluindo Markdown, fortunes, seção de página de rotos YAML, debian/changelog e debian/control.

note: type: textblock
en: This supports the common format used in Static Site Generators, READMEs, and other documentation systems. See L<Locale::Po4a::Text(3pm)|Text> for details.
pt_BR: Este possui suporte ao formato comum usado em geradores de sites estáticos, READMEs e outros sistemas de documentação. Consulte L<Locale::Po4a::Text(3pm)|Text> para detalhes.

note: type: =item
en: xml and XHMTL (probably mature parser)
pt_BR: xml e XHMTL (analisador provavelmente maduro)

note: type: textblock
en: The XML format is a base format for many documentation formats.
pt_BR: O formato XML é um formato base para muitos formatos de documentação.

note: type: textblock
en: Currently, the DocBook DTD (see L<Locale::Po4a::Docbook(3pm)> for details) and XHTML are supported by po4a.
pt_BR: Atualmente, o DocBook DTD (veja L<Locale::Po4a::Docbook(3pm)> para mais detalhes) e XHTML são suportados pelo po4a.

note: type: =item
en: BibTex (probably mature parser)
pt_BR: BibTex (analisador provavelmente maduro)

note: type: textblock
en: The BibTex format is used alongside LaTex for formatting lists of references (bibliographies).
pt_BR: O formato BibTex é usado junto com o LaTex para formatar listas de referências (bibliografias).

note: type: textblock
en: See L<Locale::Po4a::BibTex> for details.
pt_BR: Veja L<Locale::Po4a::BibTex> para detalhes.

note: type: =item
en: Docbook (probably mature parser)
pt_BR: Docbook (analisador provavelmente maduro)

note: type: textblock
en: A XML-based markup language that uses semantic tags to describe documents.
pt_BR: Uma linguagem de marcação baseada em XML que usa tags semânticas para descrever documentos.

note: type: textblock
en: See L<Locale::Po4a:Docbook> for greater details.
pt_BR: Veja L<Locale::Po4a:Docbook> para mais detalhes.

note: type: =item
en: Guide XML (probably mature parser)
pt_BR: Guide XML (analisador provavelmente maduro)

note: type: textblock
en: A XML documentation format. This module was developed specifically to help with supporting and maintaining translations of Gentoo Linux documentation up until at least March 2016 (Based on the Wayback Machine). Gentoo have since moved to the DevBook XML format.
pt_BR: Um formato de documentação XML. Este módulo foi desenvolvido especificamente para ajudar no suporte e manutenção de traduções da documentação do Gentoo Linux até pelo menos março de 2016 (baseado na máquina Wayback). Desde então, o Gentoo mudou para o formato DevBook XML.

note: type: textblock
en: See L<Locale::Po4a:Guide> for greater details.
pt_BR: Veja L<Locale::Po4a:Guide> para mais detalhes.

note: type: =item
en: Wml (probably mature parser)
pt_BR: Wml (analisador provavelmente maduro)

note: type: textblock
en: The Web Markup Language, do not mixup WML with the WAP stuff used on cell phones.  This module relies on the Xhtml module, which itself relies on the XmL module.
pt_BR: A Web Markup Language, não confunda WML com o material WAP usado em telefones celulares. Este módulo depende do módulo Xhtml, que por sua vez depende do módulo XmL.

note: type: textblock
en: See L<Locale::Po4a::Wml> for greater details.
pt_BR: Veja L<Locale::Po4a::Wml> para mais detalhes.

note: type: =item
en: Yaml (probably mature parser)
pt_BR: Yaml (analisador provavelmente maduro)

note: type: textblock
en: A strict superset of JSON. YAML is often used as systems or configuration projects.  YAML is at the core of Red Hat's Ansible.
pt_BR: Um superconjunto estrito de JSON. YAML é frequentemente usado como sistemas ou projetos de configuração. YAML está no cerne do Ansible da Red Hat.

note: type: textblock
en: See L<Locale::Po4a::Yaml> for greater details.
pt_BR: Veja L<Locale::Po4a::Yaml> para mais detalhes.

note: type: =item
en: RubyDoc (probably mature parser)
pt_BR: RubyDoc (analisador provavelmente maduro)

note: type: textblock
en: The Ruby Document (RD) format, originally the default documentation format for Ruby and Ruby projects before converted to RDoc in 2002. Though apparently the Japanese version of the Ruby Reference Manual still use RD.
pt_BR: O formato Ruby Document (RD), originalmente o formato de documentação padrão para Ruby e projetos Ruby antes de ser convertido para RDoc em 2002. Embora aparentemente a versão japonesa do Manual de Referência Ruby ainda use RD.

note: type: textblock
en: See L<Locale::Po4a::RubyDoc> for greater details.
pt_BR: Veja L<Locale::Po4a::RubyDoc> para mais detalhes.

note: type: =item
en: Halibut (probably experimental parser)
pt_BR: Halibut (analisador altamente experimental)

note: type: textblock
en: A documentation production system, with elements similar to TeX, debiandoc-sgml, TeXinfo, and others, developed by Simon Tatham, the developer of PuTTY.
pt_BR: Um sistema de produção de documentação, com elementos semelhantes ao TeX, debiandoc-sgml, TeXinfo e outros, desenvolvido por Simon Tatham, o desenvolvedor do PuTTY.

note: type: textblock
en: See L<Locale::Po4a:Halibut> for greater details.
pt_BR: Veja L<Locale::Po4a:Halibut> para mais detalhes.

note: type: =item
en: Ini (probably experimental parser)
pt_BR: Ini (analisador altamente experimental)

note: type: textblock
en: Configuration file format popularized by MS-DOS.
pt_BR: Formato de arquivo de configuração popularizado pelo MS-DOS.

note: type: textblock
en: See L<Locale::Po4a::Ini> for greater details.
pt_BR: Veja L<Locale::Po4a::Ini> para mais detalhes.

note: type: =item
en: texinfo (very highly experimental parser)
pt_BR: texinfo (analisador altamente experimental)

note: type: textblock
en: All of the GNU documentation is written in this format (it's even one of the requirements to become an official GNU project). The support for L<Locale::Po4a::Texinfo(3pm)|Texinfo> in po4a is still at the beginning.  Please report bugs and feature requests.
pt_BR: Toda a documentação do GNU é escrita neste formato (esse é até mesmo um dos requisitos para se tornar um projeto GNU oficial). O suporte a L<Locale::Po4a::Texinfo(3pm)|Texinfo> no po4a ainda está nas fases iniciais. Por favor relate eventuais erros e requisição por recursos.

note: type: =item
en: Others supported formats
pt_BR: Outros formatos com suporte

note: type: textblock
en: Po4a can also handle some more rare or specialized formats, such as the documentation of compilation options for the 2.4+ Linux kernels (L<Locale::Po4a::KernelHelp>) or the diagrams produced by the dia tool (L<Locale::Po4a:Dia>). Adding a new format is often very easy and the main task is to come up with a parser for your target format. See L<Locale::Po4a::TransTractor(3pm)> for more information about this.
pt_BR: Po4a também pode manipular alguns formatos mais raros ou especializados, como a documentação de opções de compilação dos kernels Linux 2.4+ (L<Locale::Po4a::KernelHelp>) ou diagramas produzidos pela ferramenta Dia (L<Locale::Po4a:Dia>). A adição de um novo formato é normalmente muito fácil e a tarefa principal é fazer um analisador para seu formato alvo. Veja L<Locale::Po4a::TransTractor(3pm)> para mais informações sobre isso.

note: type: =item
en: Unsupported formats
pt_BR: Formatos sem suporte

note: type: textblock
en: Unfortunately, po4a still lacks support for several documentation formats. Many of them would be easy to support in po4a. This includes formats not just used for documentation, such as, package descriptions (deb and rpm), package installation scripts questions, package changelogs, and all the specialized file formats used by programs such as game scenarios or wine resource files.
pt_BR: Infelizmente, po4a ainda carece de suporte para vários formatos de documentação. Muitos deles seriam fáceis de dar suporte no po4a. Isso inclui formatos não apenas usados para documentação, como, descrições de pacotes (deb e rpm), perguntas sobre scripts de instalação de pacotes, changelogs de pacotes e todos os formatos de arquivo especializados usados por programas como cenários de jogos ou arquivos de recursos de vinho.

note: type: =head1
en: Using po4a
pt_BR: Usando po4a

note: type: textblock
en: Historically, po4a was built around four scripts, each fulfilling a specific task. L<po4a-gettextize(1)> helps bootstrapping translations and optionally converting existing translation projects to po4a. L<po4a-updatepo(1)> reflects the changes to the original documentation into the corresponding po files.  L<po4a-translate(1)> builds translated source file from the original file and the corresponding PO file. In addition, L<po4a-normalize(1)> is mostly useful to debug the po4a parsers, as it produces an untranslated document from the original one. It makes it easier to spot the glitches introduced by the parsing process.
pt_BR: Historicamente, o po4a foi construído em torno de quatro scripts, cada um cumprindo uma tarefa específica. L<po4a-gettextize(1)> ajuda na inicialização de traduções e, opcionalmente, na conversão de projetos de tradução existentes em po4a. L<po4a-updatepo(1)> reflete as alterações na documentação original nos arquivos po correspondentes. L<po4a-translate(1)> constrói o arquivo de origem traduzido a partir do arquivo original e do arquivo PO correspondente. Além disso, L<po4a-normalize(1)> é principalmente útil para depurar os analisadores de po4a, pois produz um documento não traduzido do original. Torna mais fácil identificar as falhas introduzidas pelo processo de análise.

note: type: textblock
en: The rest of this section gives an overview of how use the scripts' interface of po4a. Most users will probably prefer to use the all-in-one tool, that is described in the documentation of L<po4a(1)>.
pt_BR: O restante desta seção fornece uma visão geral de como usar a interface de scripts do po4a. A maioria dos usuários provavelmente preferirá usar a ferramenta multifuncional, descrita na documentação de L<po4a(1)>.

note: type: =head2
en: Graphical overview of the po4a scripts
pt_BR: Visão geral gráfica dos scripts do po4a

note: type: textblock
en: The following schema gives an overview of how each po4a script can be used.  Here, F<master.doc> is an example name for the documentation to be translated; F<XX.doc> is the same document translated in the language XX while F<doc.XX.po> is the translation catalog for that document in the XX language. Documentation authors will mostly be concerned with F<master.doc> (which can be a manpage, an XML document, an asciidoc file or similar); the translators will be mostly concerned with the PO file, while the end users will only see the F<XX.doc> file.
pt_BR: O esquema a seguir fornece uma visão geral de como cada script po4a pode ser usado. Aqui, F<master.doc> é um nome de exemplo para a documentação a ser traduzida; F<XX.doc> é o mesmo documento traduzido no idioma XX, enquanto F<doc.XX.po> é o catálogo de traduções desse documento no idioma XX. Os autores da documentação se preocuparão principalmente com F<master.doc> (que pode ser uma página man, um documento XML, um arquivo asciidoc ou semelhante); os tradutores se preocuparão principalmente com o arquivo PO, enquanto os usuários finais verão apenas o arquivo F<XX.doc>.

note: type: verbatim
en:                                    master.doc
                                           |
                                           V
         +<-----<----+<-----<-----<--------+------->-------->-------+
         :           |                     |                        :
    {translation}    |         { update of master.doc }             :
         :           |                     |                        :
       XX.doc        |                     V                        V
     (optional)      |                 master.doc ->-------->------>+
         :           |                   (new)                      |
         V           V                     |                        |
      [po4a-gettextize]   doc.XX.po -->+   |                        |
              |            (old)       |   |                        |
              |              ^         V   V                        |
              |              |     [po4a-updatepo]                  |
              V              |           |                          V
       translation.pot       ^           V                          |
              |              |        doc.XX.po                     |
              |              |         (fuzzy)                      |
       { translation }       |           |                          |
              |              ^           V                          V
              |              |     {manual editing}                 |
              |              |           |                          |
              V              |           V                          V
          doc.XX.po --->---->+<---<-- doc.XX.po    addendum     master.doc
          (initial)                 (up-to-date)  (optional)   (up-to-date)
              :                          |            |             |
              :                          V            |             |
              +----->----->----->------> +            |             |
                                         |            |             |
                                         V            V             V
                                         +------>-----+------<------+
                                                      |
                                                      V
                                               [po4a-translate]
                                                      |
                                                      V
                                                    XX.doc
                                                 (up-to-date)
pt_BR:                                    mestre.doc
                                           |
                                           V
         +<-----<----+<-----<-----<--------+------->-------->-------+
         :           |                     |                        :
     {tradução}      |       { atualização de mestre.doc }          :
         :           |                     |                        :
       XX.doc        |                     V                        V
     (opcional)      |                 mestre.doc ->-------->------>+
         :           |                  (novo)                      |
         V           V                     |                        |
      [po4a-gettextize]  doc.XX.po---->+   |                        |
              |           (velho)      |   |                        |
              |              ^         V   V                        |
              |              |     [po4a-updatepo]                  |
              V              |           |                          V
         tradução.pot        ^           V                          |
              |              |       doc.XX.po                      |
              |              |       (incerto)                      |
         { tradução }        |           |                          |
              |              ^           V                          V
              |              |    {edição manual}                   |
              |              |           |                          |
              V              |           V                          V
          doc.XX.po --->---->+<---<-- doc.XX.po    adendo      mestre.doc
          (inicial)                 (atualizado)  (opcional)  (atualizado)
              :                          |            |             |
              :                          V            |             |
              +----->----->----->------> +            |             |
                                         |            |             |
                                         V            V             V
                                         +------>-----+------<------+
                                                      |
                                                      V
                                               [po4a-translate]
                                                      |
                                                      V
                                                    XX.doc
                                                (atualizado)

note: type: textblock
en: This schema is complicated, but in practice only the right part (involving L<po4a-updatepo(1)> and L<po4a-translate(1)>) is used once the project is setup and configured.
pt_BR: Esse esquema é complicado, mas na prática apenas a parte correta (envolvendo L<po4a-updatepo(1)> e L<po4a-translate(1)>) é usada depois que o projeto é instalado e configurado.

note: type: textblock
en: The left part depicts how L<po4a-gettextize(1)> can be used to convert an existing translation project to the po4a infrastructure. This script takes an original document and its translated counterpart, and tries to build the corresponding PO file. Such manual conversion is rather cumbersome (see the L<po4a-gettextize(1)> documentation for more details), but it is only needed once to convert your existing translations. If you don't have any translation to convert, you can forget about this and focus on the right part of the schema.
pt_BR: A parte esquerda mostra como L<po4a-gettextize(1)> pode ser usado para converter um projeto de tradução existente para a infraestrutura do po4a. Este script pega um documento original e seu equivalente traduzido, e tenta construir o arquivo PO correspondente. Tal conversão manual é um pouco trabalhosa (veja a documentação L<po4a-gettextize(1)> para mais detalhes), mas só é necessária uma vez para converter suas traduções existentes. Se você não tem nenhuma tradução para converter, você pode esquecer isso e focar na parte certa do esquema.

note: type: textblock
en: On the top right part, the action of the original author is depicted, updating the documentation. The middle right part depicts the automatic actions of L<po4a-updatepo(1)>. The new material is extracted and compared against the exiting translation. The previous translation is used for the parts that didn't change, while partially modified parts are connected to the previous translation with a "fuzzy" marker indicating that the translation must be updated. New or heavily modified material is left untranslated.
pt_BR: Na parte superior direita, a ação do autor original está descrita, atualização da documentação. A parte do meio, à direita, representa as ações automáticas do L<po4a-updatepo(1)>. Os novos materiais são extraídos e comparados com a tradução existente. A tradução anterior é usado para as partes que não foram alteradas, enquanto partes parcialmente modificadas também são conectadas à tradução anterior com uma marcação "fuzzy" indicando que a tradução deve ser atualizada. Material novo ou muito modificado é deixado sem tradução.

note: type: textblock
en: Then, the I<manual editing> reported depicts the action of the translators, that modify the PO files to provide translations to every original string and paragraph. This can be done using either a specific editor such as the B<GNOME Translation Editor>, KDE's B<Lokalize> or B<poedit>, or using an online localization platform such as B<weblate> or B<pootle>. The translation result is a set of PO files, one per language. Please refer to the gettext documentation for more details.
pt_BR: Então, a I<edição manual> relatada representa a ação dos tradutores, que modificam os arquivo PO para fornecer traduções para toda string e parágrafo originais. Isso pode ser feito usando um editor específico, como o B<Editor de Tradução do GNOME>, o B<Lokalize> do KDE ou B<poedit>, ou usando uma plataforma de localização online como o B<weblate> ou B<pootle>. O resultado da tradução é um conjunto de arquivos PO, um por idioma. Consulte a documentação gettext para mais detalhes.

note: type: textblock
en: The bottom part of the figure shows how L<po4a-translate(1)> creates a translated source document from the F<master.doc> original document and the F<doc.XX.po> translation catalog that was updated by the translators. The structure of the document is reused, while the original content is replaced by its translated counterpart. Optionally, an addendum can be used to add some extra text to the translation. This is often used to add the name of the translator to the final document. See below for details.
pt_BR: A parte inferior da figura mostra como L<po4a-translate(1)> cria um documento fonte traduzido do documento original F<master.doc> e do catálogo de traduções F<doc.XX.po> que foram atualizados pelos tradutores . A estrutura do documento é reutilizada, enquanto o conteúdo original é substituído por sua contraparte traduzida. Opcionalmente, um adendo pode ser usado para adicionar um texto extra à tradução. Isso geralmente é usado para adicionar o nome do tradutor ao documento final. Veja abaixo os detalhes.

note: type: textblock
en: As noted before, the L<po4a(1)> program combines the effects of the separated scripts, updating the PO files and the translated document in one invocation.  The underlying logic remains the same.
pt_BR: Como observado anteriormente, o programa L<po4a(1)> combina os efeitos dos scripts separados, atualizando os arquivos PO e o documento traduzido em uma chamada. A lógica subjacente permanece a mesma.

note: type: =head2
en: Starting a new translation
pt_BR: Iniciando uma nova tradução

note: type: textblock
en: If you use L<po4a(1)>, there is no specific step to start a translation. You just have to list the languages in the configuration file, and the missing PO files are automatically created. Naturally, the translator then have to provide translations for every content used in your documents. L<po4a(1)> also creates a POT file, that is a PO template file. Potential translators can translate your project into a new language by renaming this file and providing the translations in their language.
pt_BR: Se você usar L<po4a(1)>, não há etapa específica para iniciar uma tradução. Você apenas precisa listar os idiomas no arquivo de configuração, e os arquivos PO ausentes são criados automaticamente. Naturalmente, o tradutor deve fornecer traduções para todos os conteúdos usados em seus documentos. L<po4a(1)> também cria um arquivo POT, que é um arquivo de modelo de PO. Tradutores em potencial podem traduzir seu projeto para um novo idioma renomeando esse arquivo e fornecendo as traduções no idioma deles.

note: type: textblock
en: If you prefer to use the individual scripts separately, you should use L<po4a-gettextize(1)> as follows to create the POT file. This file can then be copied into F<XX.po> to initiate a new translation.
pt_BR: Se você preferir usar os scripts individuais separadamente, use L<po4a-gettextize(1)> da seguinte maneira para criar o arquivo POT. Este arquivo pode ser copiado em F<XX.po> para iniciar uma nova tradução.

note: type: verbatim
en:   $ po4a-gettextize --format <format> --master <master.doc> --po <translation.pot>
pt_BR:   $ po4a-gettextize --format <formato> --master <mestre.doc> --po <tradução.pot>

note: type: textblock
en: The master document is used in input, while the POT file is the output of this process.
pt_BR: O documento mestre é usado na entrada, enquanto o arquivo PO é a saída deste processo.

note: type: =head2
en: Integrating changes to the original document
pt_BR: Integrando alterações ao documento original

note: type: textblock
en: The script to use for that is L<po4a-updatepo(1)> (please refer to its documentation for details):
pt_BR: O script a ser usado para isso é L<po4a-updatepo(1)> (consulte a documentação para obter detalhes):

note: type: verbatim
en:   $ po4a-updatepo --format <format> --master <new_master.doc> --po <old_doc.XX.po>
pt_BR:   $ po4a-updatepo --format <formato> --master <novo_mestre.doc> --po <doc_antigo.XX.po>

note: type: textblock
en: The master document is used in input, while the PO file is updated: it is used both in input and output.
pt_BR: O documento mestre é usado na entrada, enquanto o arquivo PO é atualizado: ele é usado tanto na entrada quanto na saída.

note: type: =head2
en: Generating a translated document
pt_BR: Gerando um documento traduzido

note: type: textblock
en: Once you're done with the translation, you want to get the translated documentation and distribute it to users along with the original one.  For that, use the L<po4a-translate(1)> program as follows:
pt_BR: Assim que você finalizar com a tradução, você quer pegar a documentação traduzida e distribuí-la para os usuários junto com o original. Para isso, use o programa L<po4a-translate(1)> da seguinte forma:

note: type: verbatim
en:   $ po4a-translate --format <format> --master <master.doc> --po <doc.XX.po> --localized <XX.doc>
pt_BR:   $ po4a-translate --format <formato> --master <mestre.doc> --po <doc.XX.po> --localized <XX.doc>

note: type: textblock
en: Both the master and PO files are used in input, while the localized file is the output of this process.
pt_BR: Os arquivos mestre e PO são usados na entrada, enquanto o arquivo localizado é a saída desse processo.

note: type: =head2
en: Using addenda to add extra text to translations
pt_BR: Usando adendos para adicionar texto extra às traduções

note: type: textblock
en: Adding new text to the translation is probably the only thing that is easier in the long run when you translate files manually :). This happens when you want to add an extra section to the translated document, not corresponding to any content in the original document. The classical use case is to give credits to the translation team, and to indicate how to report translation-specific issues.
pt_BR: Adicionar novo texto à tradução é provavelmente a única coisa mais fácil a longo prazo quando você traduz arquivos manualmente :). Isso acontece quando você deseja adicionar uma seção extra ao documento traduzido, que não corresponde a nenhum conteúdo no documento original. O caso de uso clássico é dar créditos à equipe de tradução e indicar como relatar problemas específicos da tradução.

note: type: textblock
en: With po4a, you have to specify B<addendum> files, that can be conceptually viewed as patches applied to the localized document after processing. Each addendum must be provided as a separate file, which format is however very different from the classical patches. The first line is a I<header line>, defining the insertion point of the addendum (with an unfortunately cryptic syntax -- see below) while the rest of the file is added verbatim at the determined position.
pt_BR: Com o po4a, é necessário especificar os arquivos B<addendum>, que podem ser vistos conceitualmente como patches aplicados ao documento localizado após o processamento. Cada adendo deve ser fornecido como um arquivo separado, cujo formato é, no entanto, muito diferente dos patches clássicos. A primeira linha é uma I<linha de cabeçalho>, definindo o ponto de inserção do adendo (com uma sintaxe infelizmente enigmática -- veja abaixo) enquanto o restante do arquivo é adicionado literalmente na posição determinada.

note: type: textblock
en: The header line must begin with the string B<PO4A-HEADER:>, followed by a semi-colon separated list of I<key>B<=>I<value> fields.
pt_BR: A linha do cabeçalho deve começar com a string B<PO4A-HEADER:>, seguida por uma lista separada por ponto e vírgula dos campos I<chave>B<=>I<valor>.

note: type: textblock
en: For example, the following header declares an addendum that must be placed at the very end of the translation.
pt_BR: Por exemplo, o cabeçalho a seguir declara um adendo que deve ser colocado bem no final da tradução.

note: type: textblock
en: Things are more complex when you want to add your extra content in the middle of the document. The following header declares an addendum that must be placed after the XML section containing the string C<About this document> in translation.
pt_BR: As coisas ficam mais complexas quando você deseja adicionar seu conteúdo extra no meio do documento. O cabeçalho a seguir declara um adendo que deve ser colocado após a seção XML que contém a string C<Sobre este documento> na tradução.

note: type: verbatim
en:  PO4A-HEADER: position=About this document; mode=after; endboundary=</section>
pt_BR:  PO4A-HEADER: position=Sobre este documento; mode=after; endboundary=</section>

note: type: textblock
en: In practice, when trying to apply an addendum, po4a searches for the first line matching the C<position> argument (this can be a regexp). Do not forget that po4a considers the B<translated> document here. This documentation is in English, but your line should probably read as follows if you intend your addendum to apply to the French translation of the document.
pt_BR: Na prática, ao tentar aplicar um adendo, o po4a pesquisa a primeira linha correspondente ao argumento C<position> (isso pode ser um regexp). Não esqueça que o po4a considera o documento B<translated> aqui. Esta documentação está em inglês, mas sua linha provavelmente deve ser a seguinte, se você pretende que seu adendo se aplique à tradução em francês do documento.

note: type: textblock
en: Once the C<position> is found in the target document, po4a searches for the next line after the C<position> that matches the provided C<endboundary>. The addendum is added right B<after> that line (because we provided an I<endboundary>, i.e. a boundary ending the current section).
pt_BR: Depois que a C<position> é encontrada no documento de destino, o po4a procura a próxima linha após a C<position> que corresponde ao C<endboundary> fornecido. O adendo é adicionado à direita B<after> essa linha (porque fornecemos um I<endboundary>, ou seja, um limite que termina a seção atual).

note: type: textblock
en: The exact same effect could be obtained with the following header, that is equivalent:
pt_BR: O exato mesmo efeito pode ser obtido com o seguinte cabeçalho, que é equivalente:

note: type: textblock
en: Here, po4a searches for the first line matching C<<section>> after the line matching C<About this document> in the translation, and add the addendum B<before> that line since we provided a I<beginboundary>, i.e. a boundary marking the beginning of the next section. So this header line requires to place the addendum after the section containing C<About this document>, and instruct po4a that a section starts with a line containing the C<<section>> tag. This is equivalent to the previous example because what you really want is to add this addendum either after C</section>> or before C<<section>>.
pt_BR: Aqui, o po4a pesquisa a primeira linha correspondente a C<<section>> após a linha correspondente a C<About this document> na tradução e adicione o adendo B<before> dessa linha, pois fornecemos um I<beginboundary>, ou seja, um limite que marca o início da próxima seção. Portanto, essa linha de cabeçalho exige a inserção do adendo após a seção que contém C<About this document> e instrui o po4a que uma seção começa com uma linha que contém a tag C<<section>>. Isso é equivalente ao exemplo anterior, porque o que você realmente deseja é adicionar este adendo após C</section>> ou antes de C<<section>>.

note: type: textblock
en: You can also set the insertion I<mode> to the value C<before>, with a similar semantic: combining C<mode=before> with an C<endboundary> will put the addendum just B<after> the matched boundary, that the last potential boundary line before the C<position>. Combining C<mode=before> with an C<beginboundary> will put the addendum just B<before> the matched boundary, that the last potential boundary line before the C<position>.
pt_BR: Você também pode definir a inserção I<modo> como o valor C<before>, com uma semântica semelhante: a combinação de C<mode=before> com um C<endboundary> colocará o adendo apenas B<after> o limite correspondente, que a última linha limite potencial antes da C<position>. Combinar C<mode=before> com um C<beginboundary> colocará o adendo apenas B<before> do limite correspondente, que é a última linha limite potencial antes da C<position>.

note: type: verbatim
en:   Mode   | Boundary kind |     Used boundary      | Insertion point compared to the boundary
     ========|===============|========================|=========================================
     'before'| 'endboundary' | last before 'position' | Right after the selected boundary
     'before'|'beginboundary'| last before 'position' | Right before the selected boundary
     'after' | 'endboundary' | first after 'position' | Right after the selected boundary
     'after' |'beginboundary'| first after 'position' | Right before the selected boundary
     'eof'   |   (none)      |  n/a                   | End of file
pt_BR:   Modo   | Tipo de limite |       Limite usado         | Ponto de inserção am comparação ao limite
     ========|================|============================|==========================================
     'before'| 'endboundary'  | último antes de 'position' | Logo após o limite selecionado
     'before'|'beginboundary' | último antes de 'position' | Logo antes do limite selecionado
     'after' | 'endboundary'  |  primeiro após 'position'  | Logo após o limite selecionado
     'after' |'beginboundary' |  primeiro após 'position'  | Logo antes do limite selecionado
     'eof'   |   (none)       |  n/d                       | Fim do arquivo

note: type: =head3
en: Hint and tricks about addenda
pt_BR: Dicas e truques sobre adendos

note: type: textblock
en: Remember that these are regexp. For example, if you want to match the end of a nroff section ending with the line C<.fi>, do not use C<.fi> as B<endboundary>, because it will match with C<the[ fi]le>, which is obviously not what you expect. The correct B<endboundary> in that case is: C<^\.fi$>.
pt_BR: Lembre-se de que estes são regexp. Por exemplo, se você deseja combinar o final de uma seção nroff que termina com a linha C<.fi>, não use C<.fi> como B<endboundary> porque ele vai corresponder a C<the[ fi]le>, o que obviamente não é o que está esperando. O B<endboundary> correto neste caso é: C<^\.fi$>.

note: type: textblock
en: White spaces ARE important in the content of the C<position> and boundaries. So the two following lines B<are different>. The second one will only be found if there is enough trailing spaces in the translated document.
pt_BR: Espaços em branco SÃO importantes no conteúdo da C<position> e limites. Portanto, as duas linhas seguintes B<são diferentes>. O segundo só será encontrado se houver espaços à direita suficientes no documento traduzido.

note: type: verbatim
en:  PO4A-HEADER: position=About this document; mode=after; beginboundary=<section>
     PO4A-HEADER: position=About this document ; mode=after; beginboundary=<section>
pt_BR:  PO4A-HEADER: position=Sobre este documento; mode=after; beginboundary=<section>
     PO4A-HEADER: position=Sobre este documento; mode=after; beginboundary=<section>

note: type: textblock
en: Although this context search may be considered to operate roughly on each line of the B<translated> document, it actually operates on the internal data string of the translated document. This internal data string may be a text spanning a paragraph containing multiple lines or may be a XML tag itself alone. The exact I<insertion point> of the addendum must be before or after the internal data string and can not be within the internal data string.
pt_BR: Embora essa pesquisa de contexto possa ser considerada como operando aproximadamente em cada linha do documento B<traduzido>, ela realmente opera na cadeia de dados interna do documento traduzido. Essa cadeia de dados interna pode ser um texto abrangendo um parágrafo contendo várias linhas ou pode ser uma tag XML sozinha. O exato I<ponto de inserção> do adendo deve ser anterior ou posterior à sequência de dados interna e não pode estar dentro da cadeia de dados interna.

note: type: textblock
en: Pass the B<-vv> argument to po4a to understand how the addenda are added to the translation. It may also help to run po4a in debug mode to see the actual internal data string when your addendum does not apply.
pt_BR: Passe o argumento B<-vv> para po4a para entender como os adendos são adicionados à tradução. Também pode ajudar a executar po4a no modo de depuração para ver a string de dados interna real quando o seu adendo não se aplica.

note: type: =head3
en: Addenda examples
pt_BR: Exemplos de adendos

note: type: textblock
en: If you want to add something after the following nroff section:
pt_BR: Se você quiser adicionar alguma coisa após a seção nroff a seguir:

note: type: textblock
en: You should select a two step approach by setting B<mode=after>. Then you should narrow down search to the line after B<AUTHORS> with the B<position> argument regex. Then, you should match the beginning of the next section (i.e., B<^\.SH>) with the B<beginboundary> argument regex. That is to say:
pt_BR: Você deve selecionar uma abordagem em duas etapas configurando B<mode=after>. Em seguida, você deve restringir a pesquisa à linha após B<AUTHORS> com a regex de argumento B<position>. Então, você deve combinar o início da próxima seção (isto é, B<^ \. SH>) com a regex de argumento B<beginboundary>. Isso é para dizer:

note: type: textblock
en: If you want to add something right after a given line (e.g. after the line "Copyright Big Dude"), use a B<position> matching this line, B<mode=after> and give a B<beginboundary> matching any line.
pt_BR: Se você quiser adicionar alguma coisa após a linha dada (ex,. após a linha "Copyright Grande Cara") use um B<position> correspondendo a esta linha, B<mode=after> e forneça um B<beginboundary> correspondendo a qualquer linha.

note: type: verbatim
en:  PO4A-HEADER:mode=after;position=Copyright Big Dude, 2004;beginboundary=^
pt_BR:  PO4A-HEADER:mode=after;position=Copyright Grande Cara, 2004;beginboundary=^

note: type: textblock
en: If you want to add something at the end of the document, give a B<position> matching any line of your document (but only one line. Po4a won't proceed if it's not unique), and give an B<endboundary> matching nothing. Don't use simple strings here like B<"EOF">, but prefer those which have less chance to be in your document.
pt_BR: Se você quiser adicionar alguma coisa ao final do documento, forneça um B<position> correspondendo a qualquer linha do seu documento (mas apenas uma linha. Po4a não vai proceder se ela não for única), e forneça um B<endboundary> correspondendo a nada. Não use strings simples aqui como B<"EOF">, e sim prefira aquelas que possuem menos chance de estar no seu documento.

note: type: verbatim
en:  PO4A-HEADER:mode=after;position=About this document;beginboundary=FakePo4aBoundary
pt_BR:  PO4A-HEADER:mode=after;position=Sobre este documento;beginboundary=FakePo4aBoundary

note: type: =head3
en: More detailed example
pt_BR: Exemplo mais detalhado

note: type: textblock
en: Original document (POD formatted):
pt_BR: Documento original (formatado em POD):

note: type: textblock
en: Then, the following addendum will ensure that a section (in French) about the translator is added at the end of the file (in French, "TRADUCTEUR" means "TRANSLATOR", and "moi" means "me").
pt_BR: Então, o adendo a seguir vai assegurar que a seção (em Francês) sobre o tradutor seja adicionado ao final do arquivo (em Francês, "TRADUCTEUR" significa "TRADUTOR", e "moi" significa "eu").

note: type: textblock
en: To put your addendum before the AUTHOR, use the following header:
pt_BR: Para colocar seu adendo antes do AUTHOR, use o seguinte cabeçalho:

note: type: textblock
en: This works because the next line matching the B<beginboundary> /^=head1/ after the section "NAME" (translated to "NOM" in French), is the one declaring the authors. So, the addendum will be put between both sections. Note that if another section is added between NAME and AUTHOR sections later, po4a will wrongfully put the addenda before the new section.
pt_BR: Isso funciona porque a próxima linha correspondendo ao B<beginboundary> /^=head1/ após a seção "NAME" (traduzido para "NOM" em Francês) é aquela declarando os autores. Então, o adendo será colocado entre as duas seções. Note que se outra seção for adicionada entre as seções NAME e AUTHOR posteriormente, po4a colocará o adendo equivocadamente antes da nova seção.

note: type: textblock
en: To avoid this you may accomplish the same using B<mode>=I<before>:
pt_BR: Para evitar isto, você pode realizar o mesmo usando B<mode>=I<before>:

note: type: =head1
en: How does it work?
pt_BR: Como ele funciona?

note: type: textblock
en: This chapter gives you a brief overview of the po4a internals, so that you may feel more confident to help us maintaining and improving it. It may also help you understanding why it does not do what you expected, and how to solve your problems.
pt_BR: Este capítulo dá a você uma visão geral da parte interna do po4a, de forma que você pode se sentir mais confiante para nos ajudar a manter e melhorá-lo. ele também pode ajudá-lo a entender o porquê de ele não funcionar da forma que você esperava, e como resolver seus problemas.

note: type: textblock
en: The po4a architecture is object oriented. The L<Locale::Po4a::TransTractor(3pm)|TransTractor> class is the common ancestor to all po4a parsers. This strange name comes from the fact that it is at the same time in charge of translating document and extracting strings.
pt_BR: A arquitetura do po4a é orientada a objeto. A classe L<Locale::Po4a::TransTractor(3pm)|TransTractor> é um antepassado comum para todos analisadores do po4a. Esse nome estranho vem do fato que ele é ao mesmo tempo o encarregado por tradução de documento e extração de strings.

note: type: textblock
en: More formally, it takes a document to translate plus a PO file containing the translations to use as input while producing two separate outputs: Another PO file (resulting of the extraction of translatable strings from the input document), and a translated document (with the same structure than the input one, but with all translatable strings replaced with content of the input PO). Here is a graphical representation of this:
pt_BR: Mais formalmente, ele pega um documento para traduzir mais um arquivo PO contendo as traduções para usar como entrada, enquanto produz duas saídas separadas: outro arquivo PO (resultante da extração das strings traduzíveis do documento de entrada) e um documento traduzido (com a mesma estrutura daquele de entrada, mas com todas as strings traduzíveis substituídas com o conteúdo do PO de entrada). Aqui está uma representação gráfica disso:

note: type: verbatim
en:    Input document --\                             /---> Output document
                         \      TransTractor::       /       (translated)
                          +-->--   parse()  --------+
                         /                           \
       Input PO --------/                             \---> Output PO
                                                             (extracted)
pt_BR:    Doc. de entrada --\                             /---> Doc. de saída
                          \      TransTractor::       /       (traduzido)
                           +-->--   parse()  --------+
                          /                           \
       PO de entrada ----/                             \---> PO de saída
                                                               (extraído)

note: type: textblock
en: This little bone is the core of all the po4a architecture. If you omit the input PO and the output document, you get B<po4a-gettextize>. If you provide both input and disregard the output PO, you get B<po4a-translate>. The B<po4a> calls TransTractor twice and calls B<msgmerge -U> between these TransTractor invocations to provide one-stop solution with a single configuration file.  Please see L<Locale::Po4a::TransTractor(3pm)> for more details.
pt_BR: Esse pequeno osso é o núcleo de toda arquitetura do po4a. Se você omitir o PO de entrada e o documento de saída, você obtém B<po4a-gettextize>. Se você fornecer ambos arquivos de entrada e desconsiderar o PO de saída, você obtém B<po4a-translate>. O B<po4a> chama o TransTractor duas vezes e chama B<msgmerge -U> entre essas chamadas do TransTractor para fornecer uma solução completa com um único arquivo de configuração. Por favor, veja L<Locale::Po4a::TransTractor(3pm)> para mais detalhes.

note: type: =head1
en: Open-source projects using po4a
pt_BR: Projetos de código aberto que usam o po4a

note: type: textblock
en: Here is a very partial list of projects that use po4a in production for their documentation. If you want to add your project to the list, just drop us an email (or a Merge Request).
pt_BR: Aqui está uma lista bem parcial de projetos que usam po4a na produção para sua documentação. Se você quiser adicionar seu projeto à lista, basta nos enviar um e-mail (ou uma merge request).

note: type: textblock
en: adduser (man): users and groups management tool.
pt_BR: adduser (man): ferramenta de gerenciamento de usuários e grupos.

note: type: textblock
en: apt (man, docbook): Debian package manager.
pt_BR: apt (man, docbook): Gerenciador de pacotes do Debian.

note: type: textblock
en: aptitude (docbook, svg): terminal-based package manager for Debian
pt_BR: aptitude (docbook, svg): Gerenciador de pacotes em interface de texto para Debian

note: type: textblock
en: L<F-Droid website|https://gitlab.com/fdroid/fdroid-website> (markdown): installable catalogue of FOSS (Free and Open Source Software) applications for the Android platform.
pt_BR: L<Site do F-Droid|https://gitlab.com/fdroid/fdroid-website> (markdown): catálogo instalável de aplicativos FOSS (abreviação de software livre e de código aberto) para a plataforma Android.

note: type: textblock
en: L<git|https://github.com/jnavila/git-manpages-l10n> (asciidoc): distributed version-control system for tracking changes in source code.
pt_BR: L<git|https://github.com/jnavila/git-manpages-l10n> (asciidoc): sistema de controle de versão distribuído para alterações de rastreamento em código-fonte.

note: type: textblock
en: L<Linux manpages|https://salsa.debian.org/manpages-l10n-team/manpages-l10n> (man)
pt_BR: L<Páginas man do Linux|https://salsa.debian.org/manpages-l10n-team/manpages-l10n> (man)

note: type: textblock
en: This project provides an infrastructure for translating many manpages to different languages, ready for integration into several major distributions (Arch Linux, Debian and derivatives, Fedora).
pt_BR: Este projeto fornece uma infraestrutura para traduzir muitas páginas man para diferentes idiomas, prontas para integração em várias grandes distribuições (Arch Linux, Debian e derivados, Fedora).

note: type: textblock
en: L<Stellarium|https://github.com/Stellarium/stellarium> (HTML): a free open source planetarium for your computer. po4a is used to translate the sky culture descriptions.
pt_BR: L<Stellarium|https://github.com/Stellarium/stellarium> (HTML): um planetário de código aberto e livre para o seu computador. po4a é usado para traduzir as descrições da cultura do céu.

note: type: textblock
en: Other item to sort out: L<https://gitlab.com/fdroid/fdroid-website/> L<https://github.com/fsfe/reuse-docs/pull/61>
pt_BR: Outro item para resolver: L<https://gitlab.com/fdroid/fdroid-website/> L<https://github.com/fsfe/reuse-docs/pull/61>

note: type: =head2
en: How do you pronounce po4a?
pt_BR: Como você pronuncia po4a?

note: type: textblock
en: I personally vocalize it as L<pouah|https://en.wiktionary.org/wiki/pouah>, which is a French onomatopoetic that we use in place of yuck :) I may have a strange sense of humor :)
pt_BR: Eu pessoalmente vocalizo-o como L<pouah|https://en.wiktionary.org/wiki/pouah>, que é um onomatopoético francês que usamos no lugar de "eca" :) eu posso ter um senso de humor estranho :)

note: type: =head2
en: What about the other translation tools for documentation using gettext?
pt_BR: E as outras ferramentas de tradução para documentação usando gettext?

note: type: textblock
en: This is the tool developed by KDE people to handle DocBook XML. AFAIK, it was the first program to extract strings to translate from documentation to PO files, and inject them back after translation.
pt_BR: Essa é a ferramenta desenvolvida pelo pessoal do KDE para manipular DocBook XML. Até onde eu sei, esse foi o primeiro programa a extrair strings para traduzir de documentação para arquivos PO, e a injetá-las de volta após a tradução.

note: type: textblock
en: It can only handle XML, and only a particular DTD. I'm quite unhappy with the handling of lists, which end in one big msgid. When the list become big, the chunk becomes harder to swallow.
pt_BR: Ela só consegue manipular XML e apenas um DTD em particular. Eu fico, particularmente, não gosto das listas de manipulação, que acabam com um grande msgid. Quando a lista fica grande, o fragmento se torna mais difícil de engolir.

note: type: textblock
en: This program done by Denis Barbier is a sort of precursor of the po4a SGML module, which more or less deprecates it. As the name says, it handles only the DebianDoc DTD, which is more or less a deprecated DTD.
pt_BR: Esse problema desenvolvido por Denis Barbier é uma espécie de precursor do módulo de SGML do po4a, o qual meio que torna-o (po-debiandoc) obsoleto. Como o nome já diz, ele linda apenas o DebianDoc DTD, o qual é meio que um DTD obsoleto.

note: type: textblock
en: The main advantages of po4a over them are the ease of extra content addition (which is even worse there) and the ability to achieve gettextization.
pt_BR: As principais vantagens do po4a sobre eles é a facilidade de adição de conteúdo extra (o que é bem pior lá) e a habilidade de alcançar gettextização.

note: type: =head2
en: SUMMARY of the advantages of the gettext based approach
pt_BR: RESUMO das vantagens da abordagem baseada em gettext

note: type: textblock
en: The translations are not stored along with the original, which makes it possible to detect if translations become out of date.
pt_BR: As traduções não são armazenadas junto do original, o que possibilita detectar se as traduções estão desatualizadas.

note: type: textblock
en: The translations are stored in separate files from each other, which prevents translators of different languages from interfering, both when submitting their patch and at the file encoding level.
pt_BR: As traduções são armazenadas em arquivos separados um dos outros, o que previne tradutores de idiomas diferentes interferir tanto quando da submissão do patch quanto a nível de codificação do arquivo.

note: type: textblock
en: It is based internally on B<gettext> (but B<po4a> offers a very simple interface so that you don't need to understand the internals to use it).  That way, we don't have to re-implement the wheel, and because of their wide use, we can think that these tools are more or less bug free.
pt_BR: Ele é internamente baseado no B<gettext> (mas B<po4a> oferece uma interface bem simples, de forma que você não precisa entender as especificidades para usá-lo). Dessa forma, nós não temos que reinventar a roda e, por causa do seu amplo uso, nós podemos pensar que essas ferramentas meio que não tem erros.

note: type: textblock
en: Nothing changed for the end-user (beside the fact translations will hopefully be better maintained). The resulting documentation file distributed is exactly the same.
pt_BR: Nada mudou para o usuário final (além do fato de traduções estarem melhor mantidas, espero). o arquivo de documentação resultante distribuído é exatamente o mesmo.

note: type: textblock
en: No need for translators to learn a new file syntax and their favorite PO file editor (like Emacs' PO mode, Lokalize or Gtranslator) will work just fine.
pt_BR: Não há necessidade de tradutores aprenderem um novo arquivo de sintaxe e seu editor de arquivos PO (como o modo PO do Emacs, Lokalize ou Gtranslator) vão funcionar muito bem.

note: type: textblock
en: gettext offers a simple way to get statistics about what is done, what should be reviewed and updated, and what is still to do. Some example can be found at those addresses:
pt_BR: gettext oferece uma forma simples de obter estatísticas sobre o que está feito, o que deveria ser revisto e atualizado e o que ainda deve ser feito. Alguns exemplos podem ser encontrados nesses endereços:

note: type: verbatim
en:  - https://docs.kde.org/stable5/en/kdesdk/lokalize/project-view.html
     - http://www.debian.org/intl/l10n/
pt_BR:  - https://docs.kde.org/stable5/pt_BR/kdesdk/lokalize/project-view.html
     - http://www.debian.org/intl/l10n/

note: type: textblock
en: But everything isn't green, and this approach also has some disadvantages we have to deal with.
pt_BR: Mas tudo tem seu lado negativo, e essa abordagem tem algumas desvantagens com as quais nós temos que lidar.

note: type: textblock
en: Addenda are… strange at the first glance.
pt_BR: Adendos são… estranhos à primeira vista.

note: type: textblock
en: You can't adapt the translated text to your preferences, like splitting a paragraph here, and joining two other ones there. But in some sense, if there is an issue with the original, it should be reported as a bug anyway.
pt_BR: Você não pode adaptar o texto traduzido às suas preferências, com divisão de um parágrafo aqui e juntar outros dois ali. Mas de certa forma, se há um problema com o original, isso deveria ser relatado como um erro.

note: type: textblock
en: Even with an easy interface, it remains a new tool people have to learn.
pt_BR: Até mesmo com uma interface fácil, ainda é uma nova ferramenta que as pessoas precisam aprender.

note: type: textblock
en: One of my dreams would be to integrate somehow po4a to Gtranslator or Lokalize. When a documentation file is opened, the strings are automatically extracted, and a translated file + po file can be written to disk. If we manage to do an MS Word (TM) module (or at least RTF) professional translators may even use it.
pt_BR: Um dos meus sonhos seria integrar de alguma forma po4a ao Gtranslator ou Lokalize. Quando um arquivo de documento fosse aberto, as strings seriam automaticamente extraídas e um arquivo traduzido + arquivo po poderia ser gravado no disco. Se nós conseguirmos fazer um módulo para MS Word (TM) (ou pelo menos RTF), tradutores profissionais podem até mesmo usá-lo.

note: type: textblock
en: The documentation of the all-in-one tool that you should use: L<po4a(1)>.
pt_BR: A documentação da ferramenta multifuncional que você deve usar: L<po4a(1)>.

note: type: textblock
en: The documentation of the individual po4a scripts: L<po4a-gettextize(1)>, L<po4a-updatepo(1)>, L<po4a-translate(1)>, L<po4a-normalize(1)>.
pt_BR: A documentação dos scripts individuais do po4a: L<po4a-gettextize(1)>, L<po4a-updatepo(1)>, L<po4a-translate(1)>, L<po4a-normalize(1)>.

note: type: textblock
en: The additional helping scripts: L<msguntypot(1)>, L<po4a-display-man(1)>, L<po4a-display-pod(1)>.
pt_BR: Os scripts de ajuda adicionais: L<msguntypot(1)>, L<po4a-display-man(1)>, L<po4a-display-pod(1)>.

note: type: textblock
en: The parsers of each formats, in particular to see the options accepted by each of them: L<Locale::Po4a::AsciiDoc(3pm)> L<Locale::Po4a::Dia(3pm)>, L<Locale::Po4a::Guide(3pm)>, L<Locale::Po4a::Ini(3pm)>, L<Locale::Po4a::KernelHelp(3pm)>, L<Locale::Po4a::Man(3pm)>, L<Locale::Po4a::RubyDoc(3pm)>, L<Locale::Po4a::Texinfo(3pm)>, L<Locale::Po4a::Text(3pm)>, L<Locale::Po4a::Xhtml(3pm)>, L<Locale::Po4a::Yaml(3pm)>, L<Locale::Po4a::BibTeX(3pm)>, L<Locale::Po4a::Docbook(3pm)>, L<Locale::Po4a::Halibut(3pm)>, L<Locale::Po4a::LaTeX(3pm)>, L<Locale::Po4a::Pod(3pm)>, L<Locale::Po4a::Sgml(3pm)>, L<Locale::Po4a::TeX(3pm)>, L<Locale::Po4a::Wml(3pm)>, L<Locale::Po4a::Xml(3pm)>.
pt_BR: Os analisadores de cada formato, em particular para ver as opções aceitas por cada um deles: L<Locale::Po4a::AsciiDoc(3pm)> L<Locale::Po4a::Dia(3pm)>, L<Locale::Po4a::Guide(3pm)>, L<Locale::Po4a::Ini(3pm)>, L<Locale::Po4a::KernelHelp(3pm)>, L<Locale::Po4a::Man(3pm)>, L<Locale::Po4a::RubyDoc(3pm)>, L<Locale::Po4a::Texinfo(3pm)>, L<Locale::Po4a::Text(3pm)>, L<Locale::Po4a::Xhtml(3pm)>, L<Locale::Po4a::Yaml(3pm)>, L<Locale::Po4a::BibTeX(3pm)>, L<Locale::Po4a::Docbook(3pm)>, L<Locale::Po4a::Halibut(3pm)>, L<Locale::Po4a::LaTeX(3pm)>, L<Locale::Po4a::Pod(3pm)>, L<Locale::Po4a::Sgml(3pm)>, L<Locale::Po4a::TeX(3pm)>, L<Locale::Po4a::Wml(3pm)>, L<Locale::Po4a::Xml(3pm)>.

note: type: textblock
en: The implementation of the core infrastructure: L<Locale::Po4a::TransTractor(3pm)> (particularly important to understand the code organization), L<Locale::Po4a::Chooser(3pm)>, L<Locale::Po4a::Po(3pm)>, L<Locale::Po4a::Common(3pm)>. Please also check the F<CONTRIBUTING.md> file in the source tree.
pt_BR: A implementação da infraestrutura principal: L<Locale::Po4a::TransTractor(3pm)> (particularmente importante para entender a organização do código), L<Locale::Po4a::Chooser(3pm)>, L<Locale::Po4a::Po(3pm)>, L<Locale::Po4a::Common(3pm)>. Por favor, verifique também o arquivo F<CONTRIBUTING.md> na árvore de fonts.

note: type: textblock
en: Locale::Po4a::AsciiDoc - convert AsciiDoc documents from/to PO files
pt_BR: Locale::Po4a::AsciiDoc - converte documentos AsciiDoc de/para arquivos PO

note: type: textblock
en: Locale::Po4a::AsciiDoc is a module to help the translation of documentation in the AsciiDoc format.
pt_BR: Locale::Po4a::AsciiDoc é um módulo para ajudar a tradução de documentação no formato AsciiDoc.

note: type: =head1
en: OPTIONS ACCEPTED BY THIS MODULE
pt_BR: OPÇÕES ACEITAS POR ESTE MÓDULO

note: type: textblock
en: These are this module's particular options:
pt_BR: Estas são as opções específicas deste módulo:

note: type: textblock
en: The name of a file containing definitions for po4a, as defined in the B<INLINE CUSTOMIZATION> section.  You can use this option if it is not possible to put the definitions in the document being translated.
pt_BR: O nome de um arquivo contendo definições para o po4a, como definido na seção B<PERSONALIZAÇÃO INTEGRADA>. Você pode usar esta opção se não for possível colocar as definições no documento que está sendo traduzido.

note: type: textblock
en: In a definitions file, lines must not start by two slashes, but directly by B<po4a:>.
pt_BR: Em um arquivo de definições, as linhas não podem começar com duas barras, e sim diretamente pelo B<po4a:>.

note: type: textblock
en: Space-separated list of attribute entries you want to translate.  By default, no attribute entries are translatable.
pt_BR: Lista separada por espaço das entradas de atributos que você deseja traduzir. Por padrão, nenhuma entrada de atributo é traduzida.

note: type: textblock
en: Space-separated list of macro definitions.
pt_BR: Lista separada por espaço das definições de macro.

note: type: textblock
en: Space-separated list of style definitions.
pt_BR: Lista separada por espaço das definições de estilos.

note: type: textblock
en: Enable automatic line wrapping in non-verbatim blocks, even if the result could be misinterpreted by AsciiDoc formatters.
pt_BR: Habilita a quebra automática de linha em blocos não verbais, mesmo que o resultado possa ser mal interpretado pelos formatadores AsciiDoc.

note: type: textblock
en: By default, po4a will not wrap the produced AsciiDoc files because a manual inspection is mandated to ensure that the wrapping does not change the formatting. Consider for instance the following list item:
pt_BR: Por padrão, po4a não aplicará a quebra os arquivos AsciiDoc produzidos porque uma inspeção manual é obrigatória para garantir que o quebra não altere a formatação. Considere, por exemplo, o seguinte item da lista:

note: type: verbatim
en:  * a long sentence that is ending with a number 1. A second sentence.
pt_BR:  * uma frase longa que termina com um número 1. Uma segunda frase.

note: type: textblock
en: If the wrapping leads to the following presentation, the item is split into a numbered sub-list. To make things worse, only the speakers of the language used in the translation can inspect the situation.
pt_BR: Se a quebra levar à apresentação a seguir, o item será dividido em uma sub-lista numerada. Para piorar as coisas, apenas os falantes do idioma usado na tradução podem inspecionar a situação.

note: type: verbatim
en:  * a long sentence that is ending with a number
       1. A second sentence.
pt_BR:  * uma longa frase que está terminando com um número
       1. Uma segunda frase.

note: type: textblock
en: Note that not wrapping the files produced by po4a should not be a problem since those files are meant to be processed automatically.  They should not be regarded as source files anyway.
pt_BR: Observe que não fazer quebra os arquivos produzidos pelo po4a não deve ser um problema, uma vez que esses arquivos devem ser processados automaticamente.  Eles não devem ser considerados como arquivos fonte de qualquer maneira.

note: type: textblock
en: With this option, po4a will produce better-looking source files, that may lead to possibly erroneous formatted outputs.
pt_BR: Com esta opção, o po4a produzirá arquivos fonte mais apresentáveis, que podem levar a saídas possivelmente errôneas formatadas.

note: type: textblock
en: By default, the targets of block images are translatable to give opportunity to make the content point to translated images. This can be stopped by setting this option.
pt_BR: Por padrão, os alvos das imagens de bloco são traduzíveis para dar oportunidade de fazer com que o conteúdo aponte para imagens traduzidas. Isso pode ser impedido configurando essa opção.

note: type: textblock
en: This option is a flag that enables sub-table segmentation into cell content.  The segmentation is limited to cell content, without any parsing inside of it.
pt_BR: Essa é uma opção que permite segmentação de uma subtabela em conteúdo de célula. A segmentação está limitada a conteúdo de célula, sem qualquer análise de que está dentro.

note: type: textblock
en: Switch parsing rules to compatibility with different tools. Available options are "asciidoc" or "asciidoctor". Asciidoctor has stricter parsing rules, such as equality of length of opening and closing block fences.
pt_BR: Muda as regras de análise para compatibilidade com diferentes ferramentas. As opções disponíveis são "asciidoc" ou "asciidoctor". O Asciidoctor possui regras de análise mais rígidas, como a igualdade do comprimento das aberturas dos blocos de abertura e fechamento.

note: type: textblock
en: Disable linting messages. When the source code cannot be fixed for clearer document structure, these messages are useless.
pt_BR: Desativa mensagens lintagem. Quando o código-fonte não pode ser corrigido para uma estrutura de documento mais clara, essas mensagens são inúteis.

note: type: textblock
en: Do not translate array values in the YAML Front Matter section.
pt_BR: Não traduz os valores de vetor na seção YAML Front Matter.

note: type: =head1
en: INLINE CUSTOMIZATION
pt_BR: PERSONALIZAÇÃO INTEGRADA

note: type: textblock
en: The AsciiDoc module can be customized with lines starting by B<//po4a:>.  These lines are interpreted as commands to the parser.  The following commands are recognized:
pt_BR: O módulo AsciiDoc pode ser personalizado com linhas começando com B<//po4a:>. Estas linhas são interpretadas como comandos para analisar. Os seguintes comandos são reconhecidos:

note: type: =item
en: B<//po4a: macro >I<name>B<[>I<attribute list>B<]>
pt_BR: B<//po4a: macro >I<nome>B<[>I<lista de atributos>B<]>

note: type: textblock
en: This describes in detail the parameters of a B<macro>; I<name> must be a valid macro name, and it ends with an underscore if the target must be translated.
pt_BR: Isso descreve em detalhe os parâmetros de uma B<macro>; I<nome> deve ser um nome de macro válida e termina com um sublinhado se o alvo deve ser traduzido.

note: type: textblock
en: The I<attribute list> argument is a comma separated list which contains information about translatable arguments.  This list contains either numbers, to define positional parameters, or named attributes.
pt_BR: O argumento I<lista de argumentos> é uma lista separada por vírgulas que contém informações sobre argumentos traduzíveis. Esta lista contém números, para definir parâmetros posicionais, ou atributos nomeados.

note: type: textblock
en: If a plus sign (B<+>) is prepended to I<name>, then the macro and its arguments are translated as a whole.  There is no need to define attribute list in this case, but brackets must be present.
pt_BR: Se um sinal de mais (B<+>) é prefixo de I<nome>, então a macro e seus argumentos são traduzidos como um todo. Não há necessidade de definir uma lista de atributos neste caso, mas colchetes devem estar presentes.

note: type: =item
en: B<//po4a: style >B<[>I<attribute list>B<]>
pt_BR: B<//po4a: estilo >B<[>I<lista de atributos>B<]>

note: type: textblock
en: This describes in detail which attributes of a style must be translated.
pt_BR: Isso descreve em detalhe quais atributos de um estilo deve ser traduzido.

note: type: textblock
en: The I<attribute list> argument is a comma separated list which contains information about translatable arguments.  This list contains either numbers, to define positional parameters, or named attributes.  The first attribute is the style name, it will not be translated.
pt_BR: O argumento I<lista de argumentos> é uma lista separada por vírgulas que contém informações sobre argumentos traduzíveis. Esta lista contém números, para definir parâmetros posicionais, ou atributos nomeados. O primeiro atributo é o nome do estilo e não será traduzido.

note: type: textblock
en: If a plus sign (B<+>) is prepended to the style name, then the attribute list is translated as a whole.  There is no need to define translatable attributes.
pt_BR: Se um sinal de mais (B<+>) é prefixo do nome do estilo, então a lista de atributos é traduzida como um todo. Não há necessidade de definir atributos traduzíveis.

note: type: textblock
en: If a minus sign (B<->) is prepended to the style name, then this attribute is not translated.
pt_BR: Se um sinal de menos (B<->) é prefixo do nome do estilo, então este atributo não é traduzido.

note: type: =item
en: B<//po4a: entry >I<name>
pt_BR: B<//po4a: entrada >I<nome>

note: type: textblock
en: This declares an attribute entry as being translatable.  By default, they are not translated.
pt_BR: Isso declara uma entrada de atributo como sendo traduzível. Por padrão, eles não estão traduzidos.

note: type: =head1
en: STATUS OF THIS MODULE
pt_BR: ESTADO DESTE MÓDULO

note: type: textblock
en: Tested successfully on simple AsciiDoc files.
pt_BR: Testado com sucesso em arquivos AsciiDoc simples.

note: type: verbatim
en:  Copyright © 2005-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.
     Copyright © 2012 Denis BARBIER <barbier@linuxfr.org>.
     Copyright © 2017 Martin Quinson <mquinson#debian.org>.
pt_BR:  Copyright © 2005-2008 Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.
     Copyright © 2012 Denis BARBIER <barbier@linuxfr.org>.
     Copyright © 2017 Martin Quinson <mquinson@debian.org>.

note: type: textblock
en: Locale::Po4a::BibTeX - convert BibTeX documents from/to PO files
pt_BR: Locale::Po4a::BibTeX - converte documentos BibTeX de/para arquivos PO

note: type: textblock
en: Locale::Po4a::BibTeX is a module to help the translation of bibliographies in the BibTeX format into other [human] languages.
pt_BR: Locale::Po4a::BibTeX é um módulo para ajudar a tradução de bibliografias no formato BibTeX para outros idiomas.

note: type: textblock
en: Fields values are extracted and proposed for translation.
pt_BR: Valores de campos são extraídos e propostos para tradução.

note: type: textblock
en: NONE.
pt_BR: NENHUMA.

note: type: textblock
en: It is a very simple module, but still young.
pt_BR: É um módulo bem simples, e mesmo assim novo.

note: type: textblock
en: Locale::Po4a::Chooser - manage po4a modules
pt_BR: Locale::Po4a::Chooser - gerencia módulos do po4a

note: type: textblock
en: Locale::Po4a::Chooser is a module to manage po4a modules. Previously, all po4a binaries used to know all po4a modules (pod, man, sgml, etc). This made the addition of a new module boring, because you had to make sure that the documentation is synchronized in all modules, and that each of them can access the new module.
pt_BR: Locale::Po4a::Chooser é um módulo para gerenciar módulos do po4a. Anteriormente, todos os executáveis do po4a conheciam todos os módulos do po4a (pod, man, sgml, etc). Isso tornou chato adicionar um novo módulo, por ter de certificar que a documentação está sincronizada em todos os módulos e que cada um deles tenha acesso ao novo módulo.

note: type: textblock
en: Now, you just have to call the Locale::Po4a::Chooser::new() function, passing the name of module as argument.
pt_BR: Agora, você só tem que chamar a função Locale::Po4a::Chooser::new(), passando o nome do módulo como argumento.

note: type: textblock
en: The function Locale::Po4a::Chooser::list() lists the available formats, and exits with the value passed as argument. So, we call Locale::Po4a::Chooser::list(0) when requested for the list of formats, and Locale::Po4a::Chooser::list(1) when passed an invalid format name.
pt_BR: A função Locale::Po4a::Chooser::list() lista os formatos disponíveis e sai com o valor passado como argumento. Portanto, chamamos Locale::Po4a::Chooser::list(0) quando solicitarmos a lista de formatos e Locale::Po4a::Chooser::list(1) quando passarmos um nome de formato inválido.

note: type: =item
en: About po4a:
pt_BR: Sobre o po4a:

note: type: =item
en: About modules:
pt_BR: Sobre os módulos:

note: type: textblock
en: Copyright © 2002-2005, 2014, 2017 SPI, Inc.
pt_BR: Copyright © 2002-2005,2014,2017 SPI, Inc.

note: type: textblock
en: Locale::Po4a::Common - common parts of the po4a scripts and utils
pt_BR: Locale::Po4a::Common - partes comuns dos scripts e utilitários do po4a

note: type: textblock
en: Locale::Po4a::Common contains common parts of the po4a scripts and some useful functions used along the other modules.
pt_BR: Locale::Po4a::Common contém partes comuns dos scripts do po4a e algumas funções úteis usadas junto com outros módulos.

note: type: textblock
en: If needed, you can disable the use of Text::WrapI18N as such:
pt_BR: Se necessário, você pode desabilitar o uso de Text::WrapI18N da seguinte forma:

note: type: textblock
en: instead of:
pt_BR: em vez de:

note: type: textblock
en: The ordering is important here: as most Locale::Po4a modules load themselves Locale::Po4a::Common, the first time this module is loaded determines whether Text::WrapI18N is used.
pt_BR: A ordem é importante aqui: como a maioria dos próprios módulos Locale::Po4a carregam Locale::Po4a::Common, a primeira vez que este módulo é carregado determina se Text::WrapI18N é usado.

note: type: =head1
en: FUNCTIONS
pt_BR: FUNÇÕES

note: type: =head2
en: Showing output messages
pt_BR: Mostrando as mensagens de saída

note: type: textblock
en: Shows the current version of the script, and a short copyright message. It takes the name of the script as an argument.
pt_BR: Mostra a versão atual do script e uma curta mensagem de direitos autorais. Pega o nome do script como um argumento.

note: type: textblock
en: This function displays a message the same way as sprintf() does, but wraps the result so that they look nice on the terminal.
pt_BR: Esta função exibe uma mensagem da mesma forma que o sprintf(), mas dimensiona o resultado de forma que elas fiquem legal no terminal.

note: type: textblock
en: This function works like wrap_msg(), but it takes a module name as the first argument, and leaves a space at the left of the message.
pt_BR: Esta função funciona como wrap_msg(), mas pega o nome de um módulo como o primeiro argumento e deixa um espaço à esquerda da mensagem.

note: type: textblock
en: This function works like wrap_msg(), but it takes a file:line reference as the first argument, a module name as the second one, and leaves a space at the left of the message.
pt_BR: Esta função funciona como o wrap_msg(), mas leva uma referência arquivo:linha como primeiro argumento, um nome de módulo como o segundo e deixa um espaço à esquerda da mensagem.

note: type: =head2
en: Wrappers for other modules
pt_BR: Wrappers para outros módulos

note: type: textblock
en: When the Locale::Gettext module cannot be loaded, this module provide dummy (empty) implementation of the following functions. In that case, po4a messages won't get translated but the program will continue to work.
pt_BR: Quando o módulo Locale::Gettext não puder ser carregado, este módulo fornece uma implementação fictícia (vazia) das funções a seguir. Neste caso, as mensagens do po4a não serão traduzidas, mas o programa vai continuar a funcionar.

note: type: textblock
en: If Locale::gettext is present, this wrapper also calls setlocale(LC_MESSAGES, "") so callers don't depend on the POSIX module either.
pt_BR: Se Locale::gettext estiver presente, este wrapper também chama setlocale(LC_MESSAGES, "") de forma que chamadores também não dependam do módulo POSIX.

note: type: textblock
en: Copyright © 2005 SPI, Inc.
pt_BR: Copyright © 2005 SPI, inc.

note: type: textblock
en: Locale::Po4a::Dia - convert uncompressed Dia diagrams from/to PO files
pt_BR: Locale::Po4a::Dia - converte diagramas Dia descompactados de/para arquivos PO

note: type: textblock
en: Locale::Po4a::Dia is a module to help the translation of diagrams in the uncompressed Dia format into other [human] languages.
pt_BR: Locale::Po4a::Dia é um módulo para ajudar a tradução de diagramas no formato Dia descompactados em outros idiomas.

note: type: verbatim
en: You can get Dia (the graphical editor for these diagrams) from:
      http://www.gnome.org/projects/dia/
pt_BR: Você pode obter Dia (o editor gráfico para estes diagramas) de:
      http://www.gnome.org/projects/dia/

note: type: =head1
en: TRANSLATING WITH PO4A::DIA
pt_BR: TRADUZINDO COM PO4A::DIA

note: type: textblock
en: This module only translates uncompressed Dia diagrams.  You can save your uncompressed diagrams with Dia itself, unchecking the "Compress diagram files" at the "Save Diagram" dialog.
pt_BR: Este módulo apenas traduz diagramas Dia descompactados. Você pode salvar seus diagramas descompactados com o próprio Dia, desmarcando o "Compactar os arquivos de diagrama" no diálogo de "Salvar diagrama".

note: type: verbatim
en: Another way is to uncompress the dia files from command line with:
      gunzip < original.dia > uncompressed.dia
pt_BR: Outra forma é descompactar os arquivos dia da linha de comando com:
      gunzip < original.dia > descompactado.dia

note: type: textblock
en: This module is fully functional, as it relies in the L<Locale::Po4a::Xml> module. This only defines the translatable tags (E<lt>dia:stringE<gt>), and filters the internal strings (the content of the E<lt>dia:diagramdataE<gt> tag), not interesting for translation.
pt_BR: Este módulo é completamente funcional, pois depende do módulo L<Locale::Po4a::Xml>. Este apenas define as marcações traduzíveis (E<lt>dia:stringE<gt>) e filtra as strings internas (o conteúdo do E<lt>dia:diagramdataE<gt> tag), não interessante para a tradução.

note: type: textblock
en: Locale::Po4a::Docbook - convert DocBook XML documents from/to PO files
pt_BR: Locale::Po4a::Docbook - converte documentos DocBook XML de/para arquivos PO

note: type: textblock
en: Locale::Po4a::Docbook is a module to help the translation of DocBook XML documents into other [human] languages.
pt_BR: Locale::Po4a::Docbook é um módulo para ajudar a tradução de documentos DocBook XML em outros idiomas.

note: type: textblock
en: This module is fully functional, as it relies in the L<Locale::Po4a::Xml> module. This only defines the translatable tags and attributes.
pt_BR: Este módulo é completamente funcional, pois depende do módulo L<Locale::Po4a::Xml>. Este apenas define as marcações e atributos traduzíveis.

note: type: textblock
en: The only known issue is that it doesn't handle entities yet, and this includes the file inclusion entities, but you can translate most of those files alone (except the typical entities files), and it's usually better to maintain them separated.
pt_BR: O único problema conhecido é que ele não lida com entidades ainda e isso inclui as entidades de inclusão de arquivo, mas você pode traduzir a maioria daqueles arquivos sozinhos (exceto os arquivos de entidades comuns) e normalmente é melhor mantê-los separadamente.

note: type: =head2
en: OVERRIDE THE DEFAULT BEHAVIOR WITH COMMAND LINE OPTIONS
pt_BR: SUBSTITUIÇÃO DO COMPORTAMENTO PADRÃO COM AS OPÇÕES DE LINHA DE COMANDO

note: type: textblock
en: The default behavior of system provided modules is set to be on the safe side.
pt_BR: O comportamento padrão dos módulos fornecidos pelo sistema é configurado para estar no lado seguro.

note: type: textblock
en: For example, the default of B<< <author> >> tag is aiming it to appear under B<< <para> >>.  But you may be using it only under B<< <bookinfo> >>.  For this case, you may want to translate it independently for each author.
pt_BR: Por exemplo, o padrão da tag B<< <author> >> está apontando para aparecer em B<< <para> >>. Mas você pode estar usando apenas em B<< <bookinfo> >>. Para este caso, você pode querer traduzi-lo independentemente para cada autor.

note: type: textblock
en: If you don't like the default behavior of the xml module and its derivative modules, you can provide command line options to change their behavior.  For example, you can add the following to the po4a configuration file:
pt_BR: Se você não gostar do comportamento padrão do módulo xml e seus módulos derivados, poderá fornecer opções de linha de comando para alterar seu comportamento. Por exemplo, você pode adicionar o seguinte ao arquivo de configuração po4a:

note: type: textblock
en: This overrides the default behavior for B<< <bookinfo> >> and B<< <author> >>, set B<< <bookinfo> >> and B<< <author> >> to break input data stream on these tags, set B<< <bookinfo> >> not to translate its tagged content, and set B<< <author> >> to translate its tagged content.
pt_BR: Isso substitui o comportamento padrão para B<< <bookinfo> >> e B<< <author> >>, define B<< <bookinfo> >> e B<< <author> >> para interromper o fluxo de dados de entrada nesses tags , define B<< <bookinfo> >> para não traduzir seu conteúdo marcado e defina B<< <author> >> para traduzir seu conteúdo marcado.

note: type: textblock
en: Locale::Po4a::Guide - convert Guide XML documents from/to PO files
pt_BR: Locale::Po4a::Guide - converte documentos GuideXML de/para arquivos PO

note: type: textblock
en: Locale::Po4a::Guide is a module to help in the translation of the Gentoo Linux documentation in the Guide XML format into other [human] languages.
pt_BR: Locale::Po4a::Guide é um módulo para ajudar na tradução da documentação do Gentoo Linux no formato GuideXML para outros idiomas.

note: type: textblock
en: This format is documented here: http://www.gentoo.org/doc/en/xml-guide.xml
pt_BR: Este formato está documentado aqui: http://www.gentoo.org/doc/en/xml-guide.xml

note: type: textblock
en: The only known issue is that it doesn't include files with the <include href="..."> tag, but you can translate all those files alone, and it's usually better to have them separated.
pt_BR: O único problema conhecido é que ele não inclui arquivos com a marcação <include href="...">, mas você pode traduzir todos aqueles arquivos por conta própria, e normalmente é melhor tê-los separados.

note: type: textblock
en: Locale::Po4a::Halibut - convert Halibut documents and derivates from/to PO files
pt_BR: Locale::Po4a::Halibut - converte documentos Halibut e deriva de/para arquivos PO

note: type: textblock
en: Locale::Po4a::Halibut is a module to help the translation of Halibut documents into other [human] languages.
pt_BR: Locale::Po4a::Halibut é um módulo para ajudar a tradução de documentos para outros idiomas.

note: type: textblock
en: This module contains the definitions of common Halibut commands and environments.
pt_BR: Este módulo contém as definições de comandos e ambientes comuns de Halibut.

note: type: textblock
en: This module is still beta.  Please send feedback and feature requests.
pt_BR: Este módulo ainda é beta. Por favor, envie feedback e pedidos de funcionalidades.

note: type: =head1
en: CAVEAT
pt_BR: AVISO

note: type: textblock
en: Some constructs are badly supported. The known ones are documented below.
pt_BR: Alguns constructs possuem suporte bem ruim. Os já conhecidos estão documentados abaixo.

note: type: =head2
en: Verbatim blocks
pt_BR: Bloco de textos

note: type: textblock
en: The verbatim block is not considered as a whole. Each line will be translated separately.
pt_BR: O bloco de texto não é considerado como um todo. Cada linha será traduzida separadamente.

note: type: textblock
en: This program is free software; you may redistribute it and/or modify it under the terms of GPL (see COPYING file).
pt_BR: Este programa é um software livre; você pode redistribuí-lo e/ou modificá-lo sob os termos da GPL (veja o arquivo COPYING).

note: type: textblock
en: Locale::Po4a::Ini - convert INI files from/to PO files
pt_BR: Locale::Po4a::Ini - converte arquivos INI de/para arquivos PO

note: type: textblock
en: Locale::Po4a::Ini is a module to help the translation of INI files into other [human] languages.
pt_BR: Locale::Po4a::Ini é um módulo para ajudar a tradução de arquivos INI para outros idiomas.

note: type: textblock
en: The module searches for lines of the following format and extracts the quoted text:
pt_BR: O módulo procura por linhas no formato a seguir e extrai o texto entre aspas:

note: type: textblock
en: identificator="text than can be translated"
pt_BR: identificator="texto que pode ser traduzido"

note: type: textblock
en: NOTE: If the text is not quoted, it will be ignored.
pt_BR: NOTA: se o texto não estiver entre aspas, ele será ignorado.

note: type: textblock
en: Locale::Po4a::KernelHelp - convert kernel configuration help from/to PO files
pt_BR: Locale::Po4a::KernelHelp - converte a ajuda de configuração do kernel de/para arquivos PO

note: type: textblock
en: Locale::Po4a::KernelHelp is a module to help the translation of documentation for the Linux kernel configuration options into other [human] languages.
pt_BR: Locale::Po4a::KernelHelp é um módulo para ajudar a tradução de documentação das opções de configuração do Kernel Linux para outros idiomas.

note: type: textblock
en: This module is just written, and needs more tests. Most of the needed work will concern the tools used to parse this file (and configure the kernel), so that they accept to read the documentation from another (translated)  file.
pt_BR: Este módulo está apenas escrito, e precisa de mais testes. A maioria do trabalho necessário refere-se as ferramentas usadas para analisar este arquivo (e configurar o kernel) de forma que elas aceitem ler a documentação de outro arquivo (traduzido).

note: type: textblock
en: Locale::Po4a::LaTeX - convert LaTeX documents and derivates from/to PO files
pt_BR: Locale::Po4a::LaTeX - converte documentos LaTeX e derivados de/para arquivos PO

note: type: textblock
en: Locale::Po4a::LaTeX is a module to help the translation of LaTeX documents into other [human] languages. It can also be used as a base to build modules for LaTeX-based documents.
pt_BR: Locale::Po4a::LaTeX é um módulo para ajudar a tradução de documentos LaTeX para outros idiomas. Ele também pode ser usado como base para criar módulos para documentos baseado em LaTeX.

note: type: textblock
en: This module contains the definitions of common LaTeX commands and environments.
pt_BR: Este módulo contém as definições de comandos e ambientes LaTeX comuns.

note: type: textblock
en: See the L<Locale::Po4a::TeX(3pm)|Locale::Po4a::TeX> manpage for the list of recognized options.
pt_BR: Veja a página man L<Locale::Po4a::TeX(3pm)|Locale::Po4a::TeX> para a lista de opções reconhecidas.

note: type: textblock
en: Locale::Po4a::Man - convert manual pages from/to PO files
pt_BR: Locale::Po4a::Man - converte páginas de manual de/para arquivos PO

note: type: textblock
en: Locale::Po4a::Man is a module to help the translation of documentation in the nroff format (the language of manual pages) into other [human] languages.
pt_BR: Locale::Po4a::Man é um módulo para ajudar a tradução de documentação no formato nroff (o idioma das páginas de manual) para outros idiomas.

note: type: =head1
en: TRANSLATING WITH PO4A::MAN
pt_BR: TRADUZINDO COM PO4A::MAN

note: type: textblock
en: This module tries pretty hard to make translator's life easier. For that, the text presented to translators isn't a verbatim copy of the text found in the man page. Indeed, the cruder parts of the nroff format are hidden, so that translators can't mess up with them.
pt_BR: Este módulo tenta com muito esforço tornar a vida do tradutor mais fácil. Para isso, o texto apresentado para os tradutores não é uma cópia exata do texto encontrado na página de manual. Exatamente: as partes mais cruas do formato nroff são ocultadas de forma que os tradutores não possam se complicar com elas.

note: type: =head2
en: Text wrapping
pt_BR: Dimensionamento de texto

note: type: textblock
en: Unindented paragraphs are automatically rewrapped for the translator.  This can lead to some minor difference in the generated output, since the rewrapping rules used by groff aren't very clear. For example, two spaces after a parenthesis are sometimes preserved.
pt_BR: Parágrafos sem recuo são automaticamente redimensionados para o tradutor. Isso pode levar a alguma pequena diferença no resultado gerado, já que regras de redimensionamento usadas pelo groff não são muito claras. Por exemplo, dois espaços após um parêntese é mantido em alguns casos.

note: type: textblock
en: Anyway, the difference will only be about the position of the extra spaces in wrapped paragraph, and I think it's worth.
pt_BR: De qualquer forma, a diferença será apenas sobre a posição de espaços extras em parágrafos dimensionados, e eu acho que isso vale a pena.

note: type: =head2
en: Font specification
pt_BR: Especificação de fonte

note: type: textblock
en: The first change is about font change specifications.  In nroff, there are several ways to specify if a given word should be written in small, bold or italics. In the text to translate, there is only one way, borrowed from the POD (Perl online documentation) format:
pt_BR: A primeira alteração é sobre especificação de alteração de fontes. No nroff, há várias formas de especificar se uma palavra fornecida deveria ser escrita diminuída, negrito ou itálico. No texto para traduzir, há apenas uma forma, emprestada do formato POD (documentação on-line do Perl):

note: type: =item
en: IE<lt>textE<gt> -- italic text
pt_BR: IE<lt>textoE<gt> -- texto em itálico

note: type: textblock
en: equivalent to \fItext\fP or ".I text"
pt_BR: equivalente a \fItexto\fP ou ".I texto"

note: type: =item
en: BE<lt>textE<gt> -- bold text
pt_BR: BE<lt>textoE<gt> -- texto em negrito

note: type: textblock
en: equivalent to \fBtext\fP or ".B text"
pt_BR: equivalente a \fBtexto\fP or ".B texto"

note: type: =item
en: RE<lt>textE<gt> -- roman text
pt_BR: RE<lt>textoE<gt> -- texto em romano

note: type: textblock
en: equivalent to \fRtext\fP
pt_BR: equivalente a \fRtexto\fP

note: type: =item
en: CWE<lt>textE<gt> -- constant width text
pt_BR: CWE<lt>textoE<gt> -- texto com largura fixa

note: type: textblock
en: equivalent to \f(CWtext\fP or ".CW text"
pt_BR: equivalente a \f(CWtexto\fP ou ".CW texto"

note: type: textblock
en: Remark: The CW face is not available for all groff devices. It is not recommended to use it. It is provided for your convenience.
pt_BR: Observação: A opção CW não está disponível para todos os dispositivos groff. Não é recomendável usá-lo. Ele é fornecido para sua conveniência.

note: type: =head2
en: Automatic characters transliteration
pt_BR: Transliteração automática de caracteres

note: type: textblock
en: Po4a automatically transliterate some characters to ease the translation or the review of the translation.  Here is the list of the transliterations:
pt_BR: Po4a translitera automaticamente alguns caracteres para facilitar a tradução ou a revisão da tradução. Aqui está a lista de transliterações:

note: type: =item
en: hyphens
pt_BR: hífenes

note: type: textblock
en: Hyphens (-) and minus signs (\-) in man pages are all transliterated as simple dashes (-) in the PO file.  Then all dash are transliterated into roff minus signs (\-) when the translation is inserted into the output document.
pt_BR: Sinais de hífenes (-) e de menos (\-) em páginas de manual são todas transliteradas como traços simples (-) nos arquivos PO. Então, todos os traços são transliterados em sinais roff de menos (\-) quando a tradução é inserida no documento de saída.

note: type: textblock
en: Translators can force an hyphen by using the roff glyph '\[hy]' in their translations.
pt_BR: Tradutores podem forçar um hífen usando o glifo "\[hy]" do roff em suas traduções.

note: type: =item
en: non-breaking spaces
pt_BR: espaço rígido

note: type: textblock
en: Translators can use non-breaking spaces in their translations.  These non-breaking spaces (0xA0 in latin1) will be transliterated into a roff non-breaking space ('\ ').
pt_BR: Tradutores podem usar espaços rígidos (também conhecidos como "espaços fixos") em suas traduções. Esses espaços rígidos (0xA0 em latin1) será transliterado para um espaço rígido ("\ ").

note: type: =item
en: quotes transliterations
pt_BR: transliterações de aspas

note: type: textblock
en: `` and '' are respectively tranliterated into \*(lq and \*(rq.
pt_BR: `` e '' são transliteradas, respectivamente, para \*(lq e \*(rq.

note: type: textblock
en: To avoid these transliterations, translators can insert a zero width roff character (i.e., using `\&` or '\&' respectively).
pt_BR: Para evitar essas transliterações, os tradutores podem inserir um caractere roff com zero de largura (isto é, usando `\&` ou '\&', respectivamente).

note: type: =head2
en: Putting 'E<lt>' and 'E<gt>' in translations
pt_BR: Colocando "E<lt>" e "E<gt>" nas traduções

note: type: textblock
en: Since these chars are used to delimit parts under font modification, you can't use them verbatim. Use EE<lt>ltE<gt> and EE<lt>gtE<gt> instead (as in POD, one more time).
pt_BR: Já que esses caracteres são usados para delimitar partes sob modificação de fonte, você não pode usá-los literalmente. Use EE<lt>ltE<gt> e EE<lt>gtE<gt> em vez disso (como em POD, novamente).

note: type: textblock
en: Activate debugging for some internal mechanisms of this module.  Use the source to see which parts can be debugged.
pt_BR: Ativa depuração em alguns mecanismos internos deste módulo. Use a fonte para saber quais partes podem ser depuradas.

note: type: textblock
en: Increase verbosity.
pt_BR: Aumenta o nível de detalhamento.

note: type: textblock
en: This option controls the behavior of the module when it encounter a .de, .ie or .if section. It can take the following values:
pt_BR: Esta opção controla o comportamento do módulo quando ele encontrar uma seção .de, .ie ou .if . Ele pode levar os valores a seguir:

note: type: textblock
en: This is the default value.  The module will fail when a .de, .ie or .if section is encountered.
pt_BR: Esse é o valor de padrão. O módulo vai falhar quando uma seção .de, .ie ou .if for encontrada.

note: type: textblock
en: Indicates that the .de, .ie or .if sections must be copied as is from the original to the translated document.
pt_BR: Indica que as seções .de, .ie ou .if devem ser copiadas como estão do original para o documento traduzido.

note: type: textblock
en: Indicates that the .de, .ie or .if sections will be proposed for the translation.  You should only use this option if a translatable string is contained in one of these section. Otherwise, I<verbatim> should be preferred.
pt_BR: Indica que as seções .de, .ie ou .if vão ser propostas para a tradução. Você deveria apenas usar esta opção se uma string de tradução contiver uma dessas seções. Do contrário, I<verbatim> deve ser preferido.

note: type: textblock
en: This option specifies that the file was generated, and that po4a should not try to detect if the man pages was generated from another format.  This option is mandatory to use po4a on generated man pages.  Note that translating generated pages instead of sources ones is often more fragile, and thus a bad idea.
pt_BR: Esta opção especifica que o arquivo foi gerado e que po4a não deve tentar detectar se as páginas man foi geral de outro formato. Wata opção é obrigatória para usar po4a em páginas man geradas. Note que traduzir páginas geradas em vez das páginas fonte é geralmente um mais suscetível a erro e, portanto, uma má ideia.

note: type: textblock
en: This option is only useful for mdoc pages.
pt_BR: Esta opção é apenas útil para páginas mdoc.

note: type: textblock
en: It selects a stricter support of the mdoc format by telling po4a not to translate the 'NAME' section.  mdoc pages whose 'NAME' section is translated won't generate any header or footer.
pt_BR: Ela seleciona um suporte mais estrito ao formato mdoc ao informar po4a que não deve traduzir a seção "NAME". Páginas mdoc cuja seção "NAME" está traduzida não vão gerar cabeçalho ou nota de rodapé algum.

note: type: verbatim
en: According to the groff_mdoc page, the NAME, SYNOPSIS and DESCRIPTION
    sections are mandatory.
    There are no known issues with translated SYNOPSIS or DESCRIPTION section,
    but you can also specify these sections this way:
     -o mdoc=NAME,SYNOPSIS,DESCRIPTION
pt_BR: De acordo com as páginas do groff_mdoc, as seções NAME, SYNOPSIS e
    DESCRIPTION são obrigatórias.
    Não há problemas conhecidos com seções SYNOPSIS ou DESCRIPTION traduzidas,
    mas você também pode especificar essas seções desta forma:
     -o mdoc=NAME,SYNOPSIS,DESCRIPTION

note: type: verbatim
en: This mdoc issue can also be solved with an addendum like this one:
     PO4A-HEADER:mode=before;position=^.Dd
     .TH DOCUMENT_TITLE 1 "Month day, year" OS "Section Name"
pt_BR: Esse problema pode ser resolvido com um adendo como este aqui:
     PO4A-HEADER:mode=before;position=^.Dd
     .TH DOCUMENT_TITLE 1 "dia mês, ano" OS "Nome da seção"

note: type: textblock
en: Note: if a macro is not supported by po4a and if you consider that it is a standard roff macro, you should submit it to the po4a development team.
pt_BR: Nota: se uma macro não tem suporte no po4a e se você considera que é uma macro roff padrão, você deveria enviá-la para a equipe de desenvolvimento do po4a.

note: type: textblock
en: B<untranslated> indicates that this macro (at its arguments) don't have to be translated.
pt_BR: B<untranslated> indica que esta macro (em seus argumentos) não deveria ser traduzida.

note: type: textblock
en: B<noarg> is like B<untranslated>, except that po4a will verify that no argument is added to this macro.
pt_BR: B<noarg> é como B<untranslated>, exceto que po4a vai verificar que nenhum argumento é adicionar a esta macro.

note: type: textblock
en: B<translate_joined> indicates that po4a must propose to translate the arguments of the macro.
pt_BR: B<translate_joined> indica que po4a deve propor a tradução de argumentos da macro.

note: type: textblock
en: With B<translate_each>, the arguments will also be proposed for the translation, except that each one will be translated separately.
pt_BR: Com B<translate_each>, os argumentos também serão propostos para a tradução, exceto que cada um será traduzido separadamente.

note: type: textblock
en: This option takes as argument a list of comma-separated couples I<begin>:I<end>, where I<begin> and I<end> are commands that delimit the begin and end of a section that should not be rewrapped.
pt_BR: Esta opção leva como argumento uma lista de pares de I<begin>:I<end> separados por vírgula, onde I<begin> e I<end> são comandos que delimitam o início e fim de uma seção que não deveria ser redimensionada.

note: type: textblock
en: Note: no test is done to ensure that an I<end> command matches its I<begin> command; any ending command stop the no_wrap mode.  If you have a I<begin> (respectively I<end>) macro that has no I<end> (respectively I<begin>), you can specify an existing I<end> (like fi) or I<begin> (like nf) as a counterpart.  These macros (and their arguments) won't be translated.
pt_BR: Nota: nenhum teste é feito para assegurar que um comando I<end> corresponde ao seu comando I<begin>; qualquer comando de finalização termina o modo no_wrap. Se você tem uma macro I<begin> (respectivamente I<end>) que não possui I<end> (respectivamente I<begin>), você pode especificar uma I<end> existente (como fi) ou I<begin> (como nf) como uma contraparte. Essas macros (e seus argumentos) não serão traduzidos.

note: type: textblock
en: This option specifies a list of comma-separated macros that must not split the current paragraph. The string to translate will then contain I<foo E<lt>.bar baz quxE<gt> quux>, where I<bar> is the command that should be inlined, and I<baz qux> its arguments.
pt_BR: Esta opção especifica uma lista de macros separadas por vírgula que não podem dividir o parágrafo atual. A string a ser traduzida vai, então, conter I<foo E<lt>.bar baz quxE<gt> quux>, sendo I<bar> o comando que deveria ser embutido, e I<baz qux> seus argumentos.

note: type: textblock
en: This option indicates how po4a should behave when an unknown macro is found.  By default, po4a fails with a warning.  It can take the following values: B<failed> (the default value), B<untranslated>, B<noarg>, B<translate_joined>, or B<translate_each> (see above for an explanation of these values).
pt_BR: Esta opção indica como po4a deveria se comportar quando uma macro desconhecida é encontrada. Por padrão, po4a falha com um aviso. Ele pode levar os valores a seguir: B<failed> (o valor padrão), B<untranslated>, B<noarg>, B<translate_joined> ou B<translate_each> (veja acima uma explicação para cada um desses valores).

note: type: =head1
en: AUTHORING MAN PAGES COMPLIANT WITH PO4A::MAN
pt_BR: CRIAÇÃO DE PÁGINAS MAN COMPATÍVEIS COM PO4A::MAN

note: type: textblock
en: This module is still very limited, and will always be, because it's not a real nroff interpreter. It would be possible to do a real nroff interpreter, to allow authors to use all the existing macros, or even to define new ones in their pages, but we didn't want to. It would be too difficult, and we thought it wasn't necessary. We do think that if manpages' authors want to see their productions translated, they may have to adapt to ease the work of translators.
pt_BR: Este módulo ainda é bem limitado, e sempre será, pois ele não é um interpretador nroff de verdade. Seria possível criar um interpretador nroff para permitir que autores usem todas as macros existentes ou até mesmo definir novas em suas páginas, mas nós não queríamos. Seria muito difícil e nós entendemos não haver necessidade. Nós pensamos que se os autores de páginas man desejam ver seus produtos traduzidos, eles podem ter que adaptar para facilitar o trabalho dos tradutores.

note: type: textblock
en: So, the man parser implemented in po4a have some known limitations we are not really inclined to correct, and which will constitute some pitfalls you'll have to avoid if you want to see translators taking care of your documentation.
pt_BR: Então, o analisador de manuais implementado no po4a possui algumas limitações conhecidas que nós não exatamente estamos podendo corrigir e que podem ser buracos a serem evitados se você não quiser ver tradutores tomando conta da sua documentação.

note: type: =head2
en: Don't program in nroff
pt_BR: Não programe em nroff

note: type: textblock
en: nroff is a complete programming language, with macro definition, conditionals and so on. Since this parser isn't a fully featured nroff interpreter, it will fail on pages using these facilities (There are about 200 such pages on my box).
pt_BR: nroff é uma linguagem de programação completa, com definição de macros, condicionais e por aí vai. Já que este analisador não é um interpretador nroff com todas suas funcionalidades, ela vai falhar em páginas usando essas capacidades (Há cerca de 200 de tais páginas no meu computador).

note: type: =head2
en: Use the plain macro set
pt_BR: Uso o conjunto de macros simples

note: type: textblock
en: There are still some macros which are not supported by po4a::man. This is only because I failed to find any documentation about them. Here is the list of unsupported macros used on my box. Note that this list isn't exhaustive since the program fails on the first encountered unsupported macro. If you have any information about some of these macros, I'll happily add support for them. Because of these macros, about 250 pages on my box are inaccessible to po4a::man.
pt_BR: Há ainda algumas macros que não encontram suporte no po4a::man. Isso porque eu não consegui encontrar qualquer documentação sobre elas. Aqui está a lista de macros sem suporte, usadas na minha máquina. Note que essa lista não é exaustiva, já que o programa falha na primeira macro sem suporte encontrada. Se você não possui qualquer informação sobre algumas dessas macros, ficarei feliz em adicionar suporte a elas. Por causa dessas macros, cerca de 250 páginas estão inacessíveis para po4a::man.

note: type: =head2
en: Hiding text from po4a
pt_BR: Ocultando texto dopo4a

note: type: textblock
en: Sometimes, the author knows that some parts are not translatable, and should not be extracted by po4a. For example, an option may accept an I<other> argument, and I<other> may also appear as the last item of a list. In the first case, I<other> should be not be translatable. And in the second case, I<other> should be translated.
pt_BR: Algumas vezes, o autor sabe que algumas partes não são traduzíveis e, portanto, não deveriam ser extraídas pelo po4a. Por exemplo, uma opção pode aceitar um argumento I<other> e I<other> também pode aparecer como o último item de uma lista. No primeiro caso, I<other> não deveria ser traduzível. e no segundo caso, I<other> deveria ser traduzido.

note: type: textblock
en: In such case, the author can avoid po4a to extract some strings, using some special groff constructs:
pt_BR: Neste aso, o autor pode evitar que po4a extraia algumas strings usando alguns constructs especiais do groff:

note: type: textblock
en: (this will require the B<-o groff_code=verbatim> option)
pt_BR: (isto vai exibir a opção B<-o groff_code=verbatim>)

note: type: verbatim
en: A new macro can also be defined to automate this:
     .de IR_untranslated
     .    IR \\$@
     ..
pt_BR: Uma nova macro também pode ser definida para automatizar isso:
     .de IR_untranslated
     .    IR \\$@
     ..

note: type: textblock
en: (this will require the options B<-o groff_code=verbatim> and B<-o untranslated=IR_untranslated>; with this construct, the B<.if !'po4a'hide'> conditional is not strictly needed since po4a will not parse the internal of the macro definition)
pt_BR: (Isto vai exigir as opções B<-o groff_code=verbatim> e B<-o untranslated=IR_untranslated>; com este construct, a condicional B<.if !'po4a'hide'> não é estritamente necessária já que po4a não vai analisar o interno da definição de macro)

note: type: verbatim
en: or using an alias:
     .als IR_untranslated IR
pt_BR: ou usando o alias:
     .als IR_untranslated IR

note: type: textblock
en: This will require the B<-o untranslated=als,IR_untranslated> option.
pt_BR: Isto vai exigir a opção B<-o untranslated=als,IR_untranslated>.

note: type: =head2
en: Conclusion
pt_BR: Conclusão

note: type: textblock
en: To summarise this section, keep simple, and don't try to be clever while authoring your man pages. A lot of things are possible in nroff, and not supported by this parser. For example, don't try to mess with \c to interrupt the text processing (like 40 pages on my box do). Or, be sure to put the macro arguments on the same line that the macro itself. I know that it's valid in nroff, but would complicate too much the parser to be handled.
pt_BR: Para resumir esta seção, mantenha simples e não tente ser esperto ao criar suas páginas man. Muitas coisas são possível no nroff, mas que não têm suporte neste analisador. Por exemplo, não tente bagunçar o \c interrompendo o processamento de texto (como 40 páginas na minha máquina fazem). Ou, certifique-se de que colocar os argumentos de macros na mesma linha da própria macro. Eu se que é válido no nroff, mas complicado demais para o analisador lidar.

note: type: textblock
en: Of course, another possibility is to use another format, more translator friendly (like POD using po4a::pod, or one of the XML family like SGML), but thanks to po4a::man it isn't needed anymore. That being said, if the source format of your documentation is POD, or XML, it may be clever to translate the source format and not this generated one. In most cases, po4a::man will detect generated pages and issue a warning. It will even refuse to process POD generated pages, because those pages are perfectly handled by po4a::pod, and because their nroff counterpart defines a lot of new macros I didn't want to write support for. On my box, 1432 of the 4323 pages are generated from POD and will be ignored by po4a::man.
pt_BR: É claro, outra possibilidade é usar outro formato, mais amigável ao tradutor (como POD usando po4a::pod ou um da família XML como o SGML), mas graças ao po4a::man isso não é mais necessário. Tendo dito isso, se o formato fonte da documentação é POD, ou XML, pode ser inteligente traduzir o formato fonte e não este gerado. Na maioria dos casos, po4a::man vai detectar páginas geradas e mostrar um aviso. El vai até mesmo recusar processar páginas geradas no POD porque tais páginas são lidadas perfeitamente pelo po4a::pod, e porque sua contraparte nroff define um monte de novas macros que eu não desejo dar suporte. Na minha máquina, 1432 das 4323 página são geradas de POD e vão ser ignoradas pelo po4a::man.

note: type: textblock
en: In most cases, po4a::man will detect the problem and refuse to process the page, issuing an adapted message. In some rare cases, the program will complete without warning, but the output will be wrong. Such cases are called "bugs" ;) If you encounter such case, be sure to report this, along with a fix when possible…
pt_BR: Na maioria dos casos, po4a::man vai detectar o problema e se recusar a processar a página, apresentando uma mensagem adaptada. Em alguns casos raros, o programa vai completar sem avisos, mas a saída estará errada. Tais casos são chamados de "bugs" ;) Se você encontrar tal caso, certifique-se de relatá-lo, junto com uma solução, quando possível…

note: type: textblock
en: This module can be used for most of the existing man pages.
pt_BR: Este módulo pode ser usado para a maioria das páginas man existentes.

note: type: textblock
en: Some tests are regularly run on Linux boxes:
pt_BR: Alguns testes são executados frequentemente em máquinas Linux:

note: type: textblock
en: one third of the pages are refused because they were generated from another format supported by po4a (e.g. POD or SGML).
pt_BR: um terço das páginas são recusadas porque foram geradas a partir de outro formato com suporte no po4a (ex: POD ou SGML).

note: type: textblock
en: 10% of the remaining pages are rejected with an error (e.g. a groff macro is not supported).
pt_BR: 10% das páginas remanescentes são rejeitadas com um erro (ex: uma macro groff não tem suporte).

note: type: textblock
en: Then, less than 1% of the pages are accepted silently by po4a, but with significant issues (i.e. missing words, or new words inserted)
pt_BR: Então, menos de 1% das páginas são aceitas silenciosamente pelo po4a, mas com problemas significantes (isto é, palavras faltando ou novas palavras inseridas)

note: type: textblock
en: The other pages are usually handled without differences more important than spacing differences or line rewrapped (font issues in less than 10% of the processed pages).
pt_BR: As outras páginas são normalmente lidadas sem diferenças mais importantes do que diferenças de espaçamento ou linha redimensionada (problemas de fontes em menos de 10% das páginas processadas).

note: type: textblock
en: Locale::Po4a::Po - PO file manipulation module
pt_BR: Locale::Po4a::Po - módulo para manipulação de arquivos PO

note: type: verbatim
en:     # Read PO file
        $pofile->read('file.po');
pt_BR:     # Lê um arquivo PO
        $pofile->read('arquivo.po');

note: type: verbatim
en:     # Add an entry
        $pofile->push('msgid' => 'Hello', 'msgstr' => 'bonjour',
                      'flags' => "wrap", 'reference'=>'file.c:46');
pt_BR:     # Adiciona uma entrada
        $pofile->push('msgid' => 'Hello', 'msgstr' => 'bom dia',
                      'flags' => "wrap", 'reference'=>'file.c:46');

note: type: verbatim
en:     # Extract a translation
        $pofile->gettext("Hello"); # returns 'bonjour'
pt_BR:     # Extrai uma tradução
        $pofile->gettext("Hello"); # retorna "bom dia"

note: type: verbatim
en:     # Write back to a file
        $pofile->write('otherfile.po');
pt_BR:     # Escreve de volta em um arquivo
        $pofile->write('outroarquivo.po');

note: type: textblock
en: Locale::Po4a::Po is a module that allows you to manipulate message catalogs. You can load and write from/to a file (which extension is often I<po>), you can build new entries on the fly or request for the translation of a string.
pt_BR: Locale::Po4a::Po é um módulo que permite que você manipule catálogo de mensagens. Você pode carregar e escrever de/para um arquivo (cujas extensões geralmente são I<po>), você pode compilar novas entradas em tempo real ou requisitar a tradução de uma string.

note: type: textblock
en: For a more complete description of message catalogs in the PO format and their use, please refer to the info documentation of the gettext program (node "`PO Files"').
pt_BR: Para uma descrição mais completa do catálogo de mensagens no formato PO e seu uso, por favor veja a documentação info do programa gettext. (nó "`Arquivos PO"').

note: type: textblock
en: This module is part of the po4a project, which objective is to use PO files (designed at origin to ease the translation of program messages) to translate everything, including documentation (man page, info manual), package description, debconf templates, and everything which may benefit from this.
pt_BR: Este módulo é parte do projeto po4a, cujo objetivo é usar arquivos PO (projetado em sua origem para facilitar a tradução de mensagens de programas) para traduzir tudo, incluindo documentação (páginas man, manual info), descrição de pacotes, modelos de debconf e tudo que pode se beneficiar dele.

note: type: =head1
en: Functions concerning entire message catalogs
pt_BR: Funções relativas a catálogos de mensagens inteiros

note: type: textblock
en: Creates a new message catalog. If an argument is provided, it's the name of a PO file we should load.
pt_BR: Cria uma nova mensagem de catálogo. Se for fornecido um argumento, é o nome de um arquivo PO que nós devemos carregar.

note: type: textblock
en: Reads a PO file (which name is given as argument).  Previously existing entries in self are not removed, the new ones are added to the end of the catalog.
pt_BR: Lê um arquivo PO (cujo nome é fornecido como argumento). Entradas previamente existentes nele não são removidas, sendo as novas adicionadas ao final do catálogo.

note: type: textblock
en: Writes the current catalog to the given file.
pt_BR: Escreve o catálogo atual no arquivo fornecido.

note: type: textblock
en: Like write, but if the PO or POT file already exists, the object will be written in a temporary file which will be compared with the existing file to check if the update is needed (this avoids to change a POT just to update a line reference or the POT-Creation-Date field).
pt_BR: Similar ao "write", mas se o arquivo PO ou POT já existir, o objeto será escrito em um arquivo temporário, o qual será comparado com o arquivo existente para verificar se a atualização é necessária (isso evita alterar um POT apenas para atualizar uma linha de referência ou o campo POT-Creation-Date).

note: type: textblock
en: This function extracts a catalog from an existing one. Only the entries having a reference in the given file will be placed in the resulting catalog.
pt_BR: Esta função extrai um catálogo de um outro existente. Apenas as entradas contendo uma referência no arquivo fornecido serão inseridas no catálogo resultante.

note: type: textblock
en: This function parses its argument, converts it to a Perl function definition, evals this definition and filters the fields for which this function returns true.
pt_BR: Esta função analisa seu argumento, convertendo-o para uma definição de função de Perl, avalia esta definição e filtra os campos para os quais esta função retorna verdadeiro.

note: type: textblock
en: I love Perl sometimes ;)
pt_BR: Tem vezes que eu adoro Perl ;)

note: type: textblock
en: Recodes to UTF-8 the PO's msgstrs. Does nothing if the charset is not specified in the PO file ("CHARSET" value), or if it's already UTF-8 or ASCII.
pt_BR: Re-codifica para UTF-8 as "msgstr"s do PO. Faz nada se a codificação de caracteres não tiver sido especificada no arquivo PO (valor "CHARSET") ou se ele já for UTF-8 ou ASCII.

note: type: =head1
en: Functions to use a message catalog for translations
pt_BR: Funções para usar um catálogo de mensagens para traduções

note: type: textblock
en: Request the translation of the string given as argument in the current catalog.  The function returns the original (untranslated) string if the string was not found.
pt_BR: Requisita a tradução de uma string fornecida como argumento no catálogo atual. A função retorna a string original (não traduzida) se a string não tiver sido encontrada.

note: type: textblock
en: After the string to translate, you can pass a hash of extra arguments. Here are the valid entries:
pt_BR: Após a string para ser traduzida, você pode passar um hash de argumentos extras. Aqui estão as entradas válidas:

note: type: textblock
en: boolean indicating whether we can consider that whitespaces in string are not important. If yes, the function canonizes the string before looking for a translation, and wraps the result.
pt_BR: booleano indicando se nós podemos considerar que espaços em branco na string não são importantes. Se sim, a função canoniza a string antes de procurar por uma tradução e dimensiona o resultado.

note: type: textblock
en: the column at which we should wrap (default: 76).
pt_BR: a coluna na qual nós deveríamos dimensionar (padrão: 76).

note: type: textblock
en: Returns statistics about the hit ratio of gettext since the last time that stats_clear() was called. Please note that it's not the same statistics than the one printed by msgfmt --statistic. Here, it's statistics about recent usage of the PO file, while msgfmt reports the status of the file.  Example of use:
pt_BR: Retorna estatísticas sobre a proporção de acerto do gettext desde a última vez que stats_clear() foi chamada. Por favor, note que essa não é a mesma estatística impressa por msgfmt --statistic. Aqui, essa estatística sobre uso recente do arquivo PO, enquanto msgfmt relata o estado do arquivo. Exemplo de uso:

note: type: verbatim
en:     [some use of the PO file to translate stuff]
pt_BR:     [um uso do arquivo PO para traduzir coisas]

note: type: verbatim
en:     ($percent,$hit,$queries) = $pofile->stats_get();
        print "So far, we found translations for $percent\%  ($hit of $queries) of strings.\n";
pt_BR:     ($percent,$hit,$queries) = $pofile->stats_get();
        print "Até agora, nós encontramos traduções para $percent\%  ($hit de $queries) da strings.\n";

note: type: textblock
en: Clears the statistics about gettext hits.
pt_BR: Limpa as estatísticas sobre os acertos do gettext.

note: type: =head1
en: Functions to build a message catalog
pt_BR: Funções para compilar um catálogo de mensagem

note: type: textblock
en: Push a new entry at the end of the current catalog. The arguments should form a hash table. The valid keys are:
pt_BR: Insere uma nova entrada no final do catálogo atual. Os argumentos deveriam formar uma tabela de hash. As chaves válidas são:

note: type: textblock
en: the string in original language.
pt_BR: a string no idioma original.

note: type: textblock
en: the translation.
pt_BR: a tradução.

note: type: textblock
en: an indication of where this string was found. Example: file.c:46 (meaning in 'file.c' at line 46). It can be a space-separated list in case of multiple occurrences.
pt_BR: uma indicação de onde esta string foi encontrada. Exemplo: file.c:46 (significa em "file.c" na linha 46). Ela pode ser uma lista separada por espaço no caso de múltiplas ocorrências.

note: type: textblock
en: a comment added here manually (by the translators). The format here is free.
pt_BR: um comentário adicionado aqui manualmente (pelos tradutores). Este formato é livre.

note: type: textblock
en: a comment which was automatically added by the string extraction program. See the B<--add-comments> option of the B<xgettext> program for more information.
pt_BR: um comentário que foi adicionado automaticamente pelo programa de extração de strings. Veja a opção B<--add-comments> no programa B<xgettext> para mais informações.

note: type: textblock
en: space-separated list of all defined flags for this entry.
pt_BR: lista separada por espaço de todas as opções definidas para esta entrada.

note: type: textblock
en: Valid flags are: B<c-text>, B<python-text>, B<lisp-text>, B<elisp-text>, B<librep-text>, B<smalltalk-text>, B<java-text>, B<awk-text>, B<object-pascal-text>, B<ycp-text>, B<tcl-text>, B<wrap>, B<no-wrap> and B<fuzzy>.
pt_BR: Opções válidas são: B<c-text>, B<python-text>, B<lisp-text>, B<elisp-text>, B<librep-text>, B<smalltalk-text>, B<java-text>, B<awk-text>, B<object-pascal-text>, B<ycp-text>, B<tcl-text>, B<wrap>, B<no-wrap> e B<fuzzy>.

note: type: textblock
en: See the gettext documentation for their meaning.
pt_BR: Veja a documentação do gettext para ver seu significado.

note: type: textblock
en: this is mostly an internal argument: it is used while gettextizing documents. The idea here is to parse both the original and the translation into a PO object, and merge them, using one's msgid as msgid and the other's msgid as msgstr. To make sure that things get ok, each msgid in PO objects are given a type, based on their structure (like "chapt", "sect1", "p" and so on in DocBook). If the types of strings are not the same, that means that both files do not share the same structure, and the process reports an error.
pt_BR: esse é basicamente um argumento interno: ele é usado ao gettextizar documentos. A ideia aqui é analisar tanto o original quanto a tradução em um objeto PO e mesclá-los, usando a msgid do primeiro e o msgid do segundo como msgstr. Para certificar-se de que as coisas funcionem, a cada msgid nos objetos PO é fornecido um tipo, baseado em sua estrutura (como "chapt", "sect1", "p" e outros, em DocBook). Se os tipos de strings não forem os mesmos, significa que ambos arquivos não compartilham a mesma estrutura e o processa relata um erro.

note: type: textblock
en: This information is written as automatic comment in the PO file since this gives to translators some context about the strings to translate.
pt_BR: Esta informação é escrita como um comentário automático no arquivo PO já que isso fornece aos tradutores algum contexto sobre as strings para traduzir.

note: type: textblock
en: boolean indicating whether whitespaces can be mangled in cosmetic reformattings. If true, the string is canonized before use.
pt_BR: booleano indicando se espaços em branco podem ser separados em reformatação cosmética. Se verdadeiro, a string é canonizada antes de ser usada.

note: type: textblock
en: This information is written to the PO file using the B<wrap> or B<no-wrap> flag.
pt_BR: Esta informação é escrita no arquivo PO usando as opções B<wrap> ou B<no-wrap>.

note: type: textblock
en: This information is not written to the PO file.
pt_BR: Esta informação não é escrita no arquivo PO.

note: type: =head1
en: Miscellaneous functions
pt_BR: Funções diversas

note: type: textblock
en: Returns the number of entries in the catalog (without the header).
pt_BR: retorna o número de entradas no catálogo (sem o cabeçalho).

note: type: textblock
en: Returns the number of entries in document. If a string appears multiple times in the document, it will be counted multiple times.
pt_BR: Retorna o número de entradas no documento. Se uma string aparece múltiplas vezes no documento, ele vai ser contado múltiplas vezes.

note: type: textblock
en: Returns the msgid of the given number.
pt_BR: retorna o msgid do número fornecido.

note: type: textblock
en: Returns the msgid with the given position in the document.
pt_BR: retorna o msgid com a posição fornecida no documento.

note: type: textblock
en: Returns the character set specified in the PO header. If it hasn't been set, it will return "UTF-8".
pt_BR: retorna a codificação de caracteres do cabeçalho do PO. Se ele não tiver sido definido, ele vai retornar "UTF-8".

note: type: textblock
en: This sets the character set of the PO header to the value specified in its first argument. If you never call this function (and no file with a specified character set is read), the default value is left to "UTF-8". This value doesn't change the behavior of this module, it's just used to fill that field in the header, and to return it in get_charset().
pt_BR: Isso define a codificação de caracteres do cabeçalho PO para o valor especificado no seu primeiro argumento. Se você nunca chamou esta função (e nenhum arquivo com uma codificação de caracteres especificada for lida), o valor padrão é deixado com "UTF-8". Este valor não altera o comportamento deste módulo, ele apenas é usado para preencher aquele campo no cabeçalho e retorná-lo em get_charset().

note: type: textblock
en: Locale::Po4a::Pod - convert POD data from/to PO files
pt_BR: Locale::Po4a::Pod - converte dados POD de/para arquivos PO

note: type: verbatim
en:     # Read POD from STDIN and write to STDOUT.
        $parser->parse_from_filehandle;
pt_BR:     # Lê um POD da STDIN e escreve para a STDOUT.
        $parser->parse_from_filehandle;

note: type: verbatim
en:     # Read POD from file.pod and write to file.txt.
        $parser->parse_from_file ('file.pod', 'file.txt');
pt_BR:     # Lê um POD do arquivo.pod e escreve para arquivo.txt.
        $parser->parse_from_file ('arquivo.pod', 'arquivo.txt');

note: type: textblock
en: Locale::Po4a::Pod is a module to help the translation of documentation in the POD format (the preferred language for documenting Perl) into other [human] languages.
pt_BR: Locale::Po4a::Pod é um módulo para ajudar a tradução de documentação no formato POD (a linguagem preferido para documentar Perl) para outros idiomas.

note: type: textblock
en: I think that this module is rock stable, and there is only one known bug with F</usr/lib/perl5/Tk/MainWindow.pod> (and some other pages, see below) which contains:
pt_BR: Eu penso que este módulos está bem consolidado, e há apenas um erro conhecido com F</usr/lib/perl5/Tk/MainWindow.pod> (e alguns outras páginas, veja abaixo), o qual contém:

note: type: textblock
en: Lack of luck, in the po4a version, this was split on the space by the wrapping. As result, in the original version, the man page contains
pt_BR: Por falta de sorte, na versão do po4a, isso foi divido no espaço pelo dimensionamento. Como resultado, na versão original, a página man contém

note: type: textblock
en: and mine contains
pt_BR: e o meu contém

note: type: textblock
en: which is logic since CE<lt>foobarE<gt> is rewritten "foobar".
pt_BR: o qual faz sentido, já que CE<lt>foobarE<gt> é reescrito como "foobar".

note: type: textblock
en: Complete list of pages having this problem on my box (from 564 pages; note that it depends on the chosen wrapping column): /usr/lib/perl5/Tk/MainWindow.pod /usr/share/perl/5.8.0/overload.pod /usr/share/perl/5.8.0/pod/perlapi.pod /usr/share/perl/5.8.0/pod/perldelta.pod /usr/share/perl/5.8.0/pod/perlfaq5.pod /usr/share/perl/5.8.0/pod/perlpod.pod /usr/share/perl/5.8.0/pod/perlre.pod /usr/share/perl/5.8.0/pod/perlretut.pod
pt_BR: Uma lista completa de páginas tendo este problema no meu computador (das 564 páginas; note que depende da coluna escolhida para dimensionamento): /usr/lib/perl5/Tk/MainWindow.pod /usr/share/perl/5.8.0/overload.pod /usr/share/perl/5.8.0/pod/perlapi.pod /usr/share/perl/5.8.0/pod/perldelta.pod /usr/share/perl/5.8.0/pod/perlfaq5.pod /usr/share/perl/5.8.0/pod/perlpod.pod /usr/share/perl/5.8.0/pod/perlre.pod /usr/share/perl/5.8.0/pod/perlretut.pod

note: type: =head1
en: INTERNALS
pt_BR: INTERNO

note: type: textblock
en: As a derived class from Pod::Parser, Locale::Po4a::Pod supports the same methods and interfaces.  See L<Pod::Parser> for all the details; briefly, one creates a new parser with C<< Locale::Po4a::Pod->new() >> and then calls either parse_from_filehandle() or parse_from_file().
pt_BR: Como uma classe derivada de Pod::Parser, Locale::Po4a::Pod tem suporte aos mesmos métodos e interfaces. Veja L<Pod::Parser> para todos os detalhes. De forma resumida, cria-se um novo analisador com C<< Locale::Po4a::Pod->new() >> e, então, chama-se parse_from_filehandle() ou parse_from_file().

note: type: textblock
en: new() can take options, in the form of key/value pairs, that control the behavior of the parser.  The recognized options common to all Pod::Parser children are:
pt_BR: new() pode receber opções, na forma de pares chave/valor, que controla o comportamento do analisador. As opções reconhecidas a todos os filhos de Pod::Parser:

note: type: textblock
en: If set to a true value, selects an alternate output format that, among other things, uses a different heading style and marks B<=item> entries with a colon in the left margin.  Defaults to false.
pt_BR: Se definido com um valor verdadeiro, seleciona um formato de saída alternativo que, dentre outras coisas, usa um estilo de cabeçalho diferente e marca entradas B<=item> com um caractere de dois-pontos (:) na margem esquerda. O padrão é falso.

note: type: textblock
en: If set to a true value, the non-POD parts of the input file will be included in the output.  Useful for viewing code documented with POD blocks with the POD rendered and the code left intact.
pt_BR: Se definido com um valor verdadeiro, as partes não-POD do arquivo de saída serão incluídas na saída. Útil para visualizar o código documentado com blocos POD com o POD renderizado e o código intacto.

note: type: textblock
en: The number of spaces to indent regular text, and the default indentation for B<=over> blocks.  Defaults to 4.
pt_BR: O número de espaços para recuar ("indentar") o texto comum e o recuo padrão para os blocos B<=over>. O padrão é 4.

note: type: textblock
en: If set to a true value, a blank line is printed after a B<=head1> heading.  If set to false (the default), no blank line is printed after B<=head1>, although one is still printed after B<=head2>.  This is the default because it's the expected formatting for manual pages; if you're formatting arbitrary text documents, setting this to true may result in more pleasing output.
pt_BR: Se definido com um valor verdadeiro, uma linha em branco é mostrada após um cabeçalho B<=head1>. Se definido com falso (o padrão), nenhuma linha em branco é exibida após B<=head1>, porém uma ainda é mostrada após B<=head2>. Esse é o padrão porque é a formatação esperada para as páginas de manual; Se você estiver formatando documentos de texto arbitrário, definir isso para verdadeiro pode resultar em um resultado mais agradável.

note: type: textblock
en: Sets the quote marks used to surround CE<lt>> text.  If the value is a single character, it is used as both the left and right quote; if it is two characters, the first character is used as the left quote and the second as the right quote; and if it is four characters, the first two are used as the left quote and the second two as the right quote.
pt_BR: Define os sinais de aspas para envolver textos CE<lt>>. Se o valor for um único caractere, ele for usado em ambas aspas da esquerda e da direita; se ele for dois caracteres, o primeiro caractere é usado como aspas da esquerda e o segundo como a aspas da direita; e se ele for quarto caracteres, os primeiros dois são usados como as aspas da esquerda e os dois últimos são usados como as aspas da direita.

note: type: textblock
en: This may also be set to the special value B<none>, in which case no quote marks are added around CE<lt>> text.
pt_BR: Esse valor também pode ser definido com o valor especial B<none>, caso em que aspas não são adicionadas em volta de textos CE<lt>>.

note: type: textblock
en: If set to a true value, Locale::Po4a::Pod will assume that each sentence ends in two spaces, and will try to preserve that spacing.  If set to false, all consecutive whitespace in non-verbatim paragraphs is compressed into a single space.  Defaults to true.
pt_BR: Se definido com um valor verdadeiro, Locale::Po4a::Pod vai presumir que cada sentença termina com dois espaços e vai tentar preservar aquele espaçamento. Se definido com falso, todos os espaços em branco consecutivos em parágrafos não-verbatim são comprimidos em um único espaço. O padrão é verdadeiro.

note: type: textblock
en: The column at which to wrap text on the right-hand side.  Defaults to 76.
pt_BR: A coluna na qual se deve realizar dimensionamento no lado direito. O padrão é 76.

note: type: textblock
en: Locale::Po4a::RubyDoc -- Convert Ruby Document data from/to PO files
pt_BR: Locale::Po4a::RubyDoc - Xonverte dados de Ruby Document de/para arquivos PO

note: type: textblock
en: Locale::Po4a::RubyDoc is a module to help the translation of documentation in the Ruby Document (RD) format (a language used to document Ruby) into other [human] languages.
pt_BR: Locale::Po4a::RubyDoc é um módulo para ajudar a tradução de documentação no formato Ruby Document (Rad) (a linguagem usada para documentar Ruby) para outros idiomas.

note: type: textblock
en: This module has been successfully tested on simple Ruby Document files covering a good part of the format syntax.
pt_BR: Este módulo foi testado com sucesso em arquivos de Ruby Document simples cobrindo uma boa parte da sintaxe do formato.

note: type: textblock
en: A known limitation is that it fails to properly recognize the stacked structure of input Ruby Document: this implies that when, for instance, an EnumListItem consists of more than one Block, only the first Block is actually recognized as EnumListItem, while the subsequent ones are considered just as TextBlocks...
pt_BR: Uma limitação conhecida é que ele falha em reconhecer adequadamente a estrutura empilhada do Documento Ruby de entrada: isso implica que quando, por exemplo, um EnumListItem consiste em mais de um Bloco, apenas o primeiro Bloco é realmente reconhecido como EnumListItem, enquanto os subsequentes são considerados apenas como TextBlocks...

note: type: textblock
en: This module supports the following option:
pt_BR: Este módulo tem suporte à seguinte opção:

note: type: textblock
en: Handle files entirely made of Ruby Document formatted text (without any "=begin" line).
pt_BR: Manipula arquivos inteiramente feitos de texto formatado de Ruby Document (sem nenhuma linha "=begin").

note: type: textblock
en: By default, this module only handles Ruby Document formatted text between "=begin" and "=end" lines (hence ignoring, among other things, everything that precedes the first "=begin" line).
pt_BR: Por padrão, este módulo manipula apenas texto formatado de Ruby Document entre as linhas "=begin" e "=end" (portanto, ignorando, entre outras coisas, tudo o que precede a primeira linha "=begin").

note: type: textblock
en: This work is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.
pt_BR: Est obra é um software livre; você pode redistribuí-la e/ou modificá-la sob os termos da Licença Pública Geral GNU conforme publicada pela Free Software Foundation; tanto a versão 2 da Licença, ou (por sua opção) qualquer versão posterior.

note: type: textblock
en: This work is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License for more details.
pt_BR: Esta obra é distribuída na esperança de que seja útil, mas SEM NENHUMA GARANTIA; sem mesmo a garantia implícita de COMERCIALIZAÇÃO ou ADEQUAÇÃO A UM DETERMINADO FIM. Veja a Licença Pública Geral GNU para mais detalhes.

note: type: textblock
en: You should have received a copy of the GNU General Public License along with this work; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.
pt_BR: Você deve ter recebido uma cópia da Licença Pública Geral GNU junto com este trabalho; se não, escreva para Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.

note: type: textblock
en: Parts of the code (such as many regular expressions) were adapted from the source of rdtool, under the terms of the GNU General Public License, version 2 or later.  These parts are originally:
pt_BR: Partes do código (como muitas expressões regulares) foram adaptadas do código-fonte do rdtool, sob os termos da Licença Pública Geral GNU, versão 2 ou posterior. Essas partes são originalmente:

note: type: textblock
en: The initialize code was adapted from the source of Locale::Po4a::Text, under the terms of the GNU General Public License, version 2 or later.  This code was originally:
pt_BR: O código de inicialização foi adaptado do código-fonte de Locale::Po4a::Text, nos termos da Licença Pública Geral GNU, versão 2 ou posterior. Este código era originalmente:

note: type: textblock
en: Locale::Po4a::Sgml - convert SGML documents from/to PO files
pt_BR: Locale::Po4a::Sgml - converte documentações SGML de/para arquivos PO

note: type: textblock
en: Locale::Po4a::Sgml is a module to help the translation of documentation in the SGML format into other [human] languages.
pt_BR: Locale::Po4a::Sgml é um módulo para ajudar a tradução de documentação no formato SGML para outros idiomas.

note: type: textblock
en: This module uses B<onsgmls>(1) to parse the SGML files. Make sure it is installed.  Also make sure that the DTD of the SGML files are installed in the system.
pt_BR: Esse módulo usa B<onsgmls>(1) para analisar os arquivos SGML. Certifique-se de que ele está instalado. Certifique-se, também, de que o DTD dos arquivos SGML estão instalados no sistema.

note: type: textblock
en: Space separated list of keywords indicating which part you want to debug. Possible values are: tag, generic, entities and refs.
pt_BR: Lista separada por espaço das palavras-chave indicando qual parte você gostaria de depurar. Valores possível são: tag, generic, entities e refs.

note: type: textblock
en: Give more information about what's going on.
pt_BR: Fornece mais informações sobre o que está acontecendo.

note: type: textblock
en: Space separated list of extra tags (beside the DTD provided ones) whose content should form an extra msgid.
pt_BR: Lista separada por espaço das marcações extras (além daquelas fornecidas por DTD) cujo conteúdo deveria formar um msgid extra.

note: type: textblock
en: Space separated list of extra tags (beside the DTD provided ones)  containing other tags, some of them being of category B<translate>.
pt_BR: Lista separada por espaço das marcações extras (além daquelas fornecidas por DTD) contendo outras marcações, algumas delas sendo da categoria B<translate>.

note: type: textblock
en: Space separated list of tags which increase the indentation level.
pt_BR: Lista separada por espaço das marcações que incrementam o nível de recuo.

note: type: textblock
en: The layout within those tags should not be changed. The paragraph won't get wrapped, and no extra indentation space or new line will be added for cosmetic purpose.
pt_BR: O layout dentro daquelas marcações que não deveriam ser alteradas. O parágrafo não será dimensionado e nenhuma nova linha ou espaço de recuo extra serão adicionados por motivos cosméticos.

note: type: textblock
en: Tags not needing to be closed.
pt_BR: Marcações que não precisam ser fechadas.

note: type: textblock
en: Tags ignored and considered as plain char data by po4a. That is to say that they can be part of an msgid. For example, E<lt>bE<gt> is a good candidate for this category since putting it in the translate section would create msgids not being whole sentences, which is bad.
pt_BR: Marcações ignoradas e consideradas como dados de caracteres planos pelo po4a. Isso é o mesmo que dizer que elas podem ser parte de um msgid. Por exemplo, E<lt>bE<gt> é um ótimo candidato para esta categoria, considerando que colocar ela em uma seção de tradução resultaria na criação de msgids não sendo sentenças completas, o que é ruim.

note: type: textblock
en: A space separated list of attributes that need to be translated. You can specify the attributes by their name (for example, "lang"), but you can also prefix it with a tag hierarchy, to specify that this attribute will only be translated when it is into the specified tag. For example: E<lt>bbbE<gt>E<lt>aaaE<gt>lang specifies that the lang attribute will only be translated if it is in an E<lt>aaaE<gt> tag, which is in a E<lt>bbbE<gt> tag.  The tag names are actually regular expressions so you can also write things like E<lt>aaa|bbbbE<gt>lang to only translate lang attributes that are in an E<lt>aaaE<gt> or a E<lt>bbbE<gt> tag.
pt_BR: Uma lista separada por espaço de atributos que precisam ser traduzidos. Você pode especificar os atributos por seus nomes (por exemplo, "lang"), mas você também pode prefixá-la com uma hierarquia de marcações, para especificar que este atributo vai só será traduzido quando estiver na marcação especificada. Por exemplo: E<lt>bbbE<gt>E<lt>aaaE<gt>lang especifica que o atributo lang só será traduzido se ele estiver em uma marcação E<lt>aaaE<gt>, que está em uma marcação E<lt>bbbE<gt>. Os nomes de marcação são, na verdade, expressões regulares, de forma que você também possa escrever coisas como E<lt>aaa|bbbbE<gt>lang para traduzir apenas atributos lang que estão em um E<lt>aaaE<gt> ou uma marcação E<lt>bbbE<gt>.

note: type: textblock
en: A space separated list of attributes for which the translation must be qualified by the attribute name. Note that this setting automatically adds the given attribute into the 'attributes' list too.
pt_BR: Uma lista separada por espaço de atributos para os quais a tradução deve ser qualificada pelo nome. Note que essa configuração adiciona automaticamente o atributo fornecido à lista de "atributes" também.

note: type: textblock
en: Proceed even if the DTD is unknown or if onsgmls finds errors in the input file.
pt_BR: Continua ainda na eventualidade do DTD ser desconhecido ou se onsgmls encontrar erros no arquivo de entrada.

note: type: textblock
en: By default, msgids containing only one entity (like '&version;') are skipped for the translator comfort. Activating this option prevents this optimisation. It can be useful if the document contains a construction like "<title>&Aacute;</title>", even if I doubt such things to ever happen...
pt_BR: Por padrão, msgids que contenham apenas uma entidade (como "&version;") são ignorados para o conforto do tradutor. Ao ativar essa opção, está se prevenindo esta otimização. Ela pode ser útil se a documentação contém uma construção como "<title>&Aacute;</title>", mesmo eu duvidando que esse tipo de coisa venha a acontecer...

note: type: textblock
en: Space separated list of entities that won't be inlined.  Use this option with caution: it may cause onsgmls (used internally) to add tags and render the output document invalid.
pt_BR: Lista separada por espaço de entidades que não serão acrescentadas embutidas. Use esta opção com cuidado: ela pode levar o onsgmls (usado internamente) a adicionar marcações e tornar inválido o documento resultante.

note: type: textblock
en: The result is perfect. I.e., the generated documents are exactly the same. But there are still some problems:
pt_BR: O resultado é perfeito, ou seja, os documentos gerados são exatamente os mesmos. Mas ainda há alguns problemas:

note: type: textblock
en: The error output of onsgmls is redirected to /dev/null by default, which is clearly bad. I don't know how to avoid that.
pt_BR: A saída de erro do onsgmls é redirecionada para /dev/null por padrão, o que obviamente é ruim. Eu não sei como evitar isso.

note: type: textblock
en: The problem is that I have to "protect" the conditional inclusions (i.e. the C<E<lt>! [ %foo [> and C<]]E<gt>> stuff) from onsgmls. Otherwise onsgmls eats them, and I don't know how to restore them in the final document. To prevent that, I rewrite them to C<{PO4A-beg-foo}> and C<{PO4A-end}>.
pt_BR: O problema é que eu tenho que "proteger" as inclusões condicionais (i.e. as C<E<lt>! [ %foo [> e C<]]E<gt>>) do onsgmls. Do contrário, onsgmls devora-as e eu não sei como restaurá-las no documento final. Para evitar isso, eu as reescrevo para C<{PO4A-beg-foo}> e C<{PO4A-end}>.

note: type: textblock
en: The problem with this is that the C<{PO4A-end}> and such I add are invalid in the document (not in a E<lt>pE<gt> tag or so).
pt_BR: O problema com isso é que o C<{PO4A-end}>, e outros que eu acrescento, são inválidos no documento (não em uma marcação E<lt>pE<gt> ou similar).

note: type: textblock
en: If you want to view the onsgmls output, just add the following to your command line (or po4a configuration line):
pt_BR: Se você quiser ver a saída do onsgmls, adicione o seguinte à sua linha de comandos (ou linha de configuração po4a):

note: type: textblock
en: It does work only with the DebianDoc and DocBook DTD. Adding support for a new DTD should be very easy. The mechanism is the same for every DTD, you just have to give a list of the existing tags and some of their characteristics.
pt_BR: Ele funciona bem apenas com o Docbook DTD e DebianDoc. Adicionar suporte a um novo DTD deve ser muito fácil. O mecanismo é o mesmo para todo DTD, você só deveria passar uma lista de marcações existentes e algumas de suas características.

note: type: textblock
en: I agree, this needs some more documentation, but it is still considered as beta, and I hate to document stuff which may/will change.
pt_BR: Eu concordo, isso precisa de mais documentação, mas ele ainda é considerado como beta e eu odeio documentar coisas que podem/vão alterar.

note: type: textblock
en: Warning, support for DTDs is quite experimental. I did not read any reference manual to find the definition of every tag. I did add tag definition to the module 'till it works for some documents I found on the net. If your document use more tags than mine, it won't work. But as I said above, fixing that should be quite easy.
pt_BR: Aviso, o suporte para DTDs é bem experimental. Eu não li nenhum manual de referência para encontrar a definição para todas marcações. Eu adicionar definição de marcações ao módulo até que funcionou para algumas documentações encontradas na internet. Se seu documento usa mais marcações que o meu, ele não vai funcionar. Mas como eu falei acima, corrigir isso deve ser bem fácil.

note: type: textblock
en: I did test DocBook against the SAG (System Administrator Guide) only, but this document is quite big, and should use most of the DocBook specificities.
pt_BR: Eu testei DocBook apenas com o SAG (System Administrator Guide), mas este documento é bem grande e deveria usar a maioria das especificidades do DocBook.

note: type: textblock
en: For DebianDoc, I tested some of the manuals from the DDP, but not all yet.
pt_BR: Para DebianDoc, Eu testei alguns dos manuais do DDP, mais não todos ainda.

note: type: textblock
en: In case of file inclusion, string reference of messages in PO files (i.e. lines like C<#: en/titletoc.sgml:9460>) will be wrong.
pt_BR: No caso de inclusão de arquivo, a referência de strings nos arquivos PO (i.e. linhas como C<#: en/titletoc.sgml:9460>) estarão erradas.

note: type: textblock
en: This is because I preprocess the file to protect the conditional inclusion (i.e. the C<E<lt>! [ %foo [> and C<]]E<gt>> stuff) and some entities (like &version;) from onsgmls because I want them verbatim to the generated document. For that, I make a temp copy of the input file and do all the changes I want to this before passing it to onsgmls for parsing.
pt_BR: Isso porque eu preprocesso o arquivo para proteger a inclusão condicional (i.e. aqueles C<E<lt>! [ %foo [> e C<]]E<gt>>) e algumas entidades (como &version;) do onsgmls porque eu quero eles verbatim no documento gerado. Para isso, eu faço uma cópia temporária do arquivo de entrada e faço todas as alterações que eu quero nele antes de passá-lo para o onsgmls para análise.

note: type: textblock
en: So that it works, I replace the entities asking for a file inclusion by the content of the given file (so that I can protect what needs to be in a subfile also). But nothing is done so far to correct the references (i.e., filename and line number) afterward. I'm not sure what the best thing to do is.
pt_BR: Para que isso funcione, eu substituo as entidades requisitando uma inclusão de arquivo pelo conteúdo do arquivo dado (de forma que eu possa proteger o precisa ser um subarquivo também). Mas nada é feito até o momento para corrigir as referências (i.e. nome de arquivo e número da linha) posteriormente. Eu não tenho certeza qual é a melhor coisa a se fazer.

note: type: textblock
en: This module is an adapted version of sgmlspl (SGML postprocessor for the ONSGMLS parser) which was:
pt_BR: Esse módulo é uma versão adaptado do sgmlspl (pós-processador SGML para o analisador ONSGMLS) que era:

note: type: textblock
en: The adaptation for po4a was done by:
pt_BR: A adaptação para o po4a foi feita para:

note: type: textblock
en: Locale::Po4a::TeX - convert TeX documents and derivatives from/to PO files
pt_BR: Locale::Po4a::TeX - converte documentos TeX e derivados de/para arquivos PO

note: type: textblock
en: Locale::Po4a::TeX is a module to help the translation of TeX documents into other [human] languages. It can also be used as a base to build modules for TeX-based documents.
pt_BR: Locale::Po4a::TeX é um módulo para ajudar a tradução de documentos TeX para outros idiomas. Ele também pode ser usado como uma base para construir módulos para documentos baseados em TeX.

note: type: textblock
en: Users should probably use the LaTeX module, which inherits from the TeX module and contains the definitions of common LaTeX commands.
pt_BR: Usuários provavelmente deveriam usar o módulo LaTeX, o qual herdou do módulo TeX e contém as definições dos comandos comuns do LaTeX.

note: type: =head1
en: TRANSLATING WITH PO4A::TEX
pt_BR: TRADUZINDO COM PO4A::TEX

note: type: textblock
en: This module can be used directly to handle generic TeX documents.  This will split your document in smaller blocks (paragraphs, verbatim blocks, or even smaller like titles or indexes).
pt_BR: Esse módulo pode ser usado diretamente para lidar com documentos TeX genéricos. Ele vai dividir seu documento em blocos menores (parágrafos, blocos literais ou até mesmo menores, como títulos e índices).

note: type: textblock
en: There are some options (described in the next section) that can customize this behavior.  If this doesn't fit to your document format you're encouraged to write your own derivative module from this, to describe your format's details.  See the section B<WRITING DERIVATIVE MODULES> below, for the process description.
pt_BR: Há algumas opções (descritas na próxima seção) que podem personalizar este comportamento. Se isso não se adequar ao formato do seu documento, encorajamos você a escrever seu próprio módulo derivado deste, para descrever os detalhes do seu formato. Veja a seção abaixo B<ESCREVENDO MÓDULOS DERIVADOS>, para a descrição do processo.

note: type: textblock
en: This module can also be customized by lines starting with "% po4a:" in the TeX file. This process is described in the B<INLINE CUSTOMIZATION> section.
pt_BR: Esse módulo também pode ser personalizado por linhas iniciais com "% po4a:" no arquivo TeX. Esse processo é descrito na seção B<PERSONALIZAÇÃO INTEGRADA>.

note: type: textblock
en: Comma-separated list of environments which should not be re-wrapped.
pt_BR: Lista separada por vírgula dos ambientes que não deveriam ser redimensionado.

note: type: textblock
en: Note that there is a difference between verbatim and no_wrap environments.  There is no command and comments analysis in verbatim blocks.
pt_BR: Note que há uma diferença entre ambientes literais e no_wrap. Não há análise de comentários e comandos nos blocos literais.

note: type: textblock
en: If this environment was not already registered, po4a will consider that this environment does not take any parameters.
pt_BR: Se esse ambiente ainda não foi registrado, po4a vai considerar que ele não leva parâmetros.

note: type: textblock
en: Colon-separated list of files that should not be included by \input and \include.
pt_BR: Lista separada por dois-pontos (:) dos arquivos que não deveria ser incluídos por \input e \include.

note: type: textblock
en: Comma-separated list of environments which should be taken as verbatim.
pt_BR: Lista separada por vírgula dos ambientes que deveriam ser considerados com literais.

note: type: textblock
en: Use these options to override the default behavior of the defined commands.
pt_BR: Use essas opções para sobrescrever o comportamento padrão dos comandos definidos.

note: type: textblock
en: The TeX module can be customized with lines starting by B<% po4a:>.  These lines are interpreted as commands to the parser.  The following commands are recognized:
pt_BR: O módulo TeX pode ser personalizado com linhas começando com B<% po4a:>. Essas linhas são interpretadas como comandos para o analisador. Os seguintes comandos são reconhecidos:

note: type: =item
en: B<% po4a: command> I<command1> B<alias> I<command2>
pt_BR: B<% po4a: command> I<comando1> B<alias> I<comando2>

note: type: textblock
en: Indicates that the arguments of the I<command1> command should be treated as the arguments of the I<command2> command.
pt_BR: Indica que os argumentos do I<comando1> deveriam ser tratados como os argumentos do comando I<comando2>.

note: type: =item
en: B<% po4a: command> I<command1> I<parameters>
pt_BR: B<% po4a: command> I<comando1> I<parâmetros>

note: type: textblock
en: This describes in detail the parameters of the I<command1> command.  This information will be used to check the number of arguments and their types.
pt_BR: Isso descreve em detalhes os parâmetros do comando I<comando1>. Essa informação será usada para verificar o número de argumentos e seus tipos.

note: type: textblock
en: You can precede the I<command1> command by
pt_BR: Você pode preceder o comando I<comando1> por

note: type: =item
en: an asterisk (B<*>)
pt_BR: um asterisco (B<*>)

note: type: textblock
en: po4a will extract this command from paragraphs (if it is located at the beginning or the end of a paragraph).  The translators will then have to translate the parameters that are marked as translatable.
pt_BR: po4a vai extrair esse comando dos parágrafos (se ele estiver alocado no começo ou no fim de um parágrafo). Os tradutores vão, então, ter que traduzir os parâmetros que estão marcados como traduzíveis.

note: type: =item
en: a plus (B<+>)
pt_BR: um mais (B<+>)

note: type: textblock
en: As for an asterisk, the command will be extracted if it appear at an extremity of a block, but the parameters won't be translated separately.  The translator will have to translate the command concatenated to all its parameters.  This keeps more context, and is useful for commands with small words in parameter, which can have multiple meanings (and translations).
pt_BR: Assim como o asterisco, o comando será extraído se ele aparecer em uma extremidade de um bloco, mas os parâmetros não serão traduzidos separadamente. O tradutor terá que traduzir o comando concatenado a todos os seus parâmetros. Isso mantém mais o contexto e é útil para comandos com palavras pequenas em parâmetro, o qual pode ter múltiplos significados (e traduções).

note: type: textblock
en: Note: In this case you don't have to specify which parameters are translatable, but po4a must know the type and number of parameters.
pt_BR: Nota: neste caso, você não terá que especificar quais parâmetros são traduzíveis, mas po4a deve saber o tipo e número de parâmetros.

note: type: =item
en: a minus (B<->)
pt_BR: um menos (B<->)

note: type: textblock
en: In this case, the command won't be extracted from any block.  But if it appears alone on a block, then only the parameters marked as translatable will be presented to the translator.  This is useful for font commands.  These commands should generally not be separated from their paragraph (to keep the context), but there is no reason to annoy the translator with them if a whole string is enclosed in such a command.
pt_BR: Nesse caso, o comando não será extraído de qualquer bloco. Mas se ele aparece sozinho em um bloco, então apenas os parâmetros marcados como traduzíveis serão apresentados para o tradutor. Isso é útil para comandos de fonte. Esses comandos geralmente deveriam não ser separados de seu parágrafo (para manter o contexto), mas não há motivo para incomodar o tradutor com eles, se um conjunto de strings está incluso neste comando.

note: type: verbatim
en: The I<parameters> argument is a set of [] (to indicate an optional
    argument) or {} (to indicate a mandatory argument).
    You can place an underscore (_) between these brackets to indicate that
    the parameter must be translated. For example:
     % po4a: command *chapter [_]{_}
pt_BR: O argumento I<parâmetros> é um conjunto de [] (para indicar um argumento
    opcional) ou {} (para indicar um argumento obrigatório).
    Você pode colocar um sublinhado (_) entre esses colchetes para indicar que
    o parâmetro deve ser traduzido. Por exemplo:
     % po4a: command *chapter [_]{_}

note: type: verbatim
en: This indicates that the chapter command has two parameters: an optional
    (short title) and a mandatory one, which must both be translated.
    If you want to specify that the href command has two mandatory parameters,
    that you don't want to translate the URL (first parameter), and that you
    don't want this command to be separated from its paragraph (which allow
    the translator to move the link in the sentence), you can use:
     % po4a: command -href {}{_}
pt_BR: Isso indica que o comando de capítulo possui dois parâmetros: um opcional
    (título curto) e um obrigatório, os quais devem ser traduzidos.
    Se você deseja especificar que o comando href tenha dois parâmetros
    obrigatórios, que você não deseja traduzir a URL (primeiro parâmetro), e que
    você não deseja que esse comando seja separado de seu parágrafo (o que permite
    que o tradutor mova o link na sentença), você pode usar:
     % po4a: command -href {}{_}

note: type: textblock
en: In this case, the information indicating which arguments must be translated is only used if a paragraph is only composed of this href command.
pt_BR: Neste caso, a informação indicando quais argumentos devem ser traduzidos é apenas usado se um parágrafo é composto apenas deste comando href.

note: type: =item
en: B<% po4a: environment> I<env> I<parameters>
pt_BR: B<% po4a: environment> I<ambiente> I<parâmetros>

note: type: verbatim
en: This defines the parameters accepted by the I<env> environment and specifies the ones to be translated.
    This information is later used to check the number of arguments of the
    \begin command.
    The syntax of the I<parameters> argument is the same as described for the
    others commands.
    The first parameter of the \begin command is the name of the environment.
    This parameter must not be specified in the list of parameters. Here are
    some examples:
     % po4a: environment multicols {}
     % po4a: environment equation
pt_BR: Isso define os parâmetros aceitos pelo ambiente I<ambiente> e especifica quais serão traduzidos.
    Essa informação é posteriormente usada para verificar o número de argumentos
    do comando \begin.
    A sintaxe do argumento I<parâmetros> é a mesma da descrita para outros
    comandos.
    O primeiro parâmetro do comando \begin é o nome do ambiente.
    Este parâmetro não deve ser especificado na lista de parâmetros. Veja alguns
    exemplos:
     % po4a: environment multicols {}
     % po4a: environment equation

note: type: textblock
en: As for the commands, I<env> can be preceded by a plus (+) to indicate that the \begin command must be translated with all its arguments.
pt_BR: Quanto aos comandos, I<ambiente> pode ser precedido por um mais (+) para indicar que o comando \begin deve ser traduzido com todos os seus argumentos.

note: type: =item
en: B<% po4a: separator> I<env> B<">I<regex>B<">
pt_BR: B<% po4a: separator> I<ambiente> B<">I<expressão_regular>B<">

note: type: textblock
en: Indicates that an environment should be split according to the given regular expression.
pt_BR: Indica que um ambiente deveria ser dividido de acordo com a expressão regular fornecida.

note: type: textblock
en: The regular expression is delimited by quotes.  It should not create any back-reference.  You should use (?:) if you need a group.  It may also need some escapes.
pt_BR: A expressão regular é delimitada por aspas. Ela não deveria criar qualquer referência própria. Você deveria usar (?:) se você precisa de um grupo. Também pode ser necessário alguns caracteres de escapes.

note: type: textblock
en: For example, the LaTeX module uses the "(?:&|\\\\)" regular expression to translate separately each cell of a table (lines are separated by '\\' and cells by '&').
pt_BR: Por exemplo, o módulo LaTeX usa a expressão regular "(?:&|\\\\)" para traduzir separadamente cada célula de uma tabela (linhas são separadas por "\\" e células por "&").

note: type: textblock
en: The notion of environment is expanded to the type displayed in the PO file.  This can be used to split on "\\\\" in the first mandatory argument of the title command.  In this case, the environment is title{#1}.
pt_BR: A noção de ambiente é expandida ao tipo exibido no arquivo PO. Isso pode ser usado para dividir em "\\\\" no primeiro argumento obrigatório no comando title. neste caso, o ambiente é title{#1}.

note: type: =item
en: B<% po4a: verbatim environment> I<env>
pt_BR: B<% po4a: verbatim environment> I<ambiente>

note: type: textblock
en: Indicate that I<env> is a verbatim environment.  Comments and commands will be ignored in this environment.
pt_BR: Indica que I<ambiente> é o ambiente literal (verbatim). Comentários e comandos serão ignorados neste ambiente.

note: type: =head1
en: WRITING DERIVATE MODULES
pt_BR: ESCREVENDO MÓDULOS DERIVADOS

note: type: textblock
en: Add a string as a comment to be added around the next translated element.  This is mostly useful to the texinfo module, as comments are automatically handled in TeX.
pt_BR: Adiciona uma string como um comentário a ser adicionado em torno do próximo elemento traduzido.  Isso é principalmente útil para o módulo texinfo, já que os comentários são tratados automaticamente no TeX.

note: type: textblock
en: Wrapper around Transtractor's translate, with pre- and post-processing filters.
pt_BR: Wrapper da tradução do Transtractor, com filtros pré e pós-processamento.

note: type: textblock
en: Comments of a paragraph are inserted as a PO comment for the first translated string of this paragraph.
pt_BR: Comentários de um parágrafo são inseridos como um comentário no PO para a primeira string traduzida neste parágrafo.

note: type: textblock
en: This function returns:
pt_BR: Essa função retorna:

note: type: =item
en: A command name
pt_BR: Um nome de comando

note: type: textblock
en: If no command is found at the beginning of the given buffer, this string will be empty.  Only commands that can be separated are considered.  The %separated_command hash contains the list of these commands.
pt_BR: Se nenhuma comando for encontrado no começo do buffer fornecido, esta string estará vazia. Apenas comandos que podem ser separados são considerados. O hash %separated_command contém a lista destes comandos.

note: type: =item
en: A variant
pt_BR: Uma variante

note: type: textblock
en: This indicates if a variant is used.  For example, an asterisk (*) can be added at the end of sections command to specify that they should not be numbered.  In this case, this field will contain "*".  If there is no variant, the field is an empty string.
pt_BR: Isso indica se uma variante é usada. Por exemplo, um asterisco (*) pode ser adicionado ao final de comando de seções para especificar que eles deveriam não ser numerados. Nesse caso, este campo deveria conter "*". Se não houver variante, o campo é uma string vazia.

note: type: =item
en: An array of tuples (type of argument, argument)
pt_BR: Um vetor com tuplos (tipo de argumento, argumento)

note: type: textblock
en: The type of argument can be either '{' (for mandatory arguments) or '[' (for optional arguments).
pt_BR: O tipo de argumento pode ser tanto "{" (para argumentos obrigatórios) ou "[" (para argumentos opcionais).

note: type: =item
en: The remaining buffer
pt_BR: O buffer restante

note: type: textblock
en: The rest of the buffer after the removal of this leading command and its arguments.  If no command is found, the original buffer is not touched and returned in this field.
pt_BR: O resto do buffer após a remoção deste comando e seus argumentos. Se nenhum comando for encontrado, o buffer original não é afetado e é retornado neste campo.

note: type: textblock
en: The same as B<get_leading_command>, but for commands at the end of a buffer.
pt_BR: O mesmo que B<get_leading_command>, mas para comandos ao final de um buffer.

note: type: textblock
en: Recursively translate a buffer by separating leading and trailing commands (those which should be translated separately) from the buffer.
pt_BR: Traduz recursivamente um buffer separando comandos no início e no final (aqueles que devem ser traduzidos separadamente) do buffer.

note: type: textblock
en: If a function is defined in %translate_buffer_env for the current environment, this function will be used to translate the buffer instead of translate_buffer().
pt_BR: Se uma função é definida em %translate_buffer_env como o ambiente atual, essa função será usada para traduzir o buffer ao invés de translate_buffer().

note: type: textblock
en: Overloads Transtractor's read().
pt_BR: Sobrepõe o read() do Transtractor.

note: type: textblock
en: Recursively read a file, appending included files which are not listed in the @exclude_include array.  Included files are searched using the B<kpsewhich> command from the Kpathsea library.
pt_BR: Lê recursivamente um arquivo, anexando arquivos incluídos que não estão listados no vetor @exclude_include. Arquivos incluídos são pesquisados usando o comando B<kpsewhich> da biblioteca Kpathsea.

note: type: textblock
en: Except from the file inclusion part, it is a cut and paste from Transtractor's read.
pt_BR: Exceto pela parte de inclusão de arquivos, é uma cópia idêntica da leitura do Transtractor.

note: type: textblock
en: Subroutine for parsing a file with po4a directives (definitions for new commands).
pt_BR: Subrotina para analisar um arquivo com diretivas do po4a (definições de novos comandos).

note: type: textblock
en: Parse a definition line of the form "% po4a: ".
pt_BR: Analisa uma linha de definição na forma de "% po4a: ".

note: type: textblock
en: See the B<INLINE CUSTOMIZATION> section for more details.
pt_BR: Veja a seção B<PERSONALIZAÇÃO INTEGRADA> para mais detalhes.

note: type: =head1
en: INTERNAL FUNCTIONS used to write derivative parsers
pt_BR: FUNÇÕES INTERNAS usadas para escrever analisadores derivados

note: type: textblock
en: Command and environment functions take the following arguments (in addition to the $self object):
pt_BR: Funções de ambiente e comandos levam os seguintes argumentos (em adição ao objeto $self):

note: type: =item
en: An array of (type, argument) tuples
pt_BR: Um vetor de tuplos (tipo, argumento)

note: type: =item
en: The current environment
pt_BR: O ambiente atual

note: type: textblock
en: The first 3 arguments are extracted by get_leading_command or get_trailing_command.
pt_BR: Os primeiros três argumentos são extraídos por get_leading_command ou get_trailing_command.

note: type: textblock
en: Command and environment functions return the translation of the command with its arguments and a new environment.
pt_BR: Funções de ambiente ou comandos retornam a tradução do comando com seus argumentos e um novo ambiente.

note: type: textblock
en: Environment functions are called when a \begin command is found. They are called with the \begin command and its arguments.
pt_BR: Funções de ambiente são chamadas quando um comando \begin for encontrado. Elas são chamadas com o comando \begin e seus argumentos.

note: type: textblock
en: The TeX module only proposes one command function and one environment function: generic_command and generic_environment.
pt_BR: O módulo TeX propõe apenas uma função de comando e uma função de ambiente: generic_command e generic_environment.

note: type: verbatim
en: generic_command uses the information specified by
    register_generic_command or by adding definition to the TeX file:
     % po4a: command I<command1> I<parameters>
pt_BR: generic_command usa a informação especificada por
    register_generic_command ou adicionando definição ao arquivo TeX:
     % po4a: command I<comando1> I<parâmetros>

note: type: verbatim
en: generic_environment uses the information specified by
    register_generic_environment or by adding definition to the TeX file:
     % po4a: environment I<env> I<parameters>
pt_BR: generic_environment usa a informação especificada por
    register_generic_environment ou adicionando definição ao arquivo TeX:
     % po4a: environment I<ambiente> I<parâmetros>

note: type: textblock
en: Both functions will only translate the parameters that were specified as translatable (with a '_').  generic_environment will append the name of the environment to the environment stack and generic_command will append the name of the command followed by an identifier of the parameter (like {#7} or [#2]).
pt_BR: Ambas funções vai traduzir apenas os parâmetros que foram especificadas como traduzíveis (com uma "_"). generic_environment vai anexar o nome do ambiente à pilha de ambientes e generic_command vai anexar o nome do comando seguido por um identificador do parâmetro (como {#7} ou [#2]).

note: type: textblock
en: This module needs more tests.
pt_BR: Esse módulo precisa de mais testes.

note: type: textblock
en: It was tested on a book and with the Python documentation.
pt_BR: Ele foi testado em um livro e com a documentação Python.

note: type: =head1
en: TODO LIST
pt_BR: LISTA DE TAREFAS

note: type: =item
en: Automatic detection of new commands
pt_BR: Detecção automática de novos comandos

note: type: textblock
en: The TeX module could parse the newcommand arguments and try to guess the number of arguments, their type and whether or not they should be translated.
pt_BR: O módulo TeX poderia analisar os argumentos de novos comandos e tentar adivinhar o número de argumentos, seus tipos e se eles deveriam ser traduzidos.

note: type: =item
en: Translation of the environment separator
pt_BR: Tradução do separador de ambiente

note: type: textblock
en: When \item is used as an environment separator, the item argument is attached to the following string.
pt_BR: Quando o \item é usado como um separador de ambiente, o argumento item é anexado a string seguinte.

note: type: =item
en: Some commands should be added to the environment stack
pt_BR: Alguns comandos devem ser adicionados à pilha de ambiente

note: type: =item
en: Others
pt_BR: Outros

note: type: textblock
en: Various other points are tagged TODO in the source.
pt_BR: Vários outros pontos são marcados como TODO no código.

note: type: =head1
en: KNOWN BUGS
pt_BR: ERROS CONHECIDOS

note: type: textblock
en: Various points are tagged FIXME in the source.
pt_BR: Vários pontos são marcados como FIXME no código.

note: type: textblock
en: Locale::Po4a::Texinfo - convert Texinfo documents and derivates from/to PO files
pt_BR: Locale::Po4a::Texinfo - converte documentos Texinfo e derivados de/para arquivos PO

note: type: textblock
en: Locale::Po4a::Texinfo is a module to help the translation of Texinfo documents into other [human] languages.
pt_BR: Locale::Po4a::Texinfo é um módulo para ajudar a tradução de documentos Texinfo para outros idiomas.

note: type: textblock
en: This module contains the definitions of common Texinfo commands and environments.
pt_BR: Esse módulo contém as definições de comandos e ambientes comuns de Texinfo.

note: type: textblock
en: Only the comments starting with 'TRANSLATORS' are added to the PO files to guide the translators.
pt_BR: Apenas os comentários que começam com "TRANSLATORS" são adicionados aos arquivos PO para orientar os tradutores.

note: type: textblock
en: Locale::Po4a::Text - convert text documents from/to PO files
pt_BR: Locale::Po4a::Text - converte documentos texto de/para arquivos PO

note: type: textblock
en: Locale::Po4a::Text is a module to help the translation of text documents into other [human] languages.
pt_BR: Locale::Po4a::Text é um módulo para ajudar na tradução de documentos texto para outros idiomas.

note: type: textblock
en: Paragraphs are split on empty lines (or lines containing only spaces or tabulations).
pt_BR: Parágrafos são divididos em linhas vazias (ou linha contendo apenas espaços ou tabulações).

note: type: textblock
en: If a paragraph contains a line starting by a space (or tabulation), this paragraph won't be rewrapped.
pt_BR: Se um parágrafo contém uma linha começando com um espaço (ou tabulação), este parágrafo não será redimensionado.

note: type: textblock
en: Treat paragraphs that look like a key value pair as verbatim (with the no-wrap flag in the PO file).  Key value pairs are defined as a line containing one or more non-colon and non-space characters followed by a colon followed by at least one non-space character before the end of the line.
pt_BR: Trata parágrafos que parecem um par de valores-chave como verbatim (com o sinalizador no-wrap no arquivo PO). Os pares de valores-chave são definidos como uma linha contendo um ou mais caracteres diferentes de dois pontos e espaço seguidos por um dois pontos seguido por pelo menos um caractere diferente de espaço antes do final da linha.

note: type: textblock
en: Deactivate the detection of bullets.
pt_BR: Desativa a detecção de marcadores.

note: type: textblock
en: By default, when a bullet is detected, the bullet paragraph is not considered as a verbatim paragraph (with the no-wrap flag in the PO file). Instead, the corresponding paragraph is rewrapped in the translation.
pt_BR: Por padrão, quando um marcador é detectado, um parágrafo de marcador não é considerado como um parágrafo literal (com a opção "no-wrap" no arquivo PO). Em vez disso, realiza-se nova quebra de linha no parágrafo correspondente na tradução.

note: type: textblock
en: Specify how tabulations shall be handled. The I<mode> can be any of:
pt_BR: Especifica como as tabulações devem ser manipuladas. O I<mode> pode ser qualquer um dentre:

note: type: textblock
en: Lines with tabulations introduce breaks in the current paragraph.
pt_BR: Linhas com tabulações introduzem interrupção (término) no parágrafo atual.

note: type: textblock
en: Paragraph containing tabulations will not be re-wrapped.
pt_BR: Parágrafo contendo tabulações não será redimensionado.

note: type: textblock
en: By default, tabulations are considered as spaces.
pt_BR: Por padrão, tabulações são consideradas como espaços.

note: type: textblock
en: A regular expression matching lines which introduce breaks.  The regular expression will be anchored so that the whole line must match.
pt_BR: Uma expressão regular correspondendo a linhas que introduzem interrupção. A expressão regular será ancorada de forma que toda a linha deve corresponder.

note: type: textblock
en: Handle the header and footer of released versions, which only contain non translatable information.
pt_BR: Manipula o cabeçalho e rodapé das versões de lançamento, que só podem conter informações não traduzíveis.

note: type: textblock
en: Handle the fortunes format, which separate fortunes with a line which consists in '%' or '%%', and use '%%' as the beginning of a comment.
pt_BR: Manipula o formato do "fortunes", que separa "fortunes" com uma linha que consiste em "%" ou "%%" e usa "%%" como o início de um comentário.

note: type: textblock
en: Handle some special markup in Markdown-formatted texts.
pt_BR: Manipula algumas marcações especiais em textos formatados com Markdown.

note: type: =item
en: B<yfm_keys> (markdown-only)
pt_BR: B<yfm_keys> (somente Markdown)

note: type: =item
en: B<yfm_skip_array> (markdown-only)
pt_BR: B<yfm_skip_array> (somente Markdown)

note: type: =item
en: B<control>[B<=>I<taglist>]
pt_BR: B<control>[B<=>I<lista de marcações>]

note: type: textblock
en: Handle control files.  A comma-separated list of tags to be translated can be provided.
pt_BR: Manipula arquivos de controle. Uma lista separada por vírgula com as marcações a serem traduzidas que pode ser fornecida.

note: type: textblock
en: Prevent po4a from wrapping any lines. This means that every content is handled verbatim, even simple paragraphs.
pt_BR: Evita que po4a faça a quebra de qualquer linha. Isso significa que todo conteúdo é tratado verbatim, até mesmo parágrafos simples.

note: type: textblock
en: Tested successfully on simple text files and NEWS.Debian files.
pt_BR: Testado com sucesso em arquivos texto simples e arquivos NEWS.Debian.

note: type: textblock
en: Locale::Po4a::TransTractor - generic trans(lator ex)tractor.
pt_BR: Locale::Po4a::TransTractor - extrator de tradução genérico.

note: type: textblock
en: This class is the ancestor of every po4a parser used to parse a document, to search translatable strings, to extract them to a PO file and to replace them by their translation in the output document.
pt_BR: Essa classe é o ancestral de todo analisador po4a usado para analisar um documento, para pesquisar strings traduzíveis, para extraí-las para um arquivo PO e para substitui-las por suas traduções no documento de saída.

note: type: textblock
en: More formally, it takes the following arguments as input:
pt_BR: Mais formalmente, ele leva os seguintes argumentos como entrada:

note: type: textblock
en: a document to translate;
pt_BR: um documento para traduzir;

note: type: textblock
en: a PO file containing the translations to use.
pt_BR: um arquivo PO contendo as traduções para usar.

note: type: textblock
en: As output, it produces:
pt_BR: Como saída, ele produz:

note: type: textblock
en: another PO file, resulting of the extraction of translatable strings from the input document;
pt_BR: outro arquivo PO, resultando na extração de strings traduzíveis do documento de entrada;

note: type: textblock
en: a translated document, with the same structure than the one in input, but with all translatable strings replaced with the translations found in the PO file provided in input.
pt_BR: um documento traduzido, com a mesma estrutura daquela na entrada, mas com todas as strings traduzíveis substituídas com as traduções encontradas no arquivo PO fornecido na entrada.

note: type: textblock
en: Here is a graphical representation of this:
pt_BR: Aqui está uma representação gráfica disso:

note: type: verbatim
en:    Input document --\                             /---> Output document
                         \                           /       (translated)
                          +-> parse() function -----+
                         /                           \
       Input PO --------/                             \---> Output PO
                                                             (extracted)
pt_BR:    Doc. de entrada -\                             /---> Doc. de saída
                         \                           /       (traduzido)
                          +---> função parse() -----+
                         /                           \
       PO de entrada ---/                             \---> PO de saída
                                                             (extraído)

note: type: =head1
en: FUNCTIONS YOUR PARSER SHOULD OVERRIDE
pt_BR: FUNÇÕES QUE SEU ANALISADOR DEVERIA SOBRESCREVER

note: type: textblock
en: This is where all the work takes place: the parsing of input documents, the generation of output, and the extraction of the translatable strings. This is pretty simple using the provided functions presented in the section B<INTERNAL FUNCTIONS> below. See also the B<SYNOPSIS>, which presents an example.
pt_BR: É aqui onde todo trabalho acontece: o analisador de documentos de entrada, a geração de saída e a extração das strings traduzíveis. Isso é bem simples usando as funções fornecidas apresentadas na seção B<FUNÇÕES INTERNAS> abaixo. Veja também a B<SINOPSE>, que apresenta um exemplo.

note: type: textblock
en: This function is called by the process() function below, but if you choose to use the new() function, and to add content manually to your document, you will have to call this function yourself.
pt_BR: Essa função é chamada pela função process() abaixo, mas se você escolher usar a função new() e adicionar o conteúdo manualmente a seu documento, você terá que chamar essa função você mesmo.

note: type: textblock
en: This function returns the header we should add to the produced document, quoted properly to be a comment in the target language.  See the section B<Educating developers about translations>, from L<po4a(7)|po4a.7>, for what it is good for.
pt_BR: Essa função retorna o cabeçalho que nós deveríamos adicionar ao documento produzido, coloca apropriadamente entre aspas para ser um comentário no idioma alvo. Veja a seção B<Educando desenvolvedores sobre tradução>, do L<po4a(7)|po4a.7>, para o que isso é bom.

note: type: textblock
en: The following example parses a list of paragraphs beginning with "<p>". For the sake of simplicity, we assume that the document is well formatted, i.e. that '<p>' tags are the only tags present, and that this tag is at the very beginning of each paragraph.
pt_BR: O exemplo a seguir analisa uma linha de parágrafos começando com "<p>". Em nome da simplicidade, nós presumimos que o documento está bem formatado, ou seja, que as marcações "<p>" são as únicas marcações apresentadas e que essa marcação está exatamente no começo de cada parágrafo.

note: type: verbatim
en:    PARAGRAPH: while (1) {
           my ($paragraph,$pararef)=("","");
           my $first=1;
           my ($line,$lref)=$self->shiftline();
           while (defined($line)) {
               if ($line =~ m/<p>/ && !$first--; ) {
                   # Not the first time we see <p>.
                   # Reput the current line in input,
                   #  and put the built paragraph to output
                   $self->unshiftline($line,$lref);
pt_BR:    PARAGRAPH: while (1) {
           my ($paragraph,$pararef)=("","");
           my $first=1;
           my ($line,$lref)=$self->shiftline();
           while (defined($line)) {
               if ($line =~ m/<p>/ && !$first--; ) {
                   # Não é a primeira vez que vemos <p>.
                   # Colocar novamnete a linha atual na entrada,
                   #  e colocar o parágrafo compilado na saída
                   $self->unshiftline($line,$lref);

note: type: verbatim
en:                # Now that the document is formed, translate it:
                   #   - Remove the leading tag
                   $paragraph =~ s/^<p>//s;
pt_BR:                # Agora que o documento está formado, traduza-o:
                   #   - Remove a marcação no começo
                   $paragraph =~ s/^<p>//s;

note: type: verbatim
en:                #   - push to output the leading tag (untranslated) and the
                   #     rest of the paragraph (translated)
                   $self->pushline(  "<p>"
                                   . $self->translate($paragraph,$pararef)
                                   );
pt_BR:                #   - envia para a saída a marcação no começo (não
                   #      traduzida) e o resto do parágrafo (traduzido)
                   $self->pushline(  "<p>"
                                 . $self->translate($paragraph,$pararef)
                                 );

note: type: verbatim
en:                next PARAGRAPH;
               } else {
                   # Append to the paragraph
                   $paragraph .= $line;
                   $pararef = $lref unless(length($pararef));
               }
pt_BR:                next PARAGRAPH;
               } else {
                   # Anexa ao parágrafo
                   $paragraph .= $line;
                   $pararef = $lref unless(length($pararef));
               }

note: type: verbatim
en:            # Reinit the loop
               ($line,$lref)=$self->shiftline();
           }
           # Did not get a defined line? End of input file.
           return;
       }
     }
pt_BR:            # Reinicia o loop
               ($line,$lref)=$self->shiftline();
           }
           # Não conseguiu uma linha definida? Termina com o
           # arquivo de entrada.
           return;
       }
     }

note: type: textblock
en: Once you've implemented the parse function, you can use your document class, using the public interface presented in the next section.
pt_BR: Uma vez que você tenha implementada a função de análise, você pode usar sua classe de documento, usando a interface pública apresentada na seção seguinte.

note: type: =head1
en: PUBLIC INTERFACE for scripts using your parser
pt_BR: INTERFACE PÚBLICA para scripts usando seu analisador

note: type: =head2
en: Constructor
pt_BR: Construtor

note: type: textblock
en: This function can do all you need to do with a po4a document in one invocation. Its arguments must be packed as a hash. ACTIONS:
pt_BR: Essa função pode fazer tudo que você precisa fazer com um documento po4a em uma chamada. Seus argumentos devem ser empacotados como um hash. AÇÕES:

note: type: textblock
en: Reads all the PO files specified in po_in_name
pt_BR: Lê todos os arquivos PO especificados em po_in_name

note: type: textblock
en: Reads all original documents specified in file_in_name
pt_BR: Lê todos os documentos originais especificados em file_in_name

note: type: textblock
en: Parses the document
pt_BR: Analisa o documento

note: type: textblock
en: Reads and applies all the addenda specified
pt_BR: Lê e aplica todos os adendos especificados

note: type: textblock
en: Writes the translated document to file_out_name (if given)
pt_BR: Escreve o documento traduzido para file_out_name (se fornecido)

note: type: textblock
en: Writes the extracted PO file to po_out_name (if given)
pt_BR: Escreve o arquivo PO extraído para po_out_name (se fornecido)

note: type: textblock
en: ARGUMENTS, beside the ones accepted by new() (with expected type):
pt_BR: ARGUMENTOS, além dos aceitos por new() (com o tipo esperado):

note: type: textblock
en: List of filenames where we should read the input document.
pt_BR: Lista de nomes de arquivos nos quais nós deveríamos ler o documento de entrada.

note: type: textblock
en: Charset used in the input document (if it isn't specified, it will try to detect it from the input document).
pt_BR: Conjunto de caracteres usado no documento de entrada (se esse não for especificado, será tentado a detecção do documento de entrada).

note: type: textblock
en: Filename where we should write the output document.
pt_BR: Nome de arquivo no qual nós deveríamos escrever o documento de saída.

note: type: textblock
en: Charset used in the output document (if it isn't specified, it will use the PO file charset).
pt_BR: Conjunto de caracteres usado no documento de saída (se esse não for especificado, será usado o conjunto de caracteres do arquivo PO).

note: type: textblock
en: List of filenames where we should read the input PO files from, containing the translation which will be used to translate the document.
pt_BR: Lista de nomes de arquivos dos quais nós deveríamos ler os arquivos PO de entrada, contendo a tradução que será usada para traduzir o documento.

note: type: textblock
en: Filename where we should write the output PO file, containing the strings extracted from the input document.
pt_BR: Nome de arquivo no qual nós deveríamos escrever o arquivo PO de saída, contendo as strings extraídas do documento de entrada.

note: type: textblock
en: List of filenames where we should read the addenda from.
pt_BR: Lista de nomes de arquivos nos quais nós deveríamos ler os adendos.

note: type: textblock
en: Charset for the addenda.
pt_BR: Conjunto de caracteres para o adendos.

note: type: textblock
en: Create a new po4a document. Accepted options (in the hash passed as a parameter):
pt_BR: Cria um novo documento de po4a. Opções aceitas são (no hash passado como parâmetro):

note: type: textblock
en: Sets the verbosity.
pt_BR: Define o detalhamento.

note: type: textblock
en: Sets the debugging.
pt_BR: Define a depuração.

note: type: =head2
en: Manipulating document files
pt_BR: Manipulação de arquivos de documento

note: type: textblock
en: Add another input document data at the end of the existing array C<< @{$self->{TT}{doc_in}} >>. The argument is the filename to read. If a second argument is provided, it is the filename to use in the references.
pt_BR: Adiciona dados de outro documento de entrada ao final do vetor C<< @{$self->{TT}{doc_in}} >> existente. O argumento é o nome de arquivo para ler. Se um segundo argumento é fornecido, ele é o nome de arquivo para usar em referências.

note: type: verbatim
en: This array C<< @{$self->{TT}{doc_in}} >> holds this input document data as an
    array of strings with alternating meanings.
     * The string C<$textline> holding each line of the input text data.
     * The string C<< $filename:$linenum >> holding its location and called as
       "reference" (C<linenum> starts with 1).
pt_BR: Esse vetor C<< @{$self->{TT}{doc_in}} >> detém os dados desse documento de
    entrada como um vetor e strings com significados alternativos.
     * A string C<$textline> detendo cada linha de dados de texto de entrada.
     * A string C<< $filename:$linenum >> detendo sua localização e chamada
       como "referência" (C<linenum> inicia com 1).

note: type: textblock
en: Please note that it does not parse anything. You should use the parse()  function when you're done with packing input files into the document.
pt_BR: Por favor note que ele analisa nada. Você deveria usa a função parse() quando você acabar de empacotar os arquivos de entrada no documento.

note: type: textblock
en: Write the translated document to the given filename.
pt_BR: Escreve o documento traduzido no nome de arquivo fornecido.

note: type: verbatim
en: This translated document data are provided by:
     * C<< $self->docheader() >> holding the header text for the plugin, and
     * C<< @{$self->{TT}{doc_out}} >> holding each line of the main translated text in the array.
pt_BR: Os dados desse documento traduzido são fornecidos por:
     * C<< $self->docheader() >> detendo o texto de cabeçalho para o plugin, e
     * C<< @{$self->{TT}{doc_out}} >> detendo cada linha do principal texto traduzido no vetor.

note: type: =head2
en: Manipulating PO files
pt_BR: Manipulação de arquivos PO

note: type: textblock
en: Add the content of a file (which name is passed as argument) to the existing input PO. The old content is not discarded.
pt_BR: Adiciona o conteúdo de um arquivo, cujo nome é passado como argumento, ao PO de entrada existente. O conteúdo antigo é descartado.

note: type: textblock
en: Write the extracted PO file to the given filename.
pt_BR: Escrever o arquivo PO extraído para o nome de arquivo fornecido.

note: type: textblock
en: Returns some statistics about the translation done so far. Please note that it's not the same statistics than the one printed by msgfmt --statistic. Here, it's stats about recent usage of the PO file, while msgfmt reports the status of the file. It is a wrapper to the Locale::Po4a::Po::stats_get function applied to the input PO file. Example of use:
pt_BR: Retorna algumas estatísticas sobre a tradução realizada até o mesmo. Por favor, note que não são as mesmas estatísticas mostradas pelo "msgfmt --statistic". Aqui, são as estatísticas sobre uso recente do arquivo PO, enquanto o msgfmt relata o status do arquivo. Ele é um wrapper da função Locale::Po4a::Po::stats_get aplicada ao arquivo PO de entrada. Exemplo de uso:

note: type: verbatim
en:     [normal use of the po4a document...]
pt_BR:     [uso normal de um documento po4a...]

note: type: verbatim
en:     ($percent,$hit,$queries) = $document->stats();
        print "We found translations for $percent\%  ($hit from $queries) of strings.\n";
pt_BR:     ($percent,$hit,$queries) = $document->stats();
        print "Nós encontramos de $percent\%  ($hit de $queries) das strings.\n";

note: type: =head2
en: Manipulating addenda
pt_BR: Manipulando adendos

note: type: textblock
en: Please refer to L<po4a(7)|po4a.7> for more information on what addenda are, and how translators should write them. To apply an addendum to the translated document, simply pass its filename to this function and you are done ;)
pt_BR: Por favor veja o L<po4a(7)|po4a.7> para mais informações sobre o que são adendos e como tradutores deveriam escrevê-los. Para aplicar um adendo ao documento traduzido, simplesmente passe seu nome de arquivo para essa função e pronto ;)

note: type: textblock
en: This function returns a non-null integer on error.
pt_BR: Essa função retorna um inteiro não nulo quando há um erro.

note: type: =head2
en: Getting input, providing output
pt_BR: Obtendo a entrada, fornecendo a saída

note: type: textblock
en: Four functions are provided to get input and return output. They are very similar to shift/unshift and push/pop of Perl.
pt_BR: Quatro funções são fornecidas para obter entrada e retornar a saída. Elas são muito parecidas com shift/unshift e push/pop de Perl.

note: type: verbatim
en:  * Perl shift returns the first array item and drop it from the array.
     * Perl unshift prepends an item to the array as the first array item.
     * Perl pop returns the last array item and drop it from the array.
     * Perl push appends an item to the array as the last array item.
pt_BR:  * Perl shift retorna o primeiro item do vetor e solta-o do vetor.
    * Perl unshift preenche um item no vetor como o primeiro item do vetor.
    * Perl pop retorna o último item do vetor e solta-o do vetor.
    * Perl push acrescenta um item ao vetor como o último item do vetor.

note: type: textblock
en: The first pair is about input, while the second is about output. Mnemonic: in input, you are interested in the first line, what shift gives, and in output you want to add your result at the end, like push does.
pt_BR: O primeiro par é sobre entrada, enquanto ao segundo é sobre saída. Mnemônico: na entrada, você está interessada na primeira linha, que é o que o shift fornece, e na saída você quer adicionar seu resultado ao final, como o push faz.

note: type: textblock
en: This function returns the first line to be parsed and its corresponding reference (packed as an array) from the array C<< @{$self->{TT}{doc_in}} >> and drop these first 2 array items.  Here, the reference is provided by a string C<< $filename:$linenum >>.
pt_BR: Esta função retorna a primeira linha a ser analisada e a sua referência correspondente (empacotada como um vetor) do vetor C<< @{$self->{TT}{doc_in}} >> e descarta estes 2 primeiros itens do vetor. Aqui, a referência é fornecida por uma string C<< $filename:$linenum >>.

note: type: textblock
en: Unshifts the last shifted line of the input document and its corresponding reference back to the head of C<< {$self->{TT}{doc_in}} >>.
pt_BR: Executa unshift a última linha "shiftada" do documento de entrada e sua referência correspondente de volta para o cabeçalho de C<< {$self->{TT}{doc_in}} >>.

note: type: textblock
en: Push a new line to the end of C<< {$self->{TT}{doc_out}} >>.
pt_BR: Envia uma nova linha para o fim de C<< {$self->{TT}{doc_out}} >>.

note: type: textblock
en: Pop the last pushed line from the end of C<< {$self->{TT}{doc_out}} >>.
pt_BR: Volta, do fim de C<< {$self->{TT}{doc_out}} >>, a linha anteriormente enviada.

note: type: =head2
en: Marking strings as translatable
pt_BR: Marcando strings como traduzíveis

note: type: textblock
en: One function is provided to handle the text which should be translated.
pt_BR: Uma função é fornecida para manipular o texto que deveria ser traduzido.

note: type: textblock
en: Mandatory arguments:
pt_BR: Argumentos obrigatórios:

note: type: textblock
en: A string to translate
pt_BR: Uma string para traduzir

note: type: textblock
en: The reference of this string (i.e. position in inputfile)
pt_BR: A referência dessa string (i.e. posição no arquivo de entrada)

note: type: textblock
en: The type of this string (i.e. the textual description of its structural role; used in Locale::Po4a::Po::gettextization(); see also L<po4a(7)|po4a.7>, section B<Gettextization: how does it work?>)
pt_BR: O tipo dessa string (i.e. a descrição textual de seu papel estrutural; usado em Locale::Po4a::Po::gettextization(); veja também L<po4a(7)|po4a.7>, seção B<Gettextização: como ela funciona?>)

note: type: textblock
en: This function can also take some extra arguments. They must be organized as a hash. For example:
pt_BR: Essa função também pode levar alguns argumentos extras. Eles devem ser organizados como um hash. Por exemplo:

note: type: textblock
en: boolean indicating whether we can consider that whitespaces in string are not important. If yes, the function canonizes the string before looking for a translation or extracting it, and wraps the translation.
pt_BR: booleano indicando se nós podemos considerar que espaços em brancos nas strings não são importantes. Se sim, a função canoniza a string antes de procurar por uma tradução ou de extrair, e dimensiona a tradução.

note: type: textblock
en: an extra comment to add to the entry.
pt_BR: um comentário extra para adicionar ao registro.

note: type: textblock
en: Actions:
pt_BR: Ações:

note: type: textblock
en: Pushes the string, reference and type to po_out.
pt_BR: Envia a string, referência e tipo para po_out.

note: type: textblock
en: Returns the translation of the string (as found in po_in) so that the parser can build the doc_out.
pt_BR: Retorna a tradução da string (como encontrado em po_in) de forma que o analisador pode compilar o doc_out.

note: type: textblock
en: Handles the charsets to recode the strings before sending them to po_out and before returning the translations.
pt_BR: Manipula os conjuntos de caracteres para re-codificar as strings antes de enviá-las para po_out e antes de retornar as traduções.

note: type: =head2
en: Misc functions
pt_BR: Funções miscelânea

note: type: textblock
en: Returns if the verbose option was passed during the creation of the TransTractor.
pt_BR: Retorna se a opção de detalhamento foi passada durante a criação do TransTractor.

note: type: textblock
en: Returns if the debug option was passed during the creation of the TransTractor.
pt_BR: Retorna se a opção de depuração foi passada durante a criação do TransTractor.

note: type: textblock
en: This tells TransTractor that a new charset (the first argument) has been detected from the input document. It can usually be read from the document header. Only the first charset will remain, coming either from the process() arguments or detected from the document.
pt_BR: Isso fala para o TransTractor que um novo conjunto de caracteres (o primeiro argumento) foi detectado no documento de entrada. Ele normalmente pode ser lido do cabeçalho do documento. Apenas o primeiro conjunto de caracteres restará, vindo com os argumentos de process() ou detectado do documento.

note: type: textblock
en: This function will return the charset that should be used in the output document (usually useful to substitute the input document's detected charset where it has been found).
pt_BR: Essa função vai retornar o conjunto de caracteres que deveria ser usado no documento do entrada (normalmente útil para substituir o conjunto de caracteres detectado no documento de entrada, onde ele foi encontrado).

note: type: textblock
en: It will use the output charset specified in the command line. If it wasn't specified, it will use the input PO's charset, and if the input PO has the default "CHARSET", it will return the input document's charset, so that no encoding is performed.
pt_BR: Ele vai usar o conjunto de caracteres de saída especificado na linha de comando. Se não tiver sido especificado, ele vai usar o conjunto de caracteres do PO de entrada, e se o PO de entrada possuir o "CHARSET" padrão, ele vai retornar o conjunto de caracteres do documento de entrada, de forma que nenhuma codificação é realizada.

note: type: textblock
en: This function returns the recoded text passed as argument, from the input document's charset to the output document's one. This isn't needed when translating a string (translate() recodes everything itself), but it is when you skip a string from the input document and you want the output document to be consistent with the global encoding.
pt_BR: Essa função retorna o texto re-codificado passado como argumento, do conjunto de caracteres do documento de entrada para o do documento de saída. Isso não é necessário quando se está traduzindo uma string (o próprio translate() re-codifica tudo), mas é necessário quando você ignora uma string do documento de entrada e você deseja que o documento de saída seja consistente com a codificação global.

note: type: =head1
en: FUTURE DIRECTIONS
pt_BR: DIREÇÕES FUTURAS

note: type: textblock
en: One shortcoming of the current TransTractor is that it can't handle translated document containing all languages, like debconf templates, or .desktop files.
pt_BR: Um problema do atual TransTractor é que ele não consegue manipular documento traduzido contendo todos idiomas, como modelos de debconf, ou arquivos .desktop.

note: type: textblock
en: To address this problem, the only interface changes needed are:
pt_BR: Para resolver esse problema, as únicas alterações necessárias na interface são:

note: type: textblock
en: take a hash as po_in_name (a list per language)
pt_BR: pegar um hash como po_in_name (uma lista por idioma)

note: type: textblock
en: add an argument to translate to indicate the target language
pt_BR: adicionar um argumento para traduzir para indicar o idioma alvo

note: type: textblock
en: make a pushline_all function, which would make pushline of its content for all languages, using a map-like syntax:
pt_BR: fazer uma função pushline_all, que deveria fazer pushline de seu conteúdo para todos idiomas, usando uma sintaxe tipo mapa:

note: type: textblock
en: Will see if it's enough ;)
pt_BR: Veremos se isso é o suficiente ;)

note: type: textblock
en: Locale::Po4a::Wml - convert WML (web markup language) documents from/to PO files
pt_BR: Locale::Po4a::Wml - converte documentos WML (Website Meta Language) de/para arquivos PO

note: type: textblock
en: Locale::Po4a::Wml is a module to help the translation of WML documents into other [human] languages. Do not mixup the WML we are speaking about here (web markup language) and the WAP crap used on cell phones.
pt_BR: Locale::Po4a::Wml é um módulo para ajudar a tradução de documentos WML para outros idiomas. Não confunda WML que estamos falando aqui (Website Meta Language) e porcaria do WAP usado nos telefones celulares.

note: type: textblock
en: Please note that this module relies upon the Locale::Po4a::Xhtml module, which also relies upon the Locale::Po4a::Xml module.  This means that all tags for web page expressions are assumed to be written in the XHTML syntax.
pt_BR: Por favor note que esse módulo depende do módulo Locale::Po4a::Xhtml, o que depende do módulo Locale::Po4a::Xml. Isso significa que todas as marcações de expressões de página web são presumidas serem escritas na sintaxe XHTML.

note: type: textblock
en: This module works for some simple documents, but is still young.  Currently, the biggest issue of the module is probably that it cannot handle documents that contain non-XML inline tags such as <email "foo@example.org">, which are often defined in the WML.  Improvements will be added in the future releases.
pt_BR: Esse módulo funciona para alguns documentos simples, mas ainda é jovem. Atualmente, o maior problema do módulo provavelmente é que ele não consegue manipular documentos que contenham marcações em linhas não XML, tais como <email "foo@exemplo.org">, que é comumente definido no WML. Melhoras serão adicionadas em lançamentos futuros.

note: type: textblock
en: Locale::Po4a::Xhtml - convert XHTML documents from/to PO files
pt_BR: Locale::Po4a::Xhtml - converte documentos XHTML de/para arquivos PO

note: type: textblock
en: Locale::Po4a::Xhtml is a module to help the translation of XHTML documents into other [human] languages.
pt_BR: Locale::Po4a::Xhtml é um módulo para ajudar a tradução de documentos XHTML para outros idiomas.

note: type: =item
en: B<includessi>[B<=>I<rootpath>]
pt_BR: B<includessi>[B<=>I<caminho-raiz>]

note: type: textblock
en: Include files specified by an include SSI (Server Side Includes) element (e.g. <!--#include virtual="/foo/bar.html" -->).
pt_BR: Inclui arquivos especificados por um elemento de inclusão SSI (Server Side Includes) (ex.: <!--#include virtual="/foo/bar.html" -->).

note: type: textblock
en: B<Note:> You should use it only for static files.
pt_BR: B<Nota:> Você deveria usá-lo apenas para arquivos estáticos.

note: type: textblock
en: An additional I<rootpath> parameter can be specified. It specifies the root path to find files included by a B<virtual> attribute.
pt_BR: Um parâmetro I<caminho-raiz> adicional pode ser especificado. Ele especifica o caminho raiz para localizar arquivos incluídos por um atributo B<virtual>.

note: type: textblock
en: Locale::Po4a::Xml - convert XML documents and derivates from/to PO files
pt_BR: Locale::Po4a::Xml - converte documentos XML e derivados de/para arquivos PO

note: type: textblock
en: Locale::Po4a::Xml is a module to help the translation of XML documents into other [human] languages. It can also be used as a base to build modules for XML-based documents.
pt_BR: Locale::Po4a::Xml é um módulo para ajudar a tradução de documentos XML para outros idiomas. Ele também pode ser usado como uma base para compilar módulos para documentos baseados em XML.

note: type: =head1
en: TRANSLATING WITH PO4A::XML
pt_BR: TRADUZINDO COM PO4A::XML

note: type: textblock
en: This module can be used directly to handle generic XML documents.  This will extract all tag's content, and no attributes, since it's where the text is written in most XML based documents.
pt_BR: Esse módulo pode ser usado diretamente para manipular documentos XML genéricos. Ele vai extrair o conteúdo de todas as marcações, porém de nenhum atributo, já que é onde o texto está escrito na maioria dos documentos baseados em XML.

note: type: textblock
en: There are some options (described in the next section) that can customize this behavior.  If this doesn't fit to your document format you're encouraged to write your own module derived from this, to describe your format's details.  See the section B<WRITING DERIVATE MODULES> below, for the process description.
pt_BR: Há algumas opções (descritas na próxima seção) que podem personalizar este comportamento. Se isso não se adequar ao formato do seu documento, encorajamos você a escrever seu próprio módulo derivado deste, para descrever os detalhes do seu formato. Veja a seção abaixo B<ESCREVENDO MÓDULOS DERIVADOS>, para a descrição do processo.

note: type: textblock
en: The global debug option causes this module to show the excluded strings, in order to see if it skips something important.
pt_BR: A opção de depuração global causa esse módulo a mostrar as strings excluídas, para ver se ignora alguma coisa importante.

note: type: textblock
en: Prevents it to strip the spaces around the extracted strings.
pt_BR: Previne-o de cortar espaços em volta das strings extraídas.

note: type: textblock
en: Canonicalizes the string to translate, considering that whitespaces are not important, and wraps the translated document. This option can be overridden by custom tag options. See the B<translated> option below.
pt_BR: Canoniza a string para traduzir, considerando que espaços em branco não são importantes e dimensiona o documento traduzido. Essa opção pode ser sobrescrita por opções personalizadas de marcação. Veja a opção B<translated> abaixo.

note: type: textblock
en: Attributes are wrapped by default. This option disables wrapping.
pt_BR: Atributos são quebrados por padrão. Essa opção desabilita a quebra.

note: type: textblock
en: It makes the tags and attributes searching to work in a case insensitive way.  If it's defined, it will treat E<lt>BooKE<gt>laNG and E<lt>BOOKE<gt>Lang as E<lt>bookE<gt>lang.
pt_BR: Isso faz com que a pesquisa por marcações e atributos funcione de uma forma que diferencie letras maiúsculas das minúsculas. Se essa opção estiver definida, ela vai tratar E<lt>BooKE<gt>laNG e E<lt>BOOKE<gt>Lang como E<lt>bookE<gt>lang.

note: type: textblock
en: Escape quotes in output strings.  Necessary, for example, for creating string resources for use by Android build tools.
pt_BR: Escapa aspas em strings de saída. Necessário, por exemplo, para criação de recursos de string para usar por ferramentas de compilação de Android.

note: type: textblock
en: See also: https://developer.android.com/guide/topics/resources/string-resource.html
pt_BR: Veja também: https://developer.android.com/guide/topics/resources/string-resource.html

note: type: textblock
en: When defined, external entities are included in the generated (translated)  document, and for the extraction of strings.  If it's not defined, you will have to translate external entities separately as independent documents.
pt_BR: Quando definida, entidades externas são incluídas no documento gerado (traduzido) e para a extração de strings. Se não estiver definido, você terá que traduzir entidades externas separadamente como documentos independentes.

note: type: textblock
en: This option defines the behavior of the module when it encounters invalid XML syntax (a closing tag which does not match the last opening tag).  It can take the following values:
pt_BR: Essa opção define o comportamento do módulo quando ele encontrar uma sintaxe XML inválida (uma marcação fechando que não corresponde a última marcação abrindo). Ele pode levar os seguintes valores:

note: type: textblock
en: This is the default value.  The module will exit with an error.
pt_BR: Esse é o valor padrão. O módulo vai sair com um erro.

note: type: textblock
en: The module will continue, and will issue a warning.
pt_BR: O módulo vai continuar e vai fazer um aviso.

note: type: textblock
en: The module will continue without any warnings.
pt_BR: O módulo vai continuar sem qualquer aviso.

note: type: textblock
en: Be careful when using this option.  It is generally recommended to fix the input file.
pt_BR: Tenha cuidado ao usar essa opção. Ela geralmente é recomendada para corrigir o arquivo de entrada.

note: type: textblock
en: Note: This option is deprecated.
pt_BR: Nota: essa opção é obsoleta.

note: type: textblock
en: Extracts only the specified tags in the B<tags> option.  Otherwise, it will extract all the tags except the ones specified.
pt_BR: Extrai apenas as marcações especificadas na opção B<tags>. Do contrário, ela extrairá todas as marcações, com exceção daquelas especificadas.

note: type: textblock
en: String that will try to match with the first line of the document's doctype (if defined). If it doesn't, a warning will indicate that the document might be of a bad type.
pt_BR: String que tentará corresponder com a primeira linha do tipo de documento (doctype) do documento (se definido). Se não estiver definido, um aviso vai indicar que o documento pode ser um tipo incorreto.

note: type: textblock
en: String indicating the path (e.g. E<lt>bbbE<gt>E<lt>aaaE<gt>) of a tag where a lang="..." attribute shall be added. The language will be defined as the basename of the PO file without any .po extension.
pt_BR: String indicando o caminho (ex.: E<lt>bbbE<gt>E<lt>aaaE<gt>) de uma marcação na qual um atributo lang="..." deve ser adicionado. O idioma será definido como o nome base do arquivo PO sem qualquer extensão.

note: type: textblock
en: Boolean indicating whether closing tags are optional (as in HTML). By default, missing closing tags raise an error handled according to B<ontagerror>.
pt_BR: Booleano indicando se as tags de fechamento são opcionais (como em HTML). Por padrão, as tags de fechamento ausentes geram um erro tratado de acordo com B<ontagerror>.

note: type: textblock
en: Note: This option is deprecated.  You should use the B<translated> and B<untranslated> options instead.
pt_BR: Nota: Essa opção é obsoleta. Você deveria usar as opções B<translated> e B<untranslated> ao invés dessa.

note: type: textblock
en: Space-separated list of tags you want to translate or skip.  By default, the specified tags will be excluded, but if you use the "tagsonly" option, the specified tags will be the only ones included.  The tags must be in the form E<lt>aaaE<gt>, but you can join some (E<lt>bbbE<gt>E<lt>aaaE<gt>) to say that the content of the tag E<lt>aaaE<gt> will only be translated when it's into a E<lt>bbbE<gt> tag.
pt_BR: Lista separada por espaço de marcações que você deseja traduzir ou ignorar. Por padrão, as marcações especificadas serão excluídas, mas se você usar a opção "tagsonly", as marcações especificadas serão as únicas incluídas. As marcações devem estar na forma E<lt>aaaE<gt>, mas você pode juntar algumas (E<lt>bbbE<gt>E<lt>aaaE<gt>) para informar que o conteúdo da tag E<lt>aaaE<gt> será traduzido apenas quando ela estiver dentro de uma marcação E<lt>bbbE<gt>.

note: type: textblock
en: You can also specify some tag options by putting some characters in front of the tag hierarchy. For example, you can put I<w> (wrap) or I<W> (don't wrap)  to override the default behavior specified by the global B<wrap> option.
pt_BR: Você também pode especificar algumas opções de marcação para colocar alguns caracteres na frente da hierarquia de marcações. Por exemplo, você pode colocar um I<w> (wrap) or I<W> (não aplica wrap) para sobrescrever o comportamento padrão especificado pela opção global B<wrap>.

note: type: textblock
en: Example: WE<lt>chapterE<gt>E<lt>titleE<gt>
pt_BR: Exemplo: WE<lt>capítuloE<gt>E<lt>títuloE<gt>

note: type: textblock
en: Space-separated list of tag's attributes you want to translate.  You can specify the attributes by their name (for example, "lang"), but you can prefix it with a tag hierarchy, to specify that this attribute will only be translated when it's in the specified tag. For example: E<lt>bbbE<gt>E<lt>aaaE<gt>lang specifies that the lang attribute will only be translated if it's in an E<lt>aaaE<gt> tag, and it's in a E<lt>bbbE<gt> tag.
pt_BR: Lista separada por espaço de atributos da marcação que você deseja traduzir. Você pode especificar os atributos por seus nomes (por exemplo, "lang"), mas você pode prefixar com uma hierarquia de marcações, para especificar que esse atributo vai ser traduzido apenas quando ele estiver na marcação especificada. Por exemplo: E<lt>bbbE<gt>E<lt>aaaE<gt>lang especifica que o atributo lang será traduzido apenas se ele estiver dentro de uma marcação E<lt>aaaE<gt> e dentro de uma marcação E<lt>bbbE<gt>.

note: type: textblock
en: Do not translate attributes in inline tags.  Instead, replace all attributes of a tag by po4a-id=<id>.
pt_BR: Não traduz atributos nas marcações integradas. Ao invés disso, substitui todos os atributos de uma marcação por po4a-id=<id>.

note: type: textblock
en: This is useful when attributes shall not be translated, as this simplifies the strings for translators, and avoids typos.
pt_BR: Isso é útil quando os atributos não devam ser traduzidos, pois isso simplifica as strings para tradutores e evita erros de escrita.

note: type: textblock
en: Space-separated list of tags which should not be treated as tags.  These tags are treated as inline, and do not need to be closed.
pt_BR: Lista separada por espaço de marcações que não deveriam ser tratadas como marcações. Essas marcações são tratadas como integradas e não precisam ser fechadas.

note: type: textblock
en: Space-separated list of tags which should break the sequence.  By default, all tags break the sequence.
pt_BR: Lista separada por espaço de marcações que deveriam interromper a sequência. Por padrão, todas as marcações interrompem a sequência.

note: type: textblock
en: The tags must be in the form <aaa>, but you can join some (<bbb><aaa>), if a tag (<aaa>) should only be considered when it's within another tag (<bbb>).
pt_BR: As marcações estar na forma <aaa>, mas você pode juntar alguns (<bbb><aaa>), se uma marcação (<aaa>) deveria ser considerada apenas quando ela estiver dentro de outra marcação (<bbb>).

note: type: textblock
en: Please note a tag should be listed in only one of the B<break>, B<inline> B<placeholder>, or B<customtag> setting string.
pt_BR: Note que uma tag deve ser listada em apenas uma string de configuração de B<break>, B<inline> B<placeholder> ou B<customtag>.

note: type: textblock
en: Space-separated list of tags which should be treated as inline.  By default, all tags break the sequence.
pt_BR: Lista separada por espaço de marcações que deveriam ser tratadas como integradas. Por padrão, todas as marcações interrompem a sequência.

note: type: textblock
en: Space-separated list of tags which should be treated as placeholders.  Placeholders do not break the sequence, but the content of placeholders is translated separately.
pt_BR: Lista separada por espaço de marcações que devem ser tratadas como placeholders. Elas não interrompem a sequência, mas o conteúdo desses placeholders é traduzido separadamente.

note: type: textblock
en: The location of the placeholder in its block will be marked with a string similar to:
pt_BR: A localização do placeholder em seu bloco será marcado com uma string similar a:

note: type: textblock
en: By default, Processing Instructions (i.e., C<E<lt>? ... ?E<gt>> tags) are handled as inline tags.  Pass this option if you want the PI to be handled as breaking tag.  Note that unprocessed PHP tags are handled as Processing Instructions by the parser.
pt_BR: Por padrão, as Instruções de Processamento (ou seja, tags C<E<lt>? ... ?E<gt>>) são tratadas como tags embutidas. Passe essa opção se desejar que as I.P. sejam tratadas como tag de quebra. Note que tags PHP não processadas são tratadas como Instruções de Processamento pelo analisador.

note: type: textblock
en: Space separated list of tags that the module should not try to set by default in any category.
pt_BR: Lista separada por espaço de marcações que o módulo não deveria tentar definir por padrão em qualquer categoria.

note: type: textblock
en: If you have a tag which has its default setting by the subclass of this module but you want to set alternative setting, you need to list that tag as a part of the B<nodefault> setting string.
pt_BR: Se você tiver uma tag que tenha sua configuração padrão pela subclasse deste módulo, mas desejar definir uma configuração alternativa, será necessário listar essa tag como parte da string de configuração B<nodefault>.

note: type: textblock
en: Support C preprocessor directives.  When this option is set, po4a will consider preprocessor directives as paragraph separators.  This is important if the XML file must be preprocessed because otherwise the directives may be inserted in the middle of lines if po4a consider it belong to the current paragraph, and they won't be recognized by the preprocessor.  Note: the preprocessor directives must only appear between tags (they must not break a tag).
pt_BR: Diretivas de suporte do preprocessador C. Quando essa opção está definida, po4a vai considerar as diretivas do preprocessador como separadores de parágrafo. Isso é importante se o arquivo XML deve ser preprocessado porque, do contrário, as diretivas podem ser inseridas no meio de linhas se po4a considerar que elas pertencem ao parágrafo atual, e elas não serão reconhecidas pelo preprocessador. Nota: as diretivas do preprocessador devem aparecer apenas entre marcações (elas não podem interromper uma marcação).

note: type: textblock
en: Space-separated list of tags you want to translate.
pt_BR: Lista separada por espaço de marcações que você deseja traduzir.

note: type: textblock
en: You can also specify some tag options by putting some characters in front of the tag hierarchy.  This overrides the default behavior specified by the global B<wrap> and B<defaulttranslateoption> option.
pt_BR: Você também pode especificar algumas opções de marcação para colocar alguns caracteres na frente da hierarquia de marcações. Isso sobrescreve o comportamento padrão especificado pelas opções globais B<wrap> e B<defaulttranslateoption>.

note: type: textblock
en: Tags should be translated and content can be re-wrapped.
pt_BR: Tags deveriam ser traduzidas e o conteúdo pode ser redimensionado.

note: type: textblock
en: Tags should be translated and content should not be re-wrapped.
pt_BR: Tags deveriam ser traduzidas e o conteúdo não deveria ser redimensionado.

note: type: textblock
en: Tags should be translated inline.
pt_BR: Tags deveriam ser traduzidas integradas.

note: type: textblock
en: Tags should be translated as placeholders.
pt_BR: Tags deveriam ser traduzidas como placeholders.

note: type: textblock
en: Internally, the XML parser only cares about these four options: I<w> I<W> I<i> I<p>.
pt_BR: Internamente, o analisador XML só se preocupa com essas quatro opções: I<w> I<W> I<i> I<p>.

note: type: textblock
en: * Tags listed in B<break> are set to I<w> or I<W> depending on the B<wrap> option.
pt_BR: * As tags listadas em B<break> são definidas como I<w> ou I<W> dependendo da opção B<wrap>.

note: type: textblock
en: * Tags listed in B<inline> are set to I<i>.
pt_BR: * As tags listadas em B<inline> são definidas como I<i>.

note: type: textblock
en: * Tags listed in B<placeholder> are set to I<p>.
pt_BR: * As tags listadas em B<placeholder> são definidas como I<p>.

note: type: textblock
en: * Tags listed in B<untranslated> are without any of these options set.
pt_BR: * As tags listadas em B<untranslated> estão sem nenhuma dessas opções definidas.

note: type: textblock
en: You can verify actual internal parameter behavior by invoking B<po4a> with B<--debug> option.
pt_BR: Você pode verificar o comportamento real do parâmetro interno invocando B<po4a> com a opção B<--debug>.

note: type: textblock
en: Please note a tag should be listed in either B<translated> or B<untranslated> setting string.
pt_BR: Note que uma tag deve estar listada na string de configuração B<translated> ou B<untranslated>.

note: type: textblock
en: Space-separated list of tags you do not want to translate.
pt_BR: Lista separada por espaço de marcações que você não deseja traduzir.

note: type: textblock
en: Please note a translatable inline tag in an untranslated tag is treated as a translatable breaking tag, I<i> setting is dropped and I<w> or I<W> is set depending on the B<wrap> option.
pt_BR: Note que uma tag inline traduzível em uma tag não traduzida é tratada como uma tag de quebra traduzível, a configuração I<i> é descartada e I<w> ou I<W> é definida dependendo da opção B<wrap>.

note: type: textblock
en: The default categories for tags that are not in any of the translated, untranslated, break, inline, or placeholder.
pt_BR: As categorias padrão para marcações que estão em nenhum entre "translated", "untranslated", "break", "inline" ou "placeholder".

note: type: textblock
en: This is a set of letters as defined in B<translated> and this setting is only valid for translatable tags.
pt_BR: Este é um conjunto de letras, conforme definido em B<translated>, e essa configuração é válida apenas para tags traduzíveis.

note: type: =head1
en: WRITING DERIVATIVE MODULES
pt_BR: ESCREVENDO MÓDULOS DERIVADOS

note: type: =head2
en: DEFINE WHAT TAGS AND ATTRIBUTES TO TRANSLATE
pt_BR: DEFINA QUAIS MARCAÇÕES E ATRIBUTOS DEVEM SER TRADUZIDOS

note: type: textblock
en: The simplest customization is to define which tags and attributes you want the parser to translate.  This should be done in the initialize function.  First you should call the main initialize, to get the command-line options, and then, append your custom definitions to the options hash.  If you want to treat some new options from command line, you should define them before calling the main initialize:
pt_BR: A personalização mais simples é definir quais marcações e atributos você deseja que o analisador traduzida. Isso deveria ser feito na função "initialize". Primeiro, você deveria chamar o "initialize" principal, para obter as opções de linha de comando e, então, anexe suas definições personalizadas aos hash de opções. Se você deseja tratar algumas novas opções a partir da linha de comando, você deveria defini-las antes de chamar o "initialize" principal:

note: type: textblock
en: You should use the B<_default_inline>, B<_default_break>, B<_default_placeholder>, B<_default_translated>, B<_default_untranslated>, and B<_default_attributes> options in derivative modules. This allow users to override the default behavior defined in your module with command line options.
pt_BR: Você deveria usar as opções B<_default_inline>, B<_default_break>, B<_default_placeholder>, B<_default_translated>, B<_default_untranslated> e B<_default_attributes> nos módulos derivados. Isso permite que usuários sobrescrevam o comportamento padrão definido em seu módulo com opções de linha de comando.

note: type: textblock
en: If you don't like the default behavior of this xml module and its derivative modules, you can provide command line options to change their behavior.
pt_BR: Se você não gostar do comportamento padrão deste módulo xml e seus módulos derivados, poderá fornecer opções de linha de comando para alterar seu comportamento.

note: type: textblock
en: See L<Locale::Po4a::Docbook(3pm)|Locale::Po4a::Docbook>,
pt_BR: Veja L<Locale::Po4a::Docbook(3pm)|Locale::Po4a::Docbook>,

note: type: =head2
en: OVERRIDING THE found_string FUNCTION
pt_BR: SOBRESCREVENDO A FUNÇÃO found_string

note: type: textblock
en: Another simple step is to override the function "found_string", which receives the extracted strings from the parser, in order to translate them.  There you can control which strings you want to translate, and perform transformations to them before or after the translation itself.
pt_BR: Outro passo simples é sobrescrever a função "found_string", que recebe as strings extraídas do analisador, para traduzi-las. Lá, você pode controlar quais strings você deseja traduzir e realizar transformações nelas antes ou após a tradução em si.

note: type: textblock
en: It receives the extracted text, the reference on where it was, and a hash that contains extra information to control what strings to translate, how to translate them and to generate the comment.
pt_BR: Ela recebe o texto extraído, a referência de onde ele estava e um hash que contém informações extras para controlar quais strings devem ser traduzidas, como traduzi-las e para gerar o comentário.

note: type: textblock
en: The content of these options depends on the kind of string it is (specified in an entry of this hash):
pt_BR: O conteúdo dessas opções dependem do tipo de string (especificado em uma entrada dessa hash):

note: type: textblock
en: The found string is the content of a translatable tag. The entry "tag_options" contains the option characters in front of the tag hierarchy in the module "tags" option.
pt_BR: A string encontrada é o conteúdo de uma marcação traduzível. A entrada "tag_options" contém os caracteres da opção na frente da hierarquia de marcação na opção "tags" do módulo.

note: type: textblock
en: Means that the found string is the value of a translatable attribute. The entry "attribute" has the name of the attribute.
pt_BR: Significa que a string encontrada é o valor de um atributo traduzível. A entrada "atributo" possui o nome do atributo.

note: type: textblock
en: It must return the text that will replace the original in the translated document. Here's a basic example of this function:
pt_BR: Ela deve retornar o texto que vai substituir o original no documento traduzido. Aqui está um exemplo básico dessa função:

note: type: textblock
en: There's another simple example in the new Dia module, which only filters some strings.
pt_BR: Há um outro exemplo simples no novo módulo do Dia, o qual filtra apenas algumas strings.

note: type: =head2
en: MODIFYING TAG TYPES (TODO)
pt_BR: MODIFICANDO TIPOS DE MARCAÇÕES (A FAZER)

note: type: textblock
en: This is a more complex one, but it enables a (almost) total customization.  It's based on a list of hashes, each one defining a tag type's behavior. The list should be sorted so that the most general tags are after the most concrete ones (sorted first by the beginning and then by the end keys). To define a tag type you'll have to make a hash with the following keys:
pt_BR: Isso é mais complexo, mas permite quase que uma personalização total. É baseado em uma lista de hashes, cada um definindo um comportamento do tipo de marcação. A lista deveria ser organizado de forma que a maioria das marcações gerais estão após aquelas mais concretas (organizadas primeiro pelas chaves iniciais e, então, pelas finais). Para definir um tipo de marcação, você terá que fazer um hash com as seguintes chaves:

note: type: textblock
en: Specifies the beginning of the tag, after the "E<lt>".
pt_BR: Especifica o começo da marcação, após do "E<lt>".

note: type: textblock
en: Specifies the end of the tag, before the "E<gt>".
pt_BR: Especifica o fim da marcação, antes do "E<gt>".

note: type: textblock
en: It says if this is a breaking tag class.  A non-breaking (inline) tag is one that can be taken as part of the content of another tag.  It can take the values false (0), true (1) or undefined.  If you leave this undefined, you'll have to define the f_breaking function that will say whether a concrete tag of this class is a breaking tag or not.
pt_BR: Informa se essa é uma classe de interrupção de marcação. Uma marcação de não-interrupção (integrada) é aquela que pode ser levada como parte do conteúdo de outra marcação. Ela pode levar os valores falso (0), verdadeiro (1) ou indefinido. Se você deixa-la como indefinida, você terá que definir a função f_breaking que vai dizer se uma marcação concreta dessa classe é uma marcação de interrupção ou não.

note: type: textblock
en: It's a function that will tell if the next tag is a breaking one or not.  It should be defined if the B<breaking> option is not.
pt_BR: Essa é uma função que vai dizer se a próxima marcação é uma de interrupção ou não. Ela deveria ser definida se a opção B<breaking> não estiver.

note: type: textblock
en: If you leave this key undefined, the generic extraction function will have to extract the tag itself.  It's useful for tags that can have other tags or special structures in them, so that the main parser doesn't get mad.  This function receives a boolean that says if the tag should be removed from the input stream or not.
pt_BR: Se você deixar essa chave indefinida, a função de extração genérica terá ela mesma que extrair a marcação. Isso é útil para marcações que podem ter outras marcações ou estruturas especiais nelas, de forma que o analisador principal não fique doido. Essa função recebe um booleano que informa se a marcação deveria, ou não, ser removida do fluxo de entrada.

note: type: textblock
en: This function receives the tag (in the get_string_until() format) and returns the translated tag (translated attributes or all needed transformations) as a single string.
pt_BR: Essa função recebe a marcação (no formato de get_string_until() ) e retorna a marcação traduzida (atributos traduzidos ou todas as transformações necessárias) como uma string única.

note: type: =head2
en: WORKING WITH TAGS
pt_BR: TRABALHANDO COM MARCAÇÕES

note: type: textblock
en: This function returns the path to the current tag from the document's root, in the form E<lt>htmlE<gt>E<lt>bodyE<gt>E<lt>pE<gt>.
pt_BR: Essa função retorna o caminho da marcação atual da raiz do documento, na forma de E<lt>htmlE<gt>E<lt>bodyE<gt>E<lt>pE<gt>.

note: type: textblock
en: An additional array of tags (without brackets) can be passed as argument.  These path elements are added to the end of the current path.
pt_BR: Um vetor adicional de marcações (sem sinais de maior que, menor que) podem ser passados como argumentos. Esses elementos de caminho são adicionados ao final do caminho atual.

note: type: textblock
en: This function returns the index from the tag_types list that fits to the next tag in the input stream, or -1 if it's at the end of the input file.
pt_BR: Essa função retorna o índice da lista tag_types que ajusta à próxima aba no fluxo de entrada, ou -1 se ela está ao final do arquivo de entrada.

note: type: textblock
en: Here, the tag has structure started by E<lt> and end by E<gt> and it can contain multiple lines.
pt_BR: Aqui, a tag tem estrutura iniciada por E<lt> e finalizada por E<gt> e pode conter várias linhas.

note: type: textblock
en: This works on the array C<< @{$self->{TT}{doc_in}} >> holding input document data and reference indirectly via C<< $self->shiftline() >> and C<< $self->unshiftline($$) >>.
pt_BR: Isso funciona no vetor C<< @{$self->{TT}{doc_in}} >> detendo os dados do documento de entrada e referência indiretamente via C<< $self->shiftline() >> e C<< $self->unshiftline($$) >>.

note: type: textblock
en: This function returns the next tag from the input stream without the beginning and end, in an array form, to maintain the references from the input file.  It has two parameters: the type of the tag (as returned by tag_type) and a boolean, that indicates if it should be removed from the input stream.
pt_BR: Essa função retorna a marcação seguinte do fluxo de entrada sem o início e fim, em uma forma de vetor, para manter a referência do arquivo de entrada. Ela tem dois parâmetros: o tipo da marcação (como retornada por tag_type) e um booleano, que indica se ela deveria ser removida do fluxo de entrada.

note: type: textblock
en: This function returns the name of the tag passed as an argument, in the array form returned by extract_tag.
pt_BR: Essa função retorna o nome da marcação passada como um argumento, na forma de vetor retornado por extract_tag.

note: type: textblock
en: This function returns a boolean that says if the next tag in the input stream is a breaking tag or not (inline tag).  It leaves the input stream intact.
pt_BR: Essa função retorna um booleano que informa se a próxima marcação no fluxo de entrada é uma marcação de interrupção ou não (marcação integrada). Ela deixa o fluxo de entrada intacto.

note: type: textblock
en: This function translates the next tag from the input stream.  Using each tag type's custom translation functions.
pt_BR: Essa função traduz a próxima marcação do fluxo de entrada, usando as funções de tradução personalizada de cada tipo de marcação.

note: type: textblock
en: This function returns a string value that says if the first argument (a tag hierarchy) matches any of the tags from the second argument (a list of tags or tag hierarchies). If it doesn't match, it returns 0. Else, it returns the matched tag's options (the characters in front of the tag) or 1 (if that tag doesn't have options).
pt_BR: Essa função retorna um valor de string que informa se o primeiro argumento (uma hierarquia de marcações) corresponde a qualquer das marcações do segundo argumento (uma lista de marcações ou hierarquias de marcações). Se ela não corresponder, retorna 0. Do contrário, retorna as opções da marcação correspondente (os caracteres na frente da marcação) ou 1 (se aquela marcação não possuir opções).

note: type: =head2
en: WORKING WITH ATTRIBUTES
pt_BR: TRABALHANDO COM ATRIBUTOS

note: type: textblock
en: This function handles the translation of the tags' attributes. It receives the tag without the beginning / end marks, and then it finds the attributes, and it translates the translatable ones (specified by the module option B<attributes>).  This returns a plain string with the translated tag.
pt_BR: Essa função manipula a tradução dos atributos das marcações. Ela recebe a marcação sem as marcas de início / fim e, então, ela encontra os atributos e traduz os traduzíveis (especificado pela opção do módulo B<attributes>). Isso retorna uma string simples com a marcação traduzida.

note: type: =head2
en: WORKING WITH TAGGED CONTENTS
pt_BR: TRABALHANDO COM CONTEÚDOS MARCADOS

note: type: textblock
en: This function gets the text until the next breaking tag (not inline) from the input stream.  Translate it using each tag type's custom translation functions.
pt_BR: Essa função obtém o texto até a próxima tag de quebra (não em linha) do fluxo de entrada. Traduza-a usando as funções de tradução personalizadas de cada tipo de marcação.

note: type: =head2
en: WORKING WITH THE MODULE OPTIONS
pt_BR: TRABALHANDO COM AS OPÇÕES DO MÓDULO

note: type: textblock
en: This function fills the internal structures that contain the tags, attributes and inline data with the options of the module (specified in the command-line or in the initialize function).
pt_BR: Essa função preenche as estruturas internal que contém as marcações, atributos e dados integrados com as opções do módulo (especificado na linha de comando ou na função "inicialize").

note: type: =head2
en: GETTING TEXT FROM THE INPUT DOCUMENT
pt_BR: OBTENDO TEXTO DO DOCUMENTO DE ENTRADA

note: type: textblock
en: This function returns an array with the lines (and references) from the input document until it finds the first argument.  The second argument is an options hash. Value 0 means disabled (the default) and 1, enabled.
pt_BR: Essa função retorna um vetor com as linhas (e referências) do documento de entrada até encontrar o primeiro argumento. O segundo argumento é um hash de opções. Valor 0 significa desabilitado (o padrão) e 1, habilitado.

note: type: textblock
en: The valid options are:
pt_BR: As opções válidas são:

note: type: textblock
en: This makes the returned array to contain the searched text
pt_BR: Isso faz o vetor resultante conter o texto pesquisado

note: type: textblock
en: This removes the returned stream from the input
pt_BR: Isso remove o fluxo retornado da entrada

note: type: textblock
en: This ensures that the searched text is outside any quotes
pt_BR: Isso garante que o texto pesquisado não está entre aspas

note: type: textblock
en: This denotes that the first argument is a regular expression rather than an plain string
pt_BR: Isso indica que o primeiro argumento é uma expressão regular e não uma string simples

note: type: textblock
en: This function receives as argument the reference to a paragraph (in the format returned by get_string_until), skips his heading spaces and returns them as a simple string.
pt_BR: Essa função recebe como argumento a referência para um parágrafo (no formato retornado por get_string_until), ignora seu espaço inicial e retorna-as como uma string simples.

note: type: textblock
en: This function returns a simple string with the text from the argument array (discarding the references).
pt_BR: Essa função retorna uma string simples com o texto de um vetor de argumentos (descartando as referências).

note: type: textblock
en: This module can translate tags and attributes.
pt_BR: Esse módulo pode traduzir marcações e atributos.

note: type: textblock
en: DOCTYPE (ENTITIES)
pt_BR: DOCTYPE (ENTIDADES)

note: type: textblock
en: There is a minimal support for the translation of entities. They are translated as a whole, and tags are not taken into account. Multilines entities are not supported and entities are always rewrapped during the translation.
pt_BR: Há um suporte mínimo para a tradução de entidades. Elas são traduzidos como um todo e marcações não são levadas em conta. Não há suporte a entidades multilinhas, sofrendo elas uma quebra de linha durante a tradução.

note: type: textblock
en: MODIFY TAG TYPES FROM INHERITED MODULES (move the tag_types structure inside the $self hash?)
pt_BR: MODIFICAR TIPOS DE MARCAÇÃO DE MÓDULOS HERDADOS (move a estrutura de tag_types para dentro do $self hash?)

note: type: textblock
en: Locale::Po4a::Yaml - convert YAML files from/to PO files
pt_BR: Locale::Po4a::Yaml - converte arquivos YAML de/para arquivos PO

note: type: textblock
en: Locale::Po4a::Yaml is a module to help the translation of Yaml files into other [human] languages.
pt_BR: Locale::Po4a::Yaml é um módulo para ajudar a tradução de arquivos Yaml para outros idiomas.

note: type: textblock
en: The module extracts the value of YAML hashes and arrays. Hash keys are not extracted.
pt_BR: O módulo extrai o valor de hashes e matrizes YAML. As chaves hash não são extraídas.

note: type: textblock
en: NOTE: This module parses the YAML file with YAML::Tiny.
pt_BR: NOTA: Este módulo analisa o arquivo YAML com YAML::Tiny.

note: type: textblock
en: Do not translate array values.
pt_BR: Não traduz os valores de matrizes.
