po4a 0.43 - en to pt translation catalogue (899 entries)

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

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

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

note: type: =head1
en: DESCRIPTION
pt: 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: Os tradutores podem usar <command>po4a-display-man</command> para ver como tradução dele de uma página man será renderizada para os utilizadores 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: Este script só funciona com páginas de manual escritas diretamente em <emphasis remap='I'>nroff</emphasis> e manipuladas pelo módulo <emphasis remap='I'>man</emphasis> do po4a. Páginas de manual geradas de outros formatos, como DocBook ou POD, não sãosuportado. Veja<citerefentry><refentrytitle>po4a-display-pod</refentrytitle><manvolnum>1</manvolnum></citerefentry> para um equivalente suporte de <emphasis remap='I'>POD</emphasis> documentos.

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

note: type: Content of: <refentry><refsect1><variablelist><varlistentry><listitem><para>
en: The PO file containing the translations.
pt: O ficheiro PO que contém as traduções.

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: A página do manual original. Pode ser o caminho absoluto ou relativo à página do manual original (compactada ou não), o nome da página do manual e secção da página do manual (a usar o formato man.section). Quando o documento mestre não é fornecido com a <option>-m</option> opção <command>po4a-display-man</command> tenta encontrar a página do manual original, baseada na linha de referência da primeira linha no PO.

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: Algumas opções para passar para <citerefentry><refentrytitle>po4a-translate</refentrytitle><manvolnum>1</manvolnum></citerefentry>.

note: type: =head1
en: SEE ALSO
pt: VER TAMBÉM

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

note: type: Content of: <refentry><refnamediv><refpurpose>
en: display of a translated POD file according to a PO
pt: exibição de um ficheiro POD traduzido de acordo com um PO

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: Os tradutores podem usar <command>po4a-display-pod</command> para ver como a tradução de uma página de man será feita para os utilizadores finais, sem recompilar e reinstalar o projeto inteiro.  Na maioria das vezes, o ficheiro POD está disponível apenas no pacote fonte ou embutido no script Perl.

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

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

note: type: textblock
en: po4a - update both the PO files and translated documents in one shot
pt: po4a - atualizar ambos os ficheiros PO e documentos traduzidos numa só vez

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

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: po4a (PO for anything) facilita a manutenção de tradução da documentação a usar as ferramentas clássicas do gettext. A característica principal 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: Limite mínimo de percentagem de tradução para manter (p.ex. escrever) o ficheiro resultante (predefinição: 80). P.ex. por predefinição, ficheiros têm que ser traduzidos pelo menos a 80% para serem escritos no disco.

note: type: textblock
en: Show a short help message.
pt: Mostrar uma pequena 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: Conjunto de carateres dos ficheiros a conter os documentos a traduzir. Note que todos os ficheiros mestres devem ter o mesmo conjunto de carateres.

note: type: textblock
en: Charset of the files containing the localized documents. Note that all translated documents will use the same charset.
pt: Carrossel dos ficheiros que contêm os documentos localizados. Note que todos os documentos traduzidos utilizarão 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: Conjunto de carateres da adenda. Note-se que todas as adendas devem estar no mesmo conjnto de carateres.

note: type: textblock
en: Display the version of the script and exit.
pt: Mostrar a versão do script e sair.

note: type: textblock
en: Increase the verbosity of the program.
pt: Aumentar o detalhe do programa.

note: type: textblock
en: Decrease the verbosity of the program.
pt: Diminuir o detalhe do programa.

note: type: textblock
en: Output some debugging information.
pt: Saída de alguma informação 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: Opção/ções adicional/ais para passar ao plugin de formato. Veja a documentação de cada plugin para mais informações sobre as opções válidas e os significados deles. Por exemplo, 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: Gera sempre os ficheiros POT e PO, mesmo se B<po4a> considera que não é necessário.

note: type: textblock
en: The default behavior (when B<--force> is not specified) is the following:
pt: O comportamento predefinido (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: Se o ficheiro POT já existe, ele é regenerado se um documento mestre ou o ficheiro de configuração é mais recente (a menos que B<--no-update> seja fornecido). O ficheiro POT também é escrito num documento temporário e B<po4a> verifica que as mudanças 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: Além disso, uma tradução é regenerada somente se o documento mestre dela, o ficheiro PO, uma das suas adendas ou o ficheiro de configuração é mais recente. Para evitar tentar regenerar traduções que não passam no teste de limite (ver B<--keep>), um ficheiro com a extensão F<.po4a-stamp> pode ser criado (ver 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: Se um documento mestre inclui ficheiros, deve usar a flag B<--force> porque o tempo de modificação dos ficheiros incluídos não são tomados em conta.

note: type: textblock
en: The PO files are always re-generated based on the POT with B<msgmerge -U>.
pt: Os ficheiros PO são sempre regenerados com base em 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: Diz B<po4a> para criar ficheiros de informação quando uma tradução não é gerada porque não atingiu o limiar. Esses ficheiros de informação são nomeados de acordo com o documento traduzido 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: Nota: Isso só ativa a criação dos ficheiros F<.po4a-stamp>. Os ficheiros de informação são sempre utilizados se existirem e são removidos com B<--rm-translations> ou quando o ficheiro é finalmente traduzido.

note: type: textblock
en: Do not generate the translated documents, only update the POT and PO files.
pt: Não gerar os documentos traduzidos, apenas atualizar os ficheiros POT e PO.

note: type: textblock
en: Do not change the POT and PO files, only the translation may be updated.
pt: Não altere os ficheiros 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: Mantém os ficheiros de tradução existentes mesmo se a tradução não atingir o limite especificado por B<--keep>.  Essa opção não cria ficheiros de tradução com pouco conteúdo, mas vai gravar traduções existentes que cujo nível decai devido a alterações nos ficheiros 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: ATENÇÃO: esta opção muda o comportamento do po4a de uma maneira bastante drástica: os seus ficheiros traduzidos não serão atualizados até que a tradução melhore. Use esta opção somente se 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: Remover os ficheiros traduzidos (implica B<--no-translations>).

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

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: Traduzir apenas o ficheiro especificado. Pode ser útil para acelerar o processamento se um ficheiro de configuração contém muitos ficheiros. Note que o que esta opção faz não é possível atualizar ficheiros PO e POT. Esta opção pode ser usada várias vezes.

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: Definir uma variável que será expandida no ficheiro de configuração B<po4a>.Cada ocorrência de I<$(var)> será substituída por I<value>. Esta opção pode ser usada várias vezes.

note: type: textblock
en: Set the base directory for all input documents specified in the B<po4a> configuration file.
pt: Definir o diretório de base para todos os documentos de entrada especificados no ficheiro de configuração 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: Se I<destdir> e I<srcdir> forem especificados, os ficheiros de entrada serão pesquisados nos diretórios seguintes, em ordem: I<destdir>, o diretório atual e I<srcdir>. Os ficheiros de saída são gravados em I<destdir>, se forem especificados, 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: Definir o diretório base para todos os documentos de saída especificados no ficheiro de configuração B<po4a> (veja B<--srcdir> acima).

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

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: 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 ficheiro sem o número da linha, B<counter> para substituir os números de linha a aumentar o contador e B<full> para incluir referências completas. (predefinição: full).

note: type: =item
en: B<--wrap-po> B<no>|B<newlines>|I<number> (default: 76)
pt: B<--wrap-po> B<no>|B<newlines>|I<number> (predefiniçã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: Especifica como o ficheiro po deve ter a quebra de linha. Isso permite escolher entre ficheiros que tem boa quebra de linha, mas que podem levar a conflitos de git ou ficheiros 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: Historicamente, o pacote gettext reformatou os ficheiros po na 77ª coluna para questões cosméticas. Esta opção especifica o comportamento de po4a. Se for definido como um valor numérico, o po4a quebrará linha do ficheiro po após esta coluna e após novas linhas no conteúdo. Se for definido como B<newlines>, o po4a dividirá apenas o msgid e o msgstr após as novas linhas no conteúdo. Se for definido como B<no>, o po4a não quebrará linha do ficheiro po. Os comentários de referência têm sempre as linhas quebradas pelas ferramentas do gettext que 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: 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 cadeias.

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: Idioma dos ficheiros fonte que contêm os documentos a traduzir. Note que todos os documentos principais devem usar o mesmo idioma.

note: type: =item
en: B<--msgid-bugs-address> I<email@address>
pt: 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: Definir o endereço do relatório para msgid bugs. Por predefinição, os ficheiros POT criados não têm campos 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: Definir o titular dos direitos de autor no cabeçalho POT. O valor predefinido é " Free Software Foundation, Inc."

note: type: textblock
en: Set the package name for the POT header. The default is "PACKAGE".
pt: Definir o nome do pacote para o cabeçalho POT. A predefinição é "PACKAGE".

note: type: textblock
en: Set the package version for the POT header. The default is "VERSION".
pt: Definir o nome do pacote para o cabeçalho POT. A predefinição é "VERSION".

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

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

note: type: textblock
en: Note: B<$lang> will be extended to the current language.
pt: Nota: B<$lang> será estendida ao 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: Esta opção remove B<--previous> a partir das opções passadas para B <msgmerge> Isto é necessário para suportar versões do B<gettext> mais cedo do que 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: Esta opção acrescenta B<--previous> ás opções passadas para B<msgmerge>. Isso requer B<gettext> 0.16 ou posterior e é ativado por predefinição.

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

note: type: textblock
en: The path to the PO files and the list of languages existing in the project;
pt: O caminho aos ficheiros 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: Opcionalmente, algumas opções globais e os chamados aliases de configuração que são usados como modelos para configurar ficheiros mestres individuais ;

note: type: textblock
en: The list of each master file to translate, along with specific parameters.
pt: A lista de cada ficheiro 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: Todas as linhas contêm um comando entre colchetes, seguido pelos seus parâmetros.  Os comentários começam com o caractere "#" e correm até ao fim da linha. 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: Alguns exemplos completos são apresentados nesta página, enquanto outros exemplos encontram-se no diretório C<t/cfg> da distribuição fonte.

note: type: =head2
en: Finding the PO and POT files
pt: Encontrar os ficheiros PO e POT

note: type: textblock
en: The simplest solution is to explicitly give the path to POT and PO files, as follows:
pt: A solução mais simples é fornecer o caminho aos ficheiros POT e PO, da maneira seguinte:

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: Isto especifica o caminho ao ficheiro POT primeiro e, em seguida, os caminhos aos ficheiros PO alemães e francêses.

note: type: textblock
en: The same information can be written as follows to reduce the risk of copy/paste errors:
pt: A mesma informação pode ser escrita da seguinte forma para reduzir o risco de erros de cópia/colagem:

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: O componente C<$lang> é expandido automaticamente a usar a lista de idiomas fornecidos, a reduzir 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: Pode compactar ainda mais as mesmas informações a fornecer apenas o caminho ao diretório que contém o seu projeto de tradução, como 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: O diretório fornecido deve conter um conjunto de ficheiros PO, cada um chamado F<XX.po>, o C<XX> a ser o ISO 631-1 do idioma utilizado neste ficheiro. O diretório também deve conter um único ficheiro POT, com a extensão C<.pot> file. Para a primeira execução, este ficheiro pode estar vazio, mas deve existir (po4a não pode adivinhar o nome a usar 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: Note que deve escolher apenas um de C<po_diretório> e C<po4a_caminhos>. O primeiro (C<po_directório>) é mais compacto, reduz ainda mais o risco de erro de copiar/colar, mas obriga-o a usar a estrutura de projeto e os nomes de ficheiro esperados. O segundo (C<po4a_paths>) é mais explícito, provavelmente mais legível e é aconselhado quando configura o seu primeiro projeto com o po4a.

note: type: =head3
en: Centralized or split PO files?
pt: Ficheiros 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: Por predefinição, o po4a produz um único ficheiro PO por idioma de destino, a conter todo o conteúdo do seu projeto de tradução. Conforme o seu projeto cresce, o tamanho desses ficheiros pode tornar-se 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 equipas de tradução preferem dividir o conteúdo em vários ficheiros.

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: Para ter um ficheiro PO por ficheiro mestre, basta usar a cadeia C<$master> no nome dos ficheiros PO na linha C<[po4a_paths]>, da maneira seguinte.

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: No modo split, B<po4a> constrói um compêndio temporário durante a atualização do PO, para compartilhar as traduções entre todos os ficheiros do PO. Se dois ficheiros PO tiverem traduções diferentes para a mesma cadeia, B<po4a> marcará esta cadeia como difusa e enviará ambas as traduções em todos os ficheiros PO a conter esta cadeia. Quando o tradutor não se deixa abater, a tradução é automaticamente utilizada em todos os ficheiros PO.

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

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: 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 a usar o modelo C<$lang> da maneira seguinte:

note: type: =head2
en: Specifying options
pt: Especificar 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: Há dois tipos de opções: I<opções do po4a> são valores predefinidos 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>, pode, por exemplo, especificar no seu ficheiro de configuração que o valor predefinido 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)>. Pode, por exemplo, passar B<nostrip> para o analisador XML para não remover os espaços ao redor das cadeias 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: Pode passar essas opções a um ficheiro mestre específico ou mesmo a uma tradução específica desse ficheiro, a usar C<opt:> e C<opt_XX:> para o idioma C<XX>. No exemplo a seguir, a opção B<nostrip> é passada ao analisador XML (para todos os idiomas), enquanto o limite será reduzido a 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: De qualquer forma, esses blocos de configuração devem estar localizados no final da linha. A declaração dos ficheiros 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 cadeias. 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: Observe que as opções específicas do idioma não são usadas ao criar o ficheiro POT. Por exemplo, é impossível passar B<nostrip> para o analisador apenas ao criar a tradução em francês, porque o mesmo ficheiro 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: 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: Para passar as mesmas opções para vários ficheiros, o melhor é definir um alias de tipo da maneira seguinte. No próximo exemplo, C<--keep 0> é passado para todas as traduções em italiano a usar 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: Também pode estender um tipo existente de reutilizar o mesmo nome ao alias da forma seguinte. Este não é interpretada como uma errônea definição recursiva.

note: type: =head3
en: Global default options
pt: Opções predefinidas 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: Também pode usar as linhas C<[options]> para definir opções que devem ser usadas para todos os ficheiros, independentemente do tipo dele.

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

note: type: =head3
en: Option priorities
pt: 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: As opções de todas as fontes são concatenadas, a garantir que os valores predefinidos 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: As linhas C<[options]> fornecem valores predefinidos 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: 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: As configurações específicas de um determinado ficheiro mestre substituem as predefinidas e as provenientes do alias de tipo. Neste caso, as configurações específicas do idioma também substituem as globais.

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

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

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

note: type: =head2
en: Addendum: Adding extra content in the translation
pt: Adendo: adicionar conteúdo 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: Se deseja adicionar uma secção adicional à tradução, por exemplo, para dar mérito ao tradutor, é necessário definir um adendo à linha que define o seu ficheiro mestre. Consulte a página L<po4a(7)> para obter mais detalhes sobre a sintaxe dos ficheiros de adendo.

note: type: textblock
en: You can also use language templates as follow:
pt: Também pode usar modelos de idioma da maneira seguinte:

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

note: type: =head3
en: Modifiers for the addendum declaration
pt: 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: Os modificadores de adendo podem simplificar o ficheiro de configuração no caso em que nem todos os idiomas fornecem um adendo ou quando a lista de adendos muda de um idioma ao outro. O modificador é um único caractere localizado antes do nome do ficheiro.

note: type: textblock
en: Include I<addendum_path> if this file does exist, otherwise do nothing.
pt: Incluir I<addendum_path> se este ficheiro existir, caso contrário não fazer nada.

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: I<addendum_path> não é uma adenda regular, mas um ficheiro a conter uma lista de adendas, uma por linha. Cada adenda pode ser precedida de 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: I<addendum_path> é descartado, não é carregado e não será carregado por qualquer especificação de adenda.

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: O seguinte inclui um adendo em qualquer idioma, mas só 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: O seguinte inclui uma lista de adendos para cada idioma:

note: type: =head2
en: Filtering the translated strings
pt: Filtrar as cadeias 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: Às vezes, deseja ocultar algumas cadeias do processo de tradução. Nesse sentido, pode atribuir um parâmetro C<pot_in> ao seu ficheiro mestre para especificar o nome do ficheiro a ser usado em vez do mestre real ao criar o ficheiro 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: Com essa configuração, as cadeias a serem traduzidas serão extraídas do F<book-filter.xml> (que deve ser produzido antes da chamada de B<po4a>) enquanto os ficheiros traduzidos serão compilados do F<book.xml>. Como resultado, qualquer cadeia que faça parte de F<book.xml>, mas não em F<book-filter.xml> não será incluída nos ficheiros PO, a impedir que os tradutores forneçam uma tradução para eles. Portanto, essas cadeias não serão modificadas ao produzir os documentos traduzidos. Isso naturalmente diminui o nível de tradução, portanto, pode precisar da opção C<--keep> para garantir que o documento seja produzido de qualquer maneira.

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

note: type: =head1
en: COPYRIGHT AND LICENSE
pt: DIREITOS DE AUTOR E LICENÇA

note: type: textblock
en: po4a-gettextize - convert an original file (and its translation) to a PO file
pt: po4a-gettextize - converte um ficheiro original (e a tradução dele) para um ficheiro PO

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

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: O formato da documentação que pretende processar. 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: Ficheiro que contem o documento principal para traduzir. Pode usar esta opção várias vezes se quiser 'gettextize' vários documentos.

note: type: textblock
en: Charset of the file containing the document to translate.
pt: Conjunto de carateres do ficheiro que contém o documento a 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: Ficheiro que contem o documento localizado (traduzido). Se forneceu ficheiros mestres múltiplos, pode fornecer múltiplos ficheiros localizados a usar esta opção mais de uma vez.

note: type: textblock
en: Charset of the file containing the localized document.
pt: Conjunto de carateres do ficheiro que contém 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: Ficheiro onde o catálogo de mensagens deve ser escrito. Se não for dado, a mensagem catálogo será escrito na saída predefinido.

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

note: type: =head2
en: Converting a manual translation to po4a
pt: Converter a tradução manual para po4a

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

note: type: verbatim
en:   chapter            chapter
        paragraph          paragraph
        paragraph          paragraph
        paragraph        chapter
      chapter              paragraph
        paragraph          paragraph
pt:   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: 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: 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 ficheiro 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: Algumas vezes, o conteúdo do parágrafo não corresponde, mas tipos deles não. Corrigir isso é até dependente do formato. No POD e man, frequentemente vem do fato que um deles contém uma linha a começar com espaço em branco, mas 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: Da mesma forma, dois parágrafos podem ser mesclados num 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: po4a-normalize - normalizar um ficheiro de documentação, a analisar-o em po4a e escrevê-lo de volta

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

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: O script B<po4a-normalize> é uma ferramenta de depuração usada para se certificar de que o po4a não altera o documento quando não deveria. Usá-lo apenas se estiver no desenvolvimento de um novo módulo, ou se duvidar 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: O documento gerado será escrito em F<po4a-normalize.output> enquanto o ficheiro POT gerado será escrito em F<po4a-normalize.po> por predefinição, mas pode usar as opções B<--localized> e B<--pot> para mudá-lo.

note: type: textblock
en: Create a blank translated document.  The generated translated document will be generated assuming all messages are translated by a space or new line.
pt: Criar um documento em branco traduzido. O documento gerado traduzido vai ser gerado a assumir que todas as mensagens sã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: isto é útil para verificar que partes do documento não podem ser traduzidas.

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

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

note: type: textblock
en: po4a-translate - convert a PO file back to documentation format
pt: po4a-translate - converter um ficheiro PO de volta ao formato de documentação

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

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: O script B<po4a-translate> é responsável por converter a tradução (que foi feita num ficheiro PO) de volta para o formato de documentação. O ficheiro PO fornecido deverá ser a tradução do ficheiro POT que foiproduzido 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: Adicionar um ficheiro ao ficheiro resultante (para pôr o nome do tradutor ou uma secção "Sobre esta tradução", por exemplo). A primeira linha do ficheiro para inserção deve ser um cabeçalho PO4A a indicar onde ele deve ser adicionado (ver secção B<COMO adicionar texto extra para traduções> em L<po4a(7)>).

note: type: textblock
en: File containing the master document to translate.
pt: Ficheiro a conter o documento principal para traduzir.

note: type: textblock
en: File where the localized (translated) document should be written.
pt: Ficheiro onde o documento localizado (traduzido) deve ser escrito.

note: type: textblock
en: File from which the message catalog should be read.
pt: Ficheiro a partir do qual o catálogo de mensagens deve 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: Limite mínimo de percentagem de tradução para manter (p.ex. escrever) o ficheiro resultante (predefinição: 80). P.ex. por predefinição, ficheiros têm que ser traduzido a pelo menos 80% para serem escritos.

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: O argumento pode ser seguido por uma vírgula ou pela palavra-chave B<wrap> ou B<nowrap>. Referências são escritas por predefinição numa única linha. A opção B<wrap> envolve referências sobre várias linhas, para imitar as ferramentas B<gettext> (B<xgettext> e B<msgmerge>). Esta opção irá tornar-se a predefinição num lançamento futuro, porque é mais sensível. A opção B<nowrap> é acessível aos utilizadores que querem manter o comportamento antigo.

note: type: =head1
en: Adding content (beside translations) to generated files
pt: A adição de conteúdo (ao lado das traduções) para ficheiros 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: Para adicionar algum conteúdo extra ao documento gerado além do que traduziu (como o nome do tradutor ou uma secção "Sobre essa tradução"), 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: A primeira linha da adenda deve ser um cabeçalho a indicar onde colocá-lo no documento (que pode ser antes ou depois de uma determinada parte do documento). O resto do ficheiro será adicionado na íntegra para o ficheiro resultante sem processamento posterior.

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: Note que se po4a-translate não conseguir adicionar um dos ficheiros dados, ele descarta toda a tradução (porque o ficheiro que falta poderia ser o que indica o autor, o que impediria aos utilizadores o contato com ele 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: O cabeçalho tem uma sintaxe bastante rígida. Para mais informações sobre como usar esse recurso e como ele funciona, consulte a página do manual L<po4a(7)>.

note: type: textblock
en: po4a-updatepo - update the translation (in PO format) of documentation
pt: po4a-updatepo - atualizar a tradução de documentação (em formato PO)

note: type: textblock
en: (I<XX.po> are the outputs, all others are inputs)
pt: (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: O script B<po4a-updatepo> é encarregado de atualizar ficheiros PO para faze-los refletir as alterações feitas no ficheiro de documentação original. Para isso, converte o ficheiro de documentação num ficheiro POT e invoca L<msgmerge(1)> neste novo POT e nos ficheiros 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: É possível dar mais do que um ficheiro PO (se quiser atualizar vários idiomas de uma só vez) e alguns ficheiros de documentação (se deseja armazenar as traduções de diversos documentos no mesmo ficheiro 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: Se a documentação mestre possui caracteres não-ASCII, este script vai converter os ficheiros 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: Ficheiro(s) a conter o documento principal 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: Conjunto de carateres dos ficheiros a conter o documento a traduzir. Note que todos os ficheiros devem ter o mesmo conjunto de carateres.

note: type: textblock
en: PO file(s) to update. If these files do not exist, they are created by B<po4a-updatepo>.
pt: Ficheiro(s) PO para atualizar. Se esses ficheiros não existirem, são criados por B<po4a-updatepo>.

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: Historicamente, o pacote gettext reformatou os ficheiros 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 ficheiro 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á linhas no ficheiro po. A quebra de linha dos comentários de referência é controlado pela opção B<--porefs>.

note: type: textblock
en: msguntypot - update PO files when a typo is fixed in POT file
pt: msguntypot - atualização de ficheiros PO quando um erro de digitação foi corrigido no ficheiro POT

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: Quando corrigir um erro trivial, que certamente não afeta as traduções (p.ex. um erro ortográfico) num ficheiro POT, deve precisar a mensagem traduzida correspondente nos ficheiros PO traduzidos para evitar o trabalho adicional 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: Esta tarefa é difícil e sujeita a erros quando feita manualmente e esta ferramenta existe para ajudar a fazê-lo corretamente. Só precisa fornecer as duas versões do ficheiro POT: antes da edição e depois marcada como na sinopse abaixo e tudo se será automático.

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

note: type: textblock
en: In short, when you discover a typo in one of your [english] message, do the following:
pt: Em suma, quando encontrar um erro de digitação numa das suas mensagens [Inglês], faça o seguinte:

note: type: =item
en: - Regenerate your POT and PO files.
pt: - Regenerar os seus ficheiros POT e PO.

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:   make -C po/ update-po # para traduções de programas de mensagem
      debconf-updatepo      # para traduções debconf
      po4a po4a.conf        # para traduções de documentos de base 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: Ou outra coisa, a depender das configurações de compilação do seu projeto. Sabe como certificar-se de que os seus ficheiros POT e PO estão atualizados, não é??

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

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

note: type: verbatim
en:   mkdir po_fridge; cp *.po po_fridge
pt:   mkdir po_frigorífico; cp *.po po_frigorífico

note: type: =item
en: - Fix your typo.
pt: - Corrigir o seu erro de ortografia.

note: type: textblock
en: $EDITOR the_file_in_which_there_is_a_typo
pt: $EDITOR o_ficheiro_que_contém_um_erro_tipográfico

note: type: textblock
en: See above.
pt: Ver 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: Neste ponto, o erro de digitação corrigido imprecisa todas as traduções e esta lamentável mudança, é a única entre os ficheiros PO do seu diretório principal e um estável. Aqui está como resolver isso.

note: type: =item
en: - Discard fuzzy translation, restore the ones from the fridge.
pt: - Descarte tradução imprecisa, restaurar os estáveis.

note: type: verbatim
en:   cp po_fridge/*.po .
pt:   cp po_frigorífico/*.po .

note: type: =item
en: - Manually merge the PO files with the new POT file, but taking the useless fuzzy into account.
pt: - Manualmente fundir os ficheiros PO com o novo ficheiro POT, mas a ter o inútil e impreciso em conta.

note: type: verbatim
en:   msguntypot -o myfile.pot.orig -n myfile.pot *.po
pt:   msguntypot -o meuficheiro.pot.orig -n meuficheiro.pot *.po

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

note: type: verbatim
en:   rm -rf myfile.pot.orig po_fridge
pt:   rm -rf meuficheiro.pot.orig po_frigorífico

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: Está feito. O erro de digitação foi erradicado das mensagens traduzidas de ambos os seus ficheiros POT e PO e os ficheiros PO não foram imprecisos no processo. Os seus tradutores já o adoram.

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: Apesar do nome, esta ferramenta não é parte do conjunto de ferramentas gettext. É em vez de parte po4a. Mais precisamente, é um script aleatório em Perl a usar módulos finos po4a. Para mais informações sobre po4a, consulte:

note: type: textblock
en: Copyright 2005 by SPI, inc.
pt: Direitos de Autor 2005 por SPI, inc.

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

note: type: =head1
en: Introduction
pt: 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: po4a (PO for anything) facilita a manutenção da traduções de documentação a usar as ferramentas gettext clássicas. A característica principal do po4a é que dissocia a tradução do conteúdo da estrutura documental dele.

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: Este documento serve como uma introdução ao projeto po4a, com foco nos utilizadores em potencial, a considerar 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: 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: A filosofia do Software Livre é fazer a tecnologia verdadeiramente disponível a todos. Mas o licenciamento não é a única consideração: software livre não traduzido é inútil para quem não fala inglês. Portanto, ainda temos algum trabalho a fazer para fazer o software disponível a 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: 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: Felizmente, o software Open Source é, na verdade, muito bem traduzido a usar o conjunto de ferramentas gettext. Essas ferramentas são usadas para extrair as cadeias a traduzir de um programa e apresentar as cadeias a traduzir num formato padronizado (chamado de ficheiros PO ou catálogos de tradução). Todo um ecossistema de ferramentas surgiu para ajudar os tradutores a realmente traduzir esses ficheiros PO. O resultado é então utilizado pela gettext em tempo de execução para exibir as mensagens traduzidas para os utilizadores finais.

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: Traduções desatualizadas geralmente são piores do que nenhuma tradução. Os utilizadores 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 a documentação deles está traduzida. Essas dificuldades, muitas vezes causadas por ferramentas precárias, podem minar a motivação de tradutores voluntários, a agravar o problema ainda mais.

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: B<O objetivo do projeto po4a é facilitar o trabalho dos tradutores de documentação>. Em particular, torna I<manter> traduções de documentações possível.

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: A ideia é de reutilizar e adaptar a abordagem gettext a esse campo. Assim como o gettext, os textos são extraídos dos 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 equipa. O po4a injeta as traduções diretamente na estrutura da documentação para produzir ficheiros de origem traduzidos que podem ser processados e distribuídos da mesma forma que os ficheiros em inglês. Qualquer parágrafo que não seja traduzido é deixado em inglês no documento resultante, a garantir que os utilizadores 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: Isso automatiza a maior parte do trabalho pesado da manutenção da tradução. A descoberta dos parágrafos que precisam de atualização torna-se 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 hipótese de erros de formatação que resultariam num 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: Por favor, consulte também o B<FAQ> abaixo neste documento para uma lista mais completa das vantagens e desvantagens desta abordagem.

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

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

note: type: =item
en: man (mature parser)
pt: 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: O bom e velho formato de páginas de manual, usado por muitos programas por aí. Suporte do po4a é muito bem-vindo, a considerar que esse formato é de certa forma difícil de usar e não mesmo 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: O módulo L<Locale::Po4a::Man(3pm)|Man> também possui suporte do 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: 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: Esse formato é um formato de markup 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 a usar po4a.

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

note: type: =item
en: pod (mature parser)
pt: 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: Este é o formato de Documentação Perl Online. A linguagem e as próprias extensões são documentadas a usar este formato, além da maioria dos scripts Perl existentes. Torna fácil manter a documentação perto do código real, a incorpora-los ambos no mesmo ficheiro. Torna a vida do programador mais fácil, mas infelizmente não a do tradutor, até que use o po4a.

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

note: type: =item
en: sgml (mature parser)
pt: 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: Mesmo que hoje em dia seja substituído pelo XML, este formato ainda é utilizado para documentos com o comprimento de mais do que alguns ecrãs. Pode até mesmo ser usado para livros inteiros. Pode ser muito desafiador de atualizar documentos deste tamanho. B<diff> frequentemente revela-se inútil quando o texto original foi reintroduzido após a atualização.  Felizmente, o po4a pode ajudá-lo após esse 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: Atualmente, apenas o DebianDoc e DocBook são suportados, mas a acrescentar suporte para um novo, é muito simples. É até possível usar po4a num SGML DTD desconhecido sem alterar o código, a fornecer as necessárias informações sobre a linha de comando. Veja L<Locale::Po4a::Sgml(3pm)> para obter mais detalhes.

note: type: =item
en: TeX / LaTeX (mature parser)
pt: 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: O formato LaTeX é o formato de documentação principal usado nas publicações de Software Livre mundiais.

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

note: type: =item
en: text (mature parser)
pt: 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: O formato Text é of formato base para muitos formatos que incluem longos blocos de texto, incluindo Markdown, fortunes, secçã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: Este possui suporte do 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: xml e XHMTL (analisador provavelmente maduro)

note: type: textblock
en: The XML format is a base format for many documentation formats.
pt: O formato XML é um formato de 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: Atualmente, o DocBook DTD (veja L<Locale::Po4a::Docbook(3pm)> para detalhes) e o XHTML são suportados pelo po4a.

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

note: type: textblock
en: The BibTex format is used alongside LaTex for formatting lists of references (bibliographies).
pt: 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: Veja L<Locale::Po4a::BibTex> para detalhes.

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

note: type: textblock
en: A XML-based markup language that uses semantic tags to describe documents.
pt: 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: Veja L<Locale::Po4a:Docbook> para mais detalhes.

note: type: =item
en: Guide XML (probably mature parser)
pt: 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: 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: Veja L<Locale::Po4a:Guide> para mais detalhes.

note: type: =item
en: Wml (probably mature parser)
pt: 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: 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: Veja L<Locale::Po4a::Wml> para mais detalhes.

note: type: =item
en: Yaml (probably mature parser)
pt: 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: 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: Veja L<Locale::Po4a::Yaml> para mais detalhes.

note: type: =item
en: RubyDoc (probably mature parser)
pt: 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: 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: Veja L<Locale::Po4a::RubyDoc> para mais detalhes.

note: type: =item
en: Halibut (probably experimental parser)
pt: 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: Um sistema de produção de documentação, com elementos semelhantes ao TeX, debiandoc-sgml, TeXinfo e outros, desenvolvido por Simon Tatham, o programador do PuTTY.

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

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

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

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

note: type: =item
en: texinfo (very highly experimental parser)
pt: 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: Toda a documentação GNU está escrita neste formato (ainda é um dos requisitos para um projeto GNU se tornar oficial). O apoio para L<Locale::Po4a::Texinfo(3pm)|Texinfo> em po4a ainda está no início. Por favor, reporte erros e solicitações de recursos.

note: type: =item
en: Others supported formats
pt: Outros formatos suportados

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: 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 o seu formato alvo. Veja L<Locale::Po4a::TransTractor(3pm)> para mais informações sobre isso.

note: type: =item
en: Unsupported formats
pt: Formatos não suportados

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: Infelizmente, o po4a ainda carece suporte para vários formatos de documentação. Muitos deles facilmente seriam suportados pelo po4a. Isto inclui formatos não apenas usados para documentação, tais como, descrições de pacotes (deb e rpm), questões de scripts de instalação de pacotes, changelogs de pacotes e todos os formatos de ficheiros especializados usados por programas como cenários de jogos ou ficheiros de recursos do wine.

note: type: =head1
en: Using po4a
pt: Usar o po4a

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: 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 leva um documento original e o equivalente traduzido e tenta construir o ficheiro 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 as suas traduções existentes. Se não tiver nenhuma tradução para converter, pode esquecer-se disto e focar na parte certa do esquema.

note: type: =head2
en: Using addenda to add extra text to translations
pt: Usando adendos para adicionar textos à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: Adicionar novos textos à tradução é provavelmente a única coisa mais fácil a longo prazo quando traduz ficheiros manualmente :). Isso acontece quando deseja adicionar uma secção adicional ao documento traduzido, que não corresponde a nenhum conteúdo no documento original. O caso de uso clássico é dar mérito à equipa 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: Com o po4a, é necessário especificar os ficheiros B<addendum>, que podem ser vistos conceitualmente como patches aplicados ao documento localizado após o processamento. Cada adendo deve ser fornecido como um ficheiro separado, cujo formato é, no entanto, muito diferente dos patches clássicos. A primeira linha é uma I<linha de cabeçalho>, a definir o ponto de inserção do adendo (com uma sintaxe infelizmente enigmática -- veja abaixo) enquanto o restante do ficheiro é 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: A linha do cabeçalho deve começar com a cadeia 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: Por exemplo, o cabeçalho a seguir declara um adendo que deve ser posto 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: As coisas ficam mais complexas quando deseja adicionar o seu conteúdo adicional no meio do documento. O cabeçalho a seguir declara um adendo que deve ser posto após a secção XML que contém a cadeia C<Sobre este documento> na tradução.

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: 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 se esqueça que o po4a considera o documento B<translated> aqui. Esta documentação é em inglês, mas a sua linha provavelmente deve ser a seguinte, se pretende que o seu adendo se aplique à tradução do documento em francês.

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: Depois que a C<position> foi 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 secção atual).

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

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

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:   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 ficheiro

note: type: =head3
en: Hint and tricks about addenda
pt: 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: Lembre-se que estes são regexp. Por exemplo, se quiser combinar o final de uma secção nroff a terminar com a linha C<.fi>, não use C<.fi> como B<endboundary>, porque ele irá combinar com C<the[ fi]le>, que obviamente não é o que espera. O B<endboundary> correto, nesse 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: 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 suficientes à direita 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:  PO4A-HEADER: position=Acerca deste documento; mode=after; beginboundary=<section>
     PO4A-HEADER: position=Acerca deste 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: Embora essa pesquisa de contexto possa ser a operar cerca de cada linha do documento B<traduzido>, realmente opera na cadeia de dados interna do documento traduzido. Essa cadeia de dados interna pode ser um texto a abranger um parágrafo que contem várias linhas ou pode ser uma marcação 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: =head3
en: Addenda examples
pt: Exemplos de adendos

note: type: textblock
en: If you want to add something after the following nroff section:
pt: Se quiser acrescentar algo depois na secção seguinte nroff:

note: type: verbatim
en:   .SH "AUTHORS"
pt:   .SH "AUTORES"

note: type: verbatim
en:  PO4A-HEADER:mode=after;position=AUTHORS;beginboundary=\.SH
pt:  PO4A-HEADER:mode=after;position=AUTORES;beginboundary=\.SH

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: Se quiser adicionar algo logo após uma determinada linha (por exemplo, após a linha "Copyright Big Dude"), use uma B<position> a corresponder a esta linha, B<mode=after> e dê um B<beginboundary> a corresponder a qualquer linha.

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: Se quiser adicionar alguma coisa no final do documento, dê uma B<position> correspondente a qualquer linha do seu documento (mas apenas uma linha, po4a não continuará se não é única) e dê uma B<endboundary> sem corresponder a nada. Aqui não use cadeias simples como B<"EOF">, mas prefira as que têm menos hipótese estar no seu documento.

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

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

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

note: type: verbatim
en:  |=head1 NAME
     |
     |dummy - a dummy program
     |
     |=head1 AUTHOR
     |
     |me
pt:  |=head1 NOME
     |
     |fictício - um programa fictício
     |
     |=head1 AUTOR
     |
     |eu

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: Então, a adenda a seguir irá garantir que uma secção (em francês) sobre o tradutor é adicionado no final do processo (em francês, "TRADUCTEUR" significa "tradutor" e, "moi" significa "eu").

note: type: verbatim
en:  |PO4A-HEADER:mode=after;position=AUTEUR;beginboundary=^=head
     |
     |=head1 TRADUCTEUR
     |
     |moi
     |
pt:  |PO4A-HEADER:mode=after;position=AUTOR;beginboundary=^=head
     |
     |=head1 TRADUTOR
     |
     |eu
     |

note: type: textblock
en: To put your addendum before the AUTHOR, use the following header:
pt: Para posicionar a sua adenda antes do AUTOR, use o seguinte cabeçalho:

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

note: type: =head1
en: How does it work?
pt: Como é que funciona?

note: type: =head1
en: Open-source projects using po4a
pt: 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: Aqui está uma lista bem parcial de projetos que usam po4a na produção para a documentação deles. Se quiser adicionar o 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: adduser (man): ferramenta de gestão de utilizadores e grupos.

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

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

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: 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: 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: 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: 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: Outro item para resolver: L<https://gitlab.com/fdroid/fdroid-website/> L<https://github.com/fsfe/reuse-docs/pull/61>

note: type: =head1
en: FAQ
pt: PERGUNTAS MAIS FREQUENTES

note: type: =head2
en: How do you pronounce po4a?
pt: Como se 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: Pessoalmente vocalizo-o como L<pouah|https://en.wiktionary.org/wiki/pouah>, que é um onomatopaico francês que usamos no lugar de "eca" :) posso ter um senso de humor estranho :)

note: type: =head2
en: What about the other translation tools for documentation using gettext?
pt: E sobre as outras ferramentas de tradução para documentação a usar 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: Esta é a ferramenta desenvolvida por pessoas do KDE para lidar com DocBook XML. AFAIK, ele foi o primeiro programa para extrair cadeias para traduzir de documentação para ficheiros PO e injetá-las de volta depois de 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: Só pode lidar com XML e apenas um DTD particular. Estou muito descontente com a manipulação de listas, que terminam com um identificador de mensagem (msgid) grande. Quando a lista se torna enorme, o bloco torna-se mais difícil de absorver.

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: Este programa feito por Denis Barbier é uma espécie de precursor do módulo po4a SGML, que mais ou menos o despreza. Como o nome diz, ele trata apenas o DebianDoc DTD, que é mais ou menos 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: As principais vantagens de po4a sobre eles, são a facilidade de adição de conteúdos extra (que é pior ainda lá) e a capacidade de atingir gettextization.

note: type: =head2
en: SUMMARY of the advantages of the gettext based approach
pt: SUMÁRIO de vantagens da aproximação de base ao 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: As traduções não são armazenadas com o original, o que torna possível detetar 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: As traduções estão armazenadas em ficheiros separados a partir de cada um, o que previne os tradutores de idiomas diferentes de intervirem, em ambos, quando submetem os seus fragmentos (patches) e no nível do ficheiro codificado.

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: É baseado em B<gettext> (mas B<po4a> oferece uma interface muito simples assim não precisa de compreender os internos para o usar). Dessa forma não precisamos de reinventar a roda e, porque o uso dele é mundial, podemos pensar que estas ferramentas estão mais ou menos livres de 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: Nada muda para o utilizador final (além do fato das traduções serem, como esperamos, melhor mantidas). O ficheiro de documentação resultante é 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: Os tradutores não precisam de aprender a nova sintaxe de ficheiros e os editores de ficheiros PO favoritos deles (como o modo PO do Emacs, Lokalize ou Gtranslator) irão trabalhar 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: gettext oferece uma maneira simples de obter estatísticas acerca do que é feito, o que deveria ser revisto e atualizado e, o que ainda está por fazer. Alguns exemplos encontram-se nestes endereços:

note: type: verbatim
en:  - https://docs.kde.org/stable5/en/kdesdk/lokalize/project-view.html
     - http://www.debian.org/intl/l10n/
pt:  - 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: Mas não é tudo verde e, esta aproximação tem também algumas desvantagens com que temos de lidar.

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: Não pode adaptar o texto traduzido as suas preferências, como a dividir um parágrafo aqui e, a juntar outros dois ali. Mas em certo sentido, se existe um problema com o original, deve ser reportado como um erro de qualquer maneira.

note: type: textblock
en: Even with an easy interface, it remains a new tool people have to learn.
pt: Mesmo com um interface fácil, continua a ser ferramenta nova que as pessoas têm que 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: Um dos meus sonhos seria integrar de alguma forma po4a ao Gtranslator ou Lokalize. Quando um ficheiro de documento fosse aberto, as cadeias seriam automaticamente extraídas e um ficheiro traduzido + ficheiro po poderia ser gravado no disco. Se 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: A documentação da ferramenta multifuncional que 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: 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: 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: Os analisadores de cada formato, particularmente 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: 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 ficheiro F<CONTRIBUTING.md> na árvore de fonts.

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

note: type: textblock
en: Locale::Po4a::AsciiDoc is a module to help the translation of documentation in the AsciiDoc format.
pt: 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: OPÇÕES ACEITES POR ESTE MÓDULO

note: type: textblock
en: These are this module's particular options:
pt: Estas são as opções particulares 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: O nome de um ficheiro que contém as definições para po4a, como definido na secção B<INLINE CUSTOMIZATION>. Pode usar esta opção se não é possível pôr as definições no documento a ser traduzido.

note: type: textblock
en: In a definitions file, lines must not start by two slashes, but directly by B<po4a:>.
pt: Num ficheiro 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: Lista separada por espaços das entradas de atributos que deseja traduzir.  Por predefinição, nenhuma entrada de atributo é traduzida.

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

note: type: textblock
en: Space-separated list of style definitions.
pt: 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: Ativar a quebra de linha automática 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: Por defeito, o po4a não quebra os ficheiros AsciiDoc produzidos, porque uma inspeção manual é necessária para garantir que a quebra não altera 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:  * uma frase comprida, 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: Se o embrulho levar à seguinte apresentação, o item é dividido numa sublista numerada. Para piorar a situação, apenas os falantes do idioma utilizado 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:  * uma frase comprida que termina 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: Note que não embrulhar os ficheiros produzidos pelo po4a não deve ser um problema, uma vez que esses ficheiros devem ser processados automaticamente.  Eles não devem ser considerados como ficheiros fonte de qualquer forma.

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: Por predefiniçã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 a configurar 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: Esta opção é um sinalizador que permite a segmentação de subtabelas em conteúdo das células.  A segmentação é limitada ao conteúdo telemóvel, sem qualquer análise dentro dele.

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: Muda as regras de análise para compatibilidade com ferramentas diferentes. 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: 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: Não traduz os valores de vetor na secção YAML Front Matter.

note: type: =head1
en: INLINE CUSTOMIZATION
pt: INLINE CUSTOMAZITION

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: O módulo AsciiDoc pode ser personalizado com linhas a começar 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: 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: 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: 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: Se um sinal de mais (B<+>) é prefixo de I<nome>, então a macro e os argumentos dele 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: 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: 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: 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: 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: 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: B<//po4a: entrada >I<nome>

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

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

note: type: textblock
en: Tested successfully on simple AsciiDoc files.
pt: Testado com sucesso em ficheiros 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:  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: Locale::Po4a::BibTeX - converter documentos BibTeX de/para ficheiros 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: Locale::Po4a::BibTeX é um módulo para ajudar na tradução de bibliografias no formato BibTeX em outras línguas [humana].

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

note: type: textblock
en: NONE.
pt: NENHUM.

note: type: textblock
en: It is a very simple module, but still young.
pt: É um módulo muito simples, mas ainda jovem.

note: type: textblock
en: Locale::Po4a::Chooser - manage po4a modules
pt: Local::Po4a::Chooser - ger módulos 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: Locale::Po4a::Chooser é um módulo para gerir 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: Agora, só tem que invocar o Locale::Po4a::Chooser::new() função, a passar 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: 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: Acerca po4a:

note: type: =item
en: About modules:
pt: Acerca de módulos:

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

note: type: textblock
en: Locale::Po4a::Common - common parts of the po4a scripts and utils
pt: Locale::Po4a::Commom - partes comuns dos scripts po4a e utils

note: type: textblock
en: Locale::Po4a::Common contains common parts of the po4a scripts and some useful functions used along the other modules.
pt: Locale::Po4a::Commom contém partes comuns dos scripts po4a e algumasfunções úteis utilizadas ao longo dos outros módulos.

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

note: type: textblock
en: instead of:
pt: 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: O pedido é importante aqui: como a maioria dos módulos Locale::Po4a carregam-se Locale::Po4a::Common, a primeira vez que este módulo é carregado determina se Text::WrapI18N é usado.

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

note: type: =head2
en: Showing output messages
pt: Mostrando 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: Mostra a versão atual do script e uma curta mensagem de direitos de autor. Leva 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: 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: Esta função funciona como wrap_msg(), mas leva um nome de módulo como o primeiroargumento e deixa um espaço no lado esquerdo 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: Esta função funciona como wrap_msg(), mas é preciso dum file:line referência como o primeiro argumento, um nome de módulo como a segunda e deixa um espaço à esquerda da mensagem.

note: type: =head2
en: Wrappers for other modules
pt: Invólucros 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: Quando o módulo Locale::Gettext não pode ser carregado, este módulo fornece uma aplicação 'dummy' (vazio) das seguintes funções. Nesse caso, as mensagens po4a não serão traduzidas, mas o programa vai continuar a trabalhar.

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: Se Locale::gettext está presente, este invólucro também chama setlocale(LC_MESSAGES, "") assim os chamadores não dependem também do módulo POSIX.

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

note: type: textblock
en: Locale::Po4a::Dia - convert uncompressed Dia diagrams from/to PO files
pt: Locale::Po4a::Dia - converte diagramas Dia descompactados de/para ficheiros 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: Locale::Po4a::Dia é um módulo para ajudar a tradução de diagramas em formato Dia descompactado em outra língua [humana].

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

note: type: =head1
en: TRANSLATING WITH PO4A::DIA
pt: 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: Este módulo traduz apenas diagramas descompactados Dia. Pode gravar os seus diagramas descompactados com o próprio Dia, a desmarcar o diálogo "Ficheiros de diagramas compactados" em "Gravar Diagrama".

note: type: verbatim
en: Another way is to uncompress the dia files from command line with:
      gunzip < original.dia > uncompressed.dia
pt: Outra forma para descompactar os ficheiros dia é através da linhade comandos com:
      gunzip <original.dia > uncompressed.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: Este módulo é totalmente funcional, uma vez que depende do módulo L<Locale::Po4a::Xml>. Este módulo apenas define as etiquetas traduzíveis (E<lt>dia:stringE<gt>) e filtra as cadeias internas (o conteúdo da etiqueta E<lt>dia:diagramdataE<gt> não é interessa para a tradução.

note: type: textblock
en: Locale::Po4a::Docbook - convert DocBook XML documents from/to PO files
pt: Locale::Po4a::Docbook - converter documentos DocBook XML de/para ficheiros PO

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

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

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: O único problema conhecido é que ele ainda não manipula entidades e este inclui as entidades de inclusão de ficheiros, mas pode traduzir a maioria só destes ficheiros (exceto os ficheiros de entidades típicas) e é geralmente melhor mantê-los separados.

note: type: =head2
en: OVERRIDE THE DEFAULT BEHAVIOR WITH COMMAND LINE OPTIONS
pt: SUBSTITUIÇÃO DO COMPORTAMENTO PREDEFINIDO 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: O comportamento predefinido 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: Por exemplo, a predefinição da etiqueta B<< <author> >> está a apontar para aparecer em B<< <para> >>. Mas pode estar a usar apenas em B<< <bookinfo> >>. Para este caso, pode traduzi-lo independentemente para cada autor.

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

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: Isso substitui o comportamento predefinido 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 o conteúdo marcado dele e defina B<< <author> >> para traduzir o conteúdo marcado dele.

note: type: textblock
en: Locale::Po4a::Guide - convert Guide XML documents from/to PO files
pt: Locale::Po4a::Guide - converter documentos XML Guia de/para ficheiros 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: Locale::Po4a::Guide é um módulo para ajudar na tradução da documentação de Gentoo Linux no formato XML Guide em outra língua [humana].

note: type: textblock
en: This format is documented here: http://www.gentoo.org/doc/en/xml-guide.xml
pt: Este formato é 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: O único problema conhecido é que ele não inclui ficheiros com a etiqueta <include href = " ... "> , mas pode traduzir todos os ficheiros sozinho e é geralmente melhor mantê-los separados.

note: type: textblock
en: Locale::Po4a::Halibut - convert Halibut documents and derivates from/to PO files
pt: Locale::Po4a::Halibut - converte documentos Halibut e derivados de/para ficheiros PO

note: type: textblock
en: Locale::Po4a::Halibut is a module to help the translation of Halibut documents into other [human] languages.
pt: Locale::Po4a::Halibut é um módulo para ajudar a tradução de documentos Halibut em outras línguas [humana].

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

note: type: textblock
en: This module is still beta.  Please send feedback and feature requests.
pt: Este módulo ainda está em beta. Por favor, envie comentários e solicitações de recursos.

note: type: textblock
en: Some constructs are badly supported. The known ones are documented below.
pt: Algumas construções são mal suportadas. Os conhecidos documentados estão abaixo.

note: type: =head2
en: Verbatim blocks
pt: Blocos textuais

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

note: type: textblock
en: Locale::Po4a::Ini - convert INI files from/to PO files
pt: Locale::Po4a::Ini - converter ficheiros INI de/para ficheiros PO

note: type: textblock
en: Locale::Po4a::Ini is a module to help the translation of INI files into other [human] languages.
pt: Locale::Po4a::Ini é um módulo para ajudar a tradução de ficheiros INI emoutras línguas [humana].

note: type: textblock
en: The module searches for lines of the following format and extracts the quoted text:
pt: O módulos procura linhas com o seguinte formato e extrai o texto citado:

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

note: type: textblock
en: NOTE: If the text is not quoted, it will be ignored.
pt: NOTA: Se o texto não é citado, será ignorado.

note: type: textblock
en: Locale::Po4a::KernelHelp - convert kernel configuration help from/to PO files
pt: Locale::Po4a::KernelHelp - converte a ajuda de configuração do kernel de/para ficheiros 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: Locale::Po4a::KernelHelp é um módulo para ajudar a tradução de documentação para as opções de configuração do kernel Linux para outra língua [humana].

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: Este módulo foi escrito há pouco tempo e precisa de mais testes. A maior parte do trabalho necessário abrangerá as ferramentas utilizadas para analisar este ficheiro (e configurar o kernel), assim ele aceita para ler a documentação de outro ficheiro (traduzido).

note: type: textblock
en: Locale::Po4a::LaTeX - convert LaTeX documents and derivates from/to PO files
pt: Locale::Po4a::LaTeX - converte documentos LaTeX e derivados de/para ficheiros 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: Locale::Po4a::LaTeX é um módulo para ajudar a tradução de documentos LaTeX em outras línguas [humana]. Também pode ser usado como uma base para a construção de módulos para documentos de base LaTeX.

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

note: type: textblock
en: See the L<Locale::Po4a::TeX(3pm)|Locale::Po4a::TeX> manpage for the list of recognized options.
pt: Veja a página do manual 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: Locale::Po4a::Man - converte páginas do manual de/para ficheiros files

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: Locale::Po4a::Man é um módulo para ajudar na tradução de documentação em formato nroff (a linguagem das páginas do manual) em outras línguas [humana].

note: type: =head1
en: TRANSLATING WITH PO4A::MAN
pt: 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: Este módulo tenta com bastante força tornar a vida do tradutor mais fácil. Para isso, o texto apresentado aos tradutores não é uma cópia literal do texto encontrado na página do manual. De fato, as partes mais cruas do formato nroff estão escondidos, por isso os tradutores não se podem atrapalhar com elas.

note: type: =head2
en: Text wrapping
pt: Text envolvido

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: Parágrafos sem recuo são automaticamente reevolvidos para o tradutor. Isto pode levar a uma diferença menor na saída gerada, uma vez que as regras de reenvolvimento usadas por groff não são muito claras. Por exemplo, dois espaços depois de um parêntese às vezes são preservados.

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: De qualquer forma, a diferença será apenas sobre a posição dos espaços extrano parágrafo envolto e acho que vale a pena.

note: type: =head2
en: Font specification
pt: Especificação da Font

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: A primeira mudança é sobre as especificações de mudança de font. Em nroff, existem várias maneiras para especificar se uma determinada palavra deve ser escrita em pequeno, negrito ou itálico. No texto para traduzir, só há um caminho, emprestado do formato POD (Perl documentação on-line):

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

note: type: textblock
en: equivalent to \fItext\fP or ".I text"
pt: equivalente a \fItext\fP or ".I text"

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

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

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

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

note: type: =item
en: CWE<lt>textE<gt> -- constant width text
pt: CWE<lt>textE<gt> -- texto de largura constante

note: type: textblock
en: equivalent to \f(CWtext\fP or ".CW text"
pt: equivalente a \f(CWtext\fP or ".CW text"

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: Observação: O rosto CW não está disponível para todos os aparelhos groff. Não é recomendado usá-lo. Ele é fornecido para sua conveniência.

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

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: Po4a automaticamente translitera alguns carateres para facilitar a tradução ou revisão da tradução. Aqui está a lista das transliterações:

note: type: =item
en: hyphens
pt: 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: Hífens (-) e sinais de menos (\-) em páginas de manual são todos transliterados como traços simples (-) no ficheiro PO. Assim todos os traços são transliterados em sinais roff 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: Os tradutores podem forçar um hífen a usar o roff glyph '\[hy]' nas suas traduções.

note: type: =item
en: non-breaking spaces
pt: espaços não-separáveis

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: Os tradutores podem usar espaços não separáveis nas suas traduções. Estes espaços não separáveis (0xA0 em latin1) serão transliterados num roff non-breaking space ('\ ').

note: type: =item
en: quotes transliterations
pt: transliterações citadas

note: type: textblock
en: `` and '' are respectively tranliterated into \*(lq and \*(rq.
pt: `` e '' são respetivamente, transliterados em \*(lq and \*(rq.

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

note: type: =head2
en: Putting 'E<lt>' and 'E<gt>' in translations
pt: Colocando 'E<lt>' e 'E<gt>' em 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: Desde que estes carácteres são utilizadas para delimitar partes sob modificação da font, não os pode usar na íntegra. Use EE<lt>ltE<gt> e EE<lt>gtE<gt> em vez (como em POD, mais uma vez).

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

note: type: textblock
en: Increase verbosity.
pt: Aumentar o detalhe.

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: Esta opção controla o comportamento do módulo quando ele encontrar uma secçã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: Este é o valor predefinido. O módulo irá falhar quando uma secção .de, .ie ou .if é 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: Indica que as secções .de, .ie ou .if, devem ser copiadas como estão no 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: Indica que as secções .de, .ie ou .if serão propostas para a tradução. Só deve usar essa opção se uma cadeia traduzível está contida numa destas secções. Caso contrário, I<verbatim> deve ser preferida.

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: Esta opção especifica que o ficheiro foi gerado e que po4a não deve tentar detetar 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: Esta opção só é ú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: Seleciona um rigoroso suporte do formato mdoc a dizer a po4a para não traduzir a secção 'NOME'. Páginas mdoc cuja secção 'NOME' é traduzida não irá gerar qualquer cabeçalho ou rodapé.

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: De acordo com a página groff_mdoc, as secções NOME, SINOPSE e DESCRIÇÃO
    são obrigatórias.
    Não existem problemas conhecidos com a secção SINOPSE traduzida ou a secção DESCRIÇÃO,
    mas também pode especificar estas secções da seguinte 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: Esta questão mdoc também pode ser resolvida com uma adenda como esta:
     Po4a-HEADER:mode=before;position=^.Dd
     .TH DOCUMENT_TITLE 1 " Month day, year"OS " Section Name"

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: Nota: se uma macro não é suportada pelo po4a e se considerar que é uma macro roff predefinido, deve enviá-la ao equipa de desenvolvimento po4a.

note: type: textblock
en: B<untranslated> indicates that this macro (at its arguments) don't have to be translated.
pt: B<untranslated> indica que esta macro (nos seus argumentos) não tem que 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: B<noarg> é como B<untranslated>, exceto que po4a irá verificar que nenhum argumento é adicionado a esta macro.

note: type: textblock
en: B<translate_joined> indicates that po4a must propose to translate the arguments of the macro.
pt: B<translate_joined> indica que po4a deve propor a tradução dos 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: Com B<translate_each>, os argumentos também serão propostos para a tradução, exceto que cada um será traduzido em separado.

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: Essa opção usa como argumento uma lista de pares separados por vírgula I<begin>:I<End>, onde I<begin> e I<End> são comandos que delimitam o começar e terminar de uma secção que não deve ser re-envolvida.

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: 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 tem uma macro I<begin> (respectivamente I<end>) que não possui I<end> (respectivamente I<begin>), Pode especificar uma I<end> existente (como fi) ou I<begin> (como nf) como uma contraparte. Essas macros (e os argumentos deles) 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: Esta opção especifica uma lista de macros separadas por vírgula que não devem dividir o parágrafo atual. A cadeia a traduzir conterá então I<foo E<lt>.bar baz quxE<gt> quux> onde I<bar> é o comando que deve ser 'inlined', e I<baz qux> os argumentos dele.

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: Esta opção indica como po4a deve se comportar quando uma macro desconhecida é encontrada. Por predefinição, po4a falha com um aviso. Ele pode tomar os seguintesvalores: B<failed> (o valor predefinido), B<untranslated>, B<noarg>, B<translate_joined>, ou B<translate_each> (ver acima para uma explicação destes valores).

note: type: =head1
en: AUTHORING MAN PAGES COMPLIANT WITH PO4A::MAN
pt: AUTORIA DAS PÁGINAS DE MANUAL COMPATÍVEL 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: Este módulo é ainda muito limitado e, sempre vai ser, porque não é um intérprete nroff real. Seria possível fazer um intérprete nroff real, permitir que os autores usarem todas as macros existentes, ou até mesmo para definir novas nas suas páginas, mas não quiséssemos. Seria muito difícil e pensamos que não era necessário. Pensamos que se os autores das páginas de manual quiserem ver as suas produções traduzidas, devem ter de se adaptar a 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: Portanto, o analisador de manual implementado em po4a tem algumas limitações conhecidas que são e não estamos realmente inclinados a corrigir e que constituirá algumas armadilhas que tem de evitar se quiser ver tradutores cuidarem da sua documentação.

note: type: =head2
en: Don't program in nroff
pt: 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: nroff é uma linguagem de programação completa, com a definição de macro, condicionais e assim por diante. Uma vez que este analisador está totalmente caracterizado como intérprete nroff, irá falhar em páginas que utilizam estas instalações (há cerca de 200 tais páginas na minha caixa).

note: type: =head2
en: Use the plain macro set
pt: Use o conjunto de macro 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: Existem ainda alguns macros que não são suportadas por po4a::man. É assim porque eu não encontrei nenhuma documentação sobre elas. Aqui está a lista de macros sem suporte, utilizadas na minha caixa. Note que esta lista não é exaustiva uma vez que o programa falha no primeiro macro, que encontra sem suporte. Se tem alguma informação sobre algumas desses macros, ficarei feliz em adicionar suporte para elas. Devido a estes macros, cerca de 250 páginas na minha caixa são inacessíveis para po4a::man.

note: type: =head2
en: Hiding text from po4a
pt: Escondendo texto de po4a

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: Às vezes, o autor sabe que algumas partes não são traduzíveis e não devem ser extraídas por po4a. Por exemplo, uma opção pode aceitar um argumento I<other> e I<other> também pode aparecer como o último item duma lista. No primeiro caso, I<other> não deve ser traduzido. E, no segundo caso, I<other> deve ser traduzido.

note: type: textblock
en: In such case, the author can avoid po4a to extract some strings, using some special groff constructs:
pt: Em tal caso, o autor pode evitar po4a para extrair algumas cadeias, a usar algumas construções especiais groff:

note: type: textblock
en: (this will require the B<-o groff_code=verbatim> option)
pt: (isto vai exigir 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: A nova macro também pode ser definida para automatizar isto:
     .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: (isto vai exigir as opções B<-o groff_code =verbatim> e B<-o untranslated=IR_untranslated>; com esta construção, o B<.if !'po4a'hide'> condicional não é estritamente necessário uma vez que po4a não irá analisar o interno da definição da macro)

note: type: verbatim
en: or using an alias:
     .als IR_untranslated IR
pt: ou a utilizar um alias: 
     .als IR_untranslated IR

note: type: textblock
en: This will require the B<-o untranslated=als,IR_untranslated> option.
pt: Isso vai exigir o B<-o untranslated=als,IR_untranslated> option.

note: type: =head2
en: Conclusion
pt: 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: Para resumir esta secção, manter simples e não tente ser inteligente a quanto da autoria das suas páginas de manual. Muitas coisas são possíveis em nroff e não suportadas por este analisador. Por exemplo, não tente mexer em \c para interromper o processamento de texto (como 40 páginas na minha caixa de 'a fazer'). Ou seja, certo a pôr os argumentos do macro na mesma linha em que o macro está. Sei que é válido em nroff, mas iria complicar muito o analisador para ser tratado.

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: É claro, outra possibilidade é usar outro formato, mais amigável ao tradutor (como POD a usar 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 detetar 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: Geralmente, po4a::man vai detetar o problema e se recusar a processar a página, a apresentar 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 encontrar tal caso, certifique-se de relatá-lo, com uma solução, quando possível…

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

note: type: textblock
en: Some tests are regularly run on Linux boxes:
pt: Alguns testes são regularmente executado 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: um terço das páginas são recusadas porque foram geradas a partir de outro formato suportado pelo po4a (por exemplo, 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: 10% das páginas remanescentes são rejeitadas com um erro (por exemplo, uma macro groff não é suportada).

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: Em seguida, menos de 1% das páginas são aceites por po4a silenciosamente, mas com questões significativas (ou seja, palavras que faltam, ou palavras novas 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: As outras páginas são geralmente tratadas sem diferenças mais importantes do que as diferenças de espaçamento ou linhas reevolvidas (problemas com fontes são menos de 10% das páginas processadas).

note: type: textblock
en: Locale::Po4a::Po - PO file manipulation module
pt: Locale::Po4a::Po - módulo de manipulação dum ficheiro PO

note: type: verbatim
en:     # Read PO file
        $pofile->read('file.po');
pt:     # Ler ficheiro PO
        $pofile->read('file.po');

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

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

note: type: verbatim
en:     # Write back to a file
        $pofile->write('otherfile.po');
pt:     # Escrever de volta para um ficheiro
        $pofile->write('otherfile.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: Locale::po4a:: Po é um módulo que permite que manipule catálogos de mensagens. Pode carregar e escrever de/para um ficheiro (cuja extensão é muitas vezes I<po>), pode construir novas entradas na execução ou pedir uma tradução de uma cadeia.

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: Para uma descrição mais completa do catálogo de mensagens no formato PO e o uso dele, por favor veja a documentação info do programa gettext. (nó "`Ficheiros 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: Este módulo é parte do projeto po4a, cujo objetivo é usar ficheiros PO (projetado na origem para facilitar a tradução de mensagens do programa) para traduzir tudo, inclusive a documentação (página do manual, manual de informação), descrição do pacote, modelos debconf e tudo o que pode beneficiar a partir deste.

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

note: type: =item
en: new()
pt: novo()

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: Cria um catálogo de mensagem novo. Se um argumento é fornecido, é o nome dum ficheiro PO que deve carregar.

note: type: =item
en: read($)
pt: ler($)

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: Lê um ficheiro PO (que o nome é dado como argumento). Entradas previamente existentes em si não são removidas, os novos são adicionados ao fim do catálogo.

note: type: =item
en: write($)
pt: escrever($)

note: type: textblock
en: Writes the current catalog to the given file.
pt: Escreve o catálogo atual ao ficheiro dado.

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: Como escrever, mas se o ficheiro PO ou POT já existe, o objeto será escrito num ficheiro temporário, que será comparado com o ficheiro existente para verificar se a atualização é necessária (isso evita mudar um POT apenas para atualizar uma linha de referência ou o campo POT-Creation-Date).

note: type: =item
en: filter($)
pt: filtro($)

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: Esta função extrai um catálogo a partir de um já existente. Somente as entradas têm uma referência no ficheiro dado será posto 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: Esta função analisa o argumento dele, converte-o para uma definição função Perl, avalia esta definição e filtra os campos para os quais esta função retornará verdadeiro.

note: type: textblock
en: I love Perl sometimes ;)
pt: Algumas vezes gosto de Perl ;)

note: type: =head1
en: Functions to use a message catalog for translations
pt: Funções para utilizar 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: Pede a tradução duma dada sequência como argumento no catálogo atual. Esta função retorna a sequência (não traduzida) original, se a cadeia não foi encontrada.

note: type: textblock
en: After the string to translate, you can pass a hash of extra arguments. Here are the valid entries:
pt: Após a cadeia para traduzir, pode passar um 'hash' de argumentos adicionais. Aqui sã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: um booleano indica se podemos considerar que os espaços em branco na cadeia não são importantes. Se sim, a função canoniza a cadeia antes de procurar uma tradução e envolve o resultado.

note: type: textblock
en: the column at which we should wrap (default: 76).
pt: a coluna em que devemos envolver (predefiniçã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: Retorna estatísticas sobre a taxa de acerto de gettext desde a última vez que stats_clear() foi chamado. Por favor, note que não são as mesmas estatísticas que são impressas por msgfmt --statistic. Aqui, são as estatísticas sobre o recente uso do ficheiro PO, enquanto msgfmt informa sobre o estado do ficheiro. Exemplo de uso:

note: type: verbatim
en:     [some use of the PO file to translate stuff]
pt:     [algum uso do ficheiro 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:     ($percent,$hit,$queries) = $pofile->stats_get();
        print "Até agora, encontramos traduções para $percent\% ($hit de $queries) de cadeias.\n";

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

note: type: =head1
en: Functions to build a message catalog
pt: Funções para a construção de um catálogo de mensagens

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: Empurrar uma nova entrada no final do catálogo atual. Os argumentos devem formar uma tabela hash. As chaves válidas são:

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

note: type: textblock
en: the translation.
pt: 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: uma indicação de onde essa cadeia foi encontrada. Exemplo: file.c:46 (ou seja, em 'file.c' na linha 46). Pode ser uma lista separada por espaços em caso de múltiplas ocorrências.

note: type: textblock
en: a comment added here manually (by the translators). The format here is free.
pt: um comentário adicionado aqui manualmente (pelo tradutor). O 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: um comentário que foi adicionado automaticamente pelo programa de extração da cadeia. Veja a opção B<--add-comments> do programa B<xgettext> para obter mais informações.

note: type: textblock
en: space-separated list of all defined flags for this entry.
pt: lista separada por espaços de todas as 'flags' 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: As 'flags' 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> and B<fuzzy>.

note: type: textblock
en: See the gettext documentation for their meaning.
pt: Consulte a documentação do gettext para o significado deles.

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: este é mais um argumento interno: é usado enquanto os documentos são 'gettextizados'. A ideia aqui é analisar tanto o original como a tradução num objeto PO e fundi-los, a usar um 'msgid' como 'msgid' e os outros 'msgid' como 'msgstr'. Para ter certeza de que as coisas ficam bem, cada 'msgid em objetos PO recebem um tipo, com base na estrutura deles (como "chapt", "sect1", "p" e assim por diante em DocBook). Se os tipos de cadeias não são as mesmas, significa que ambos os ficheiros não partilham a mesma estrutura e, o processo e informa 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: Esta informação é escrita como comentário automático no ficheiro PO uma vez que dá aos tradutores algum contexto sobre as cadeias 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: booleano que indica se os espaços em branco podem ser mutilados em cosméticas reformatações. Se for verdade, a cadeia está canonizada antes do uso.

note: type: textblock
en: This information is written to the PO file using the B<wrap> or B<no-wrap> flag.
pt: Esta informação é gravada no ficheiro PO a usar a 'flag' B<wrap> ou B <no-wrap>.

note: type: =head1
en: Miscellaneous functions
pt: Funções auxiliares

note: type: textblock
en: Returns the number of entries in the catalog (without the header).
pt: Retorna a quantidade 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: Retorna a quantidade de entradas no documento. Se uma cadeia aparece múltiplas vezes no documento, será contado múltiplas vezes.

note: type: textblock
en: Returns the msgid of the given number.
pt: Retorna o identificador de mensagem do número dado.

note: type: textblock
en: Returns the msgid with the given position in the document.
pt: Retorna o identificador de mensagem na posição do documento dada.

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: Retorna o conjunto de caracteres especificado no cabeçalho PO. Se não foi definido, irá retornar "UTF-8".

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

note: type: verbatim
en:     # Read POD from STDIN and write to STDOUT.
        $parser->parse_from_filehandle;
pt:     # Ler POD de STDIN e escrever em 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:     # Ler POD de file.pod e escrever para file.txt.
        $parser->parse_from_file ('file.pod', 'file.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: Locale::Po4a:: Pod é um módulo para ajudar a tradução da documentação em formato POD (o idioma preferido para documentar Perl) em outralíngua [humana].

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: Acho que este módulo é rocha estável e há apenas um erro conhecido com F</usr/lib/perl5/Tk/MainWindow.pod> (e algumas outras páginas, veja abaixo) que contém:

note: type: textblock
en: which is logic since CE<lt>foobarE<gt> is rewritten "foobar".
pt: O que é lógico desde que CE<lt>foobarE<gt> é rescrito "foobar".

note: type: =head1
en: INTERNALS
pt: INTERNAS

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: Como uma classe derivada de Pod::Parser, Locale::Po4a::Pod suporta o mesmo métodos e interfaces. Ver L<Pod::Parser> para todos os detalhes, com brevidade, cria um novo analisador com C<< Locale::Po4a::Pod->new() >> e depois invoca também parse_from_filehandle() ou parse_from_file().

note: type: textblock
en: Locale::Po4a::RubyDoc -- Convert Ruby Document data from/to PO files
pt: Locale::Po4a::RubyDoc - Xonverte dados de Ruby Document de/para ficheiros 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: 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: Este módulo foi testado com sucesso em ficheiros 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: 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: 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: Manipula ficheiros 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: 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: Est obra é um software livre; 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: 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: 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: 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: 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: Locale::Po4a::Sgml - converte documentos SGML de/para ficheiros 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: Locale::Po4a::Sgml é um módulo para ajudar a tradução da documentação no formato SGML em outras idiomas [humanos].

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: Este módulo usa B<onsgmls>(1) para analisar os ficheiros SGML. Certifique-se de que é instalado. Certifique-se também de que o DTD dos ficheiros SGML está instalado no sistema.

note: type: textblock
en: Give more information about what's going on.
pt: Dê mais informações sobre o que está a acontecer.

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: A apresentação dentro dessas marcas não deve ser alterada. Este parágrafo não vai ficar envolvido e não há espaço de recuo adicional ou nova linha será adicionada para finalidade estética.

note: type: textblock
en: Tags not needing to be closed.
pt: Etiquetas que não precisam ser fechadas.

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: O problema com isso é que o C<{PO4A-end}> e outros que acrescento, são inválidos no documento (não numa marcação E<lt>pE<gt> ou similar).

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: Ele funciona apenas com o DebianDoc e DocBook DTD. Adicionar suporte para um novo DTD deve ser muito fácil. O mecanismo é o mesmo para cada DTD, só tem que dar uma lista das etiquetas existentes e algumas das suascaracterí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: Concordo. apenas necessita mais documentação, no entanto pode ser considerado como beta e detesto conteúdos de documentos que podem ainda ser sujeitos a alterações.

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: Aviso, o suporte para DTDs é bastante experimental. Não li nenhum manual de referência para encontrar a definição de cada etiqueta. Adicionei a definição de etiqueta para o módulo, até que funciona para alguns documentos que eu encontrei na Internet. Se o documento usar mais etiqueta do que a minha, não vai funcionar. Mas como eu disse acima, reparar isto deve ser muito 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: Testei DocBook contra o SAG (Guia do Administrador do Sistema), mas também este documento é muito grande e deve usar mais especificidades do DocBook.

note: type: textblock
en: For DebianDoc, I tested some of the manuals from the DDP, but not all yet.
pt: Para DebianDoc, testei alguns dos manuais da DDP, mas 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: Em caso de inclusão de ficheiros, a cadeia de referência de mensagens em ficheiros PO (ou seja, linhas como C<#: en/titletoc. sgml:9460>) vai estar errada.

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: Assim ele funciona, substituí as entidades que pedem a inclusão de ficheiros pelo conteúdo do ficheiro de dados (para que possa proteger também o que precisa de estar num sub-ficheiro também). Mas nada se fez até agora para corrigir as referências (ou seja o nome do ficheiro e o número da linha) mais tarde. Não tenho certeza qual é a melhor coisa a fazer.

note: type: textblock
en: This module is an adapted version of sgmlspl (SGML postprocessor for the ONSGMLS parser) which was:
pt: Este módulo é uma versão adaptada do 'sgmlspl' (pós-processador SGML para os analisadores SGMLS e ONSGMLS) que foi:

note: type: textblock
en: The adaptation for po4a was done by:
pt: A adaptação para po4a foi feito por:

note: type: textblock
en: Locale::Po4a::TeX - convert TeX documents and derivatives from/to PO files
pt: Locale::Po4a::TeX - converte documentos TeX e derivados de/para ficheiros 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: Locale::Po4a::TeX é um módulo para ajudar na tradução de documentos TeX em outra língua [humana]. Também pode ser usado como uma base para a construção de módulos de TeX documentos baseados.

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: Utilizadores 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: TRADUÇÃO 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: Este módulo pode ser usado diretamente para lidar com documentos genéricos TeX. Isto irá dividir o seu documento em blocos menores (parágrafos, blocos textuais, ou mesmo menores, como títulos ou í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: Há algumas opções (descritas na próxima secção) que podem personalizar este comportamento. Se isso não se adequar ao formato do seu documento, encorajamos-o a escrever o seu próprio módulo derivado deste, para descrever os detalhes do seu formato. Veja a secçã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: Esse módulo também pode ser personalizado por linhas iniciais com "% po4a:" no ficheiro TeX. Esse processo é descrito na secção B<PERSONALIZAÇÃO INTEGRADA>.

note: type: textblock
en: Comma-separated list of environments which should not be re-wrapped.
pt: Lista de ambientes separada por vírgula que não deve ser re-envolvidos.

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: Note que há uma diferença entre os ambientes textuais e no_wrap. Não existe um comando e análise de comentários em blocos textuais.

note: type: textblock
en: If this environment was not already registered, po4a will consider that this environment does not take any parameters.
pt: Se este ambiente não foi já registado, po4a irá considerar que este ambiente não leva nenhum parâmetro.

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

note: type: textblock
en: Comma-separated list of environments which should be taken as verbatim.
pt: Lista de ambientes separada por vírgula que devem ser tomados como textuais.

note: type: textblock
en: Use these options to override the default behavior of the defined commands.
pt: 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: O módulo TeX pode ser personalizado com linhas a começar por B<% po4a:>. Estas as linhas são interpretadas como comandos para o analisador. Os seguintes comandos são reconhecido:

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: Indica que os argumentos do comando I<command1> devem ser tratado como os argumentos do comando I<command2>.

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: Isso descreve em detalhes os parâmetros do comando I<comando1>. Essa informação será usada para verificar a quantidade de argumentos e os seus tipos.

note: type: textblock
en: You can precede the I<command1> command by
pt: Pode preceder o comando I<command1> por

note: type: =item
en: an asterisk (B<*>)
pt: 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: po4a irá extrair este comando a partir de parágrafos (se ele está localizado no começo ou o fim de um parágrafo). Os tradutores terão então de traduzir os parâmetros que são marcados como traduzível.

note: type: =item
en: a plus (B<+>)
pt: 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: Assim como o asterisco, o comando será extraído se ele aparecer numa 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: Nota: Neste caso, não tem que especificar quais os parâmetros que são traduzíveis, mas po4a deve saber o tipo e a quantidade de parâmetros.

note: type: =item
en: a minus (B<->)
pt: 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: Neste caso, o comando não será extraído a partir de qualquer bloco. Mas se aparece sozinho num bloco, então, apenas os parâmetros marcados como traduzíveis serão apresentados ao tradutor. Isto é útil para os comandos de fonte. Estes comandos geralmente não devem ser separados dos seus parágrafos (para manter o contexto), mas não há motivo para chatear o tradutor com eles, se uma cadeia inteira é incluída em tal 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: O argumento I<parameters> é um conjunto de [] (para indicar um argumento opcional)
     ou {} (para indicar um argumento obrigatório).
    Pode pôr um traço baixo (_) entre estas chavetas para indicar isso 
    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: Isto indica que o comando capítulo tem dois parâmetros: um opcional
    (título curto) e um obrigatório, que devem ser ambos traduzidos.
    Se quer especificar que o comando 'href' tem dois parâmetros obrigatórios,
    que não quer traduzir o 'URL' (primeiro parâmetro) e que
    não quer que esse comando seja separado do seu parágrafo (que permitem
    ao tradutor mover a ligação (link) na frase), pode usar:
     %po4a: comando -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: Neste caso, a informação a indicar que argumentos devem ser traduzidos só é usada se um parágrafo é composto apenas por este comando href.

note: type: =item
en: B<% po4a: environment> I<env> I<parameters>
pt: B<% po4a: ambiente> I<env> I<parameters>

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: Isso define os parâmetros aceitos pelo ambiente I<ambiente> e especifica quais serão traduzidos.
    Essa informação é posteriormente usada para verificar a quantidade 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: Como para os comandos, I<env> pode ser precedido por um sinal de mais (+) para indicar que o comando \begin deve ser traduzido com todos os seus argumentos.

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

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: A expressão regular é delimitada por aspas. Ela não deveria criar qualquer referência própria. Deveria usar (?:) se 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: 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 por 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: A noção de ambiente é expandida ao tipo exibido no ficheiro 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: B <% po4a: ambiente textual> I<env>

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

note: type: =head1
en: WRITING DERIVATE MODULES
pt: 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: Adiciona uma cadeia 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: Envolvido em torno 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: Comentários de um parágrafo são inseridos como um comentário PO para a primeira cadeia traduzida deste parágrafo.

note: type: textblock
en: This function returns:
pt: Esta função retorna:

note: type: =item
en: A command name
pt: 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: Se nenhum comando é encontrado no início do 'buffer' dado, esta cadeia estará vazia. Apenas os comandos que podem ser separados são considerados. O %separated_command contém a lista desses comandos.

note: type: =item
en: A variant
pt: 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: Isto indica se uma variante é usada. Por exemplo, um asterisco (*) pode ser adicionado no final das secções de comando para especificar que não devem ser numerada. Neste caso, o campo irá conter "*". Se não houver uma variante, o campo é uma cadeia vazia.

note: type: =item
en: An array of tuples (type of argument, argument)
pt: Uma matriz de tuplos (tipo de argumento, argumento)

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

note: type: =item
en: The remaining buffer
pt: 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: O resto do 'buffer' após a remoção do comando de liderança e os argumentos dele. Se nenhum comando for encontrado, o 'buffer' original não é tocado 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: O mesmo que B<get_leading_command>, mas para comandos no fim do '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: Recursivamente traduzir um 'buffer' a separar comandos à esquerda e à direita (aqueles que devem ser convertidos em separado) a partir 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: Se uma função é definida em %translate_buffer_env para o atual ambiente, esta função irá ser usada para converter o 'buffer' em vez de translate_buffer ().

note: type: textblock
en: Overloads Transtractor's read().
pt: 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: Recursivamente ler um ficheiro, a anexar ficheiros incluídos que não estão listadas na matriz @exclude_include. Ficheiros incluídos são pesquisados a utilizar o comando B<kpsewhich> comando a partir da biblioteca kpathsea.

note: type: textblock
en: Except from the file inclusion part, it is a cut and paste from Transtractor's read.
pt: Com exceção de parte a inclusão do ficheiros, é um corte e cole a partir da leitura Transtractor.

note: type: textblock
en: Subroutine for parsing a file with po4a directives (definitions for new commands).
pt: Sub-rotina para analisar um ficheiro com as directivas po4a (definições de novoscomandos).

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

note: type: textblock
en: See the B<INLINE CUSTOMIZATION> section for more details.
pt: Ver a secção B<INLINE CUSTOMIZATION> para mais detalhes.

note: type: =head1
en: INTERNAL FUNCTIONS used to write derivative parsers
pt: 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: Funções de comando e ambiente que precisam dos seguintes argumentos (em adição do objeto $self):

note: type: =item
en: An array of (type, argument) tuples
pt: Uma matriz de tuplos (tipo, argumneto)

note: type: =item
en: The current environment
pt: O ambiente corrente

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

note: type: textblock
en: Command and environment functions return the translation of the command with its arguments and a new environment.
pt: Funções de comando e ambiente retornam a tradução do comando com os argumentos dele 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: Funções do ambiente são chamadas quando um comando \begin é encontrado. Eles são chamados com o comando \begin e os argumentos dele.

note: type: textblock
en: The TeX module only proposes one command function and one environment function: generic_command and generic_environment.
pt: 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: generic_command usa as informações especificadas por
    register_generic_command ou pela adição de definição para o ficheiro TeX:
     %po4a: comando I<command1> I<parameters>

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: generic_environment usa as informações especificadas por
    register_generic_environment ou pela adição de definição para o ficheiro TeX:
    %po4a: ambiente I<env> I<parameters>

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: Ambas as funções só traduzem os parâmetros que foram especificados como traduzível (com um '_'). generic_environment irá acrescentar o nome do ambiente à pilha do ambiente e generic_command irá acrescentar 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: Este módulo precisa de mais testes.

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

note: type: =head1
en: TODO LIST
pt: LISTA PARAFAZER

note: type: =item
en: Automatic detection of new commands
pt: 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: O módulo TeX pode analisar os argumentos do novo comando e tentar adivinhar a quantidade de argumentos, o tipo deles e se eles devem ou não ser traduzidos.

note: type: =item
en: Translation of the environment separator
pt: 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: Quando \item é utilizado como um separador de ambiente, o argumento item é ligado à seguinte cadeia.

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

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

note: type: textblock
en: Various other points are tagged TODO in the source.
pt: Vários outros pontos são marcados A FAZER na fonte.

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

note: type: textblock
en: Various points are tagged FIXME in the source.
pt: Vários pontos são marcados CORREÇÃO na fonte.

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

note: type: textblock
en: Locale::Po4a::Texinfo is a module to help the translation of Texinfo documents into other [human] languages.
pt: Locale::Po4a::Texinfo é um módulo para ajudar a tradução de documentos Texinfo em outras línguas [humana].

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

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

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

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

note: type: textblock
en: Paragraphs are split on empty lines (or lines containing only spaces or tabulations).
pt: Os parágrafos são divididos em linhas vazias (ou linhas a conter 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: Se um parágrafo contém uma linha de partida por um espaço (ou tabulação), este parágrafo não será re-envolvido.

note: type: textblock
en: Deactivate the detection of bullets.
pt: Desativar a deteção de 'bullets'.

note: type: textblock
en: Specify how tabulations shall be handled. The I<mode> can be any of:
pt: Especificar como tabulações devem ser tratadas. O I<mode> pode ser qualquer um de:

note: type: textblock
en: Lines with tabulations introduce breaks in the current paragraph.
pt: Linhas com tabulações apresentam quebras no parágrafo atual.

note: type: textblock
en: Paragraph containing tabulations will not be re-wrapped.
pt: Parágrafo a conter tabulações não será re-envolvido.

note: type: textblock
en: By default, tabulations are considered as spaces.
pt: Por predefinição, tabulações são consideradas 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: Uma expressão regular corresponde a linhas que introduzem pausas. A regular expressão 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: 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: Lidar com o formato 'fortunes', que separada as '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: Lidar com alguma marcação especial em formatados textos Markdown.

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

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

note: type: textblock
en: Prevent po4a from wrapping any lines. This means that every content is handled verbatim, even simple paragraphs.
pt: 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: Testado com sucesso em ficheiros de texto simples e ficheiros NEWS.Debian.

note: type: textblock
en: Locale::Po4a::TransTractor - generic trans(lator ex)tractor.
pt: Locale::Po4a::TransTractor - genérico trans(lator ex)trator.

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: Esta classe é o ancestral de todos os analisadores po4a usado para analisar um documento, para pesquisar cadeias traduzíveis, para extraí-las para um ficheiro PO e substitui-los pela tradução dela no documento de saída.

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

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

note: type: textblock
en: a PO file containing the translations to use.
pt: Um ficheiro PO que contém as traduções para usar.

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

note: type: textblock
en: another PO file, resulting of the extraction of translatable strings from the input document;
pt: outro ficheiro PO, resultante da extração de cadeias traduzíveis em 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: um documento traduzido, com a mesma estrutura do que o de entrada, mas com todas as cadeias traduzíveis substituídas com as traduções encontradas no ficheiro PO fornecido na entrada.

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

note: type: verbatim
en:    Input document --\                             /---> Output document
                         \                           /       (translated)
                          +-> parse() function -----+
                         /                           \
       Input PO --------/                             \---> Output PO
                                                             (extracted)
pt:    Documento de entrada --\                     / ---> documento de saída
                               \                   /          (traduzido)
                               +-> função analisar() ---+
                               /                         \
       Entrada PO ------------/                           \---> Saída PO
                                                                (extraído)

note: type: =head1
en: FUNCTIONS YOUR PARSER SHOULD OVERRIDE
pt: FUNÇÕES QUE O SEU ANALISADOR DEVERIA SUBSTITUIR

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: Este é o lugar onde todo o trabalho tem lugar: a análise dos documentos de entrada, a geração da saída e a extração das cadeias traduzíveis. Isto é muito simples a usar as funções disponíveis apresentadas na secção abaixo B<INTERNAL FUNCTIONS>. Ver também o B<SYNOPSIS>, o qual 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: Esta função é invocada pela função processo() abaixo, mas se escolher usar a função new() e, para adicionar conteúdo manualmente qo documento, terá que invocar esta 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: Esta função retorna o cabeçalho  que devemos acrescentar ao documento produzido, citado corretamente para ser um comentário na língua apontada. Consulte a secção B<Educating developers about translations>, de L<po4a(7)|po4a.7>, que é para o bem de todos.

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: O exemplo a seguir analisa uma lista de parágrafos que começam com "<p>". Pelo bem da simplicidade, assumimos que o documento está bem formatado, ou seja, que etiquetas '<p> são as etiquetas apenas presentes e que esta marca é no início 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:    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>. 
                   # Reponha a linha atual na entrada, 
                   # e pôr o parágrafo construído à 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:                # Agora que o documento é formado, traduza-o:
                   #   - Remova a etiqueta líder
                   $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:                #   - Empurre à saída a etiqueta principal (não traduzido)
                    #     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:                próximo PARAGRÁFO;
               } else {
                   # Acrescente o parágrafo
                   $paragraph .= $line;
                   $pararef = $lref unless(lenght($pararef));
               }

note: type: verbatim
en:            # Reinit the loop
               ($line,$lref)=$self->shiftline();
           }
           # Did not get a defined line? End of input file.
           return;
       }
     }
pt:            # Reiniciar o ciclo
              ($line,$lref)=$self->shiftline();
             }
             # Não tem uma linha definida? Fim do ficheiro 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: Depois de implementar a função de análise, pode usar a sua classe de documento, a usar a interface pública apresentada na próxima secção.

note: type: =head1
en: PUBLIC INTERFACE for scripts using your parser
pt: INTERFACE PÚBLICA para scripts a usar o seu analisador

note: type: =head2
en: Constructor
pt: 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: Esta função pode fazer tudo o que precisa fazer com um documento po4a numa invocação. Os argumentos dela devem ser empacotados como uma 'hash'. AÇÕES:

note: type: textblock
en: Reads all the PO files specified in po_in_name
pt: Lê todos os ficheiros PO especificados em po_in_name

note: type: textblock
en: Reads all original documents specified in file_in_name
pt: Lê todos os documentos originais especificados em file_in_name

note: type: textblock
en: Parses the document
pt: Analisa o documento

note: type: textblock
en: Reads and applies all the addenda specified
pt: Lê e aplica todas as adendas especificadas

note: type: textblock
en: Writes the translated document to file_out_name (if given)
pt: Escreve o documento traduzido para o file_out_name (se dado)

note: type: textblock
en: Writes the extracted PO file to po_out_name (if given)
pt: Escreve o ficheiro PO extraído para po_out_name (se dado)

note: type: textblock
en: ARGUMENTS, beside the ones accepted by new() (with expected type):
pt: ARGUMENTOS, ao lado dos aceites por new() (com o tipo esperado):

note: type: textblock
en: List of filenames where we should read the input document.
pt: Lista de nomes de ficheiros onde devemos ler o documento de entrada.

note: type: textblock
en: Filename where we should write the output document.
pt: Nome do ficheiro onde devemos escrever o documento de saída.

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: Lista de nomes de ficheiros onde devemos ler os ficheiros de entrada do PO, que contêm a tradução que irá 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: Nome do ficheiro onde devemos escrever a saída do ficheiro PO, que contém as cadeias extraídas do documento de entrada.

note: type: textblock
en: List of filenames where we should read the addenda from.
pt: Lista de nomes de ficheiros que devemos ler a adenda de.

note: type: textblock
en: Charset for the addenda.
pt: Conjunto de carateres para a adenda.

note: type: textblock
en: Create a new po4a document. Accepted options (in the hash passed as a parameter):
pt: 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: Define o nivel de detalhe.

note: type: textblock
en: Sets the debugging.
pt: Define a depuração.

note: type: =head2
en: Manipulating document files
pt: Manipulação de ficheiros de documentos

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: Esse vetor C<< @{$self->{TT}{doc_in}} >> detém os dados desse documento de
    entrada como um vetor e cadeias com significados alternativos.
     * A cadeia C<$textline> a deter cada linha de dados de texto de entrada.
     * A cadeia C<< $filename:$linenum >> a deter a  localização dele e chamada
       como "referência" (C<linenum> starts with 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: Por favor, note que ele não analisa nada. Deve usar a função parse() quando está feito com o empacotamento de ficheiros de entrada no documento.

note: type: textblock
en: Write the translated document to the given filename.
pt: Escreva o documento traduzido no nome do ficheiro dado.

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: Os dados desse documento traduzido são fornecidos por:
     * C<< $self->docheader() >> a deter o texto de cabeçalho para o plugin e
     * C<< @{$self->{TT}{doc_out}} >> a deter cada linha do principal texto traduzido no vetor.

note: type: =head2
en: Manipulating PO files
pt: Manipulando ficheiros 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: Adicionar o conteúdo dum ficheiro (que o nome é passado como argumento) para o actual PO de entrada. O conteúdo antigo não é descartado.

note: type: textblock
en: Write the extracted PO file to the given filename.
pt: Gravar o ficheiro PO extraído ao nome do ficheiro dado.

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: Retorna algumas estatísticas sobre a tradução feita até agora. Note que não é a mesma estatística que a impressa por msgfmt--statistic. Aqui, são estatísticas sobre o uso recente do ficheiro PO, enquanto msgfmt relata o estado do ficheiro. Ele é um envolvido para função Locale::Po4a::Po::stats_get aplicada ao ficheiro de entrada PO. Exemplo de uso:

note: type: verbatim
en:     [normal use of the po4a document...]
pt:     [utilização normal do documento po4a ...]

note: type: verbatim
en:     ($percent,$hit,$queries) = $document->stats();
        print "We found translations for $percent\%  ($hit from $queries) of strings.\n";
pt:     ($percent,$hit,$queries) = $document->stats();
        print "Encontramos traduções para $percent\%  ($hit from $queries) de cadeias.\n";

note: type: =head2
en: Manipulating addenda
pt: Manipulação da adenda

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: Por favor, consulte L<po4a(7)|po4a.7> para obter mais informações sobre o que são adendas e como os tradutores devem escrevê-las. Para aplicar uma adenda ao documento traduzido, basta passar o nome do ficheiro para esta função e está feito ;)

note: type: textblock
en: This function returns a non-null integer on error.
pt: Esta função retorna um inteiro não nulo em caso de erro.

note: type: =head2
en: Getting input, providing output
pt: Obtenção de entrada, a fornecer 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: 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:  * 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: O primeiro par é sobre entrada, enquanto ao segundo é sobre saída. Mnemônico: na entrada, está interessada na primeira linha, que é o que o shift fornece e na saída quer adicionar o 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: Esta função retorna a primeira linha a ser analisada e a referência dele 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 cadeia 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: Executa unshift a última linha "shiftada" do documento de entrada e a referência dele correspondente de volta ao 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: Envia uma nova linha ao 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: Volta, do fim de C<< {$self->{TT}{doc_out}} >>, a linha anteriormente enviada.

note: type: =head2
en: Marking strings as translatable
pt: Marcar cadeias como traduzíveis

note: type: textblock
en: One function is provided to handle the text which should be translated.
pt: Uma função é fornecida para lidar com o texto que deve ser traduzido.

note: type: textblock
en: Mandatory arguments:
pt: Argumentos obrigatórios:

note: type: textblock
en: A string to translate
pt: Uma cadeia para traduzir

note: type: textblock
en: The reference of this string (i.e. position in inputfile)
pt: A referência desta cadeia (ou seja, em posição de ficheiro 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: O tipo desta cadeia (ou seja, a descrição textual do papel estrutural dele; usado em Locale::Po4a::Po::gettextization(); ver também L<po4a(7)|po4a.7>, secção B<Gettextization: como é que funciona?>)

note: type: textblock
en: This function can also take some extra arguments. They must be organized as a hash. For example:
pt: Esta função também pode ter alguns argumentos extras. Eles devem ser organizadas como uma 'hash'. Um 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: booleano que indica se podemos considerar que os espaços em branco na cadeia não são importantes. Se sim, a função canoniza a cadeia antes de procurar a tradução ou extraí-la e envolve a tradução.

note: type: textblock
en: an extra comment to add to the entry.
pt: um comentário adicional para a entrada.

note: type: textblock
en: Actions:
pt: Acões:

note: type: textblock
en: Pushes the string, reference and type to po_out.
pt: Coloca a cadeia de referência e tipo em 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: Retorna a tradução da cadeia (como encontrada em po_in), de modo que o analisador pode construir 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: Lida com os conjuntos de carateres para recodificar as cadeias antes de as enviar para po_out e antes de voltar às traduções.

note: type: =head2
en: Misc functions
pt: Funções diversas

note: type: textblock
en: Returns if the verbose option was passed during the creation of the TransTractor.
pt: Retorna se a opção 'verbose' foi aprovada durante a criação do TransTractor.

note: type: textblock
en: Returns if the debug option was passed during the creation of the TransTractor.
pt: Retorna se a opção de depuração foi aprovada durante a criação doTransTractor.

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: Esta função irá retornar o conjunto de carácteres, que deviam ser usados na saída (em geral, útil para substituir os conjuntos de carácteres detetados à entrada do documento onde 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: Ele vai usar o conjunto de carateres de saída especificado na linha de comando. Se não fosse especificado, será usado o conjunto de carateres PO de entrada e, se a entrada de PO tem o "charset" predefinido, irá retornar um conjunto de carácteres do documento de entrada, de modo a que nenhuma codificação é realizada.

note: type: =head1
en: FUTURE DIRECTIONS
pt: 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: Uma falha do TransTractor atual é que ele não pode tratar de documentos traduzidos a conter todas os idiomas, como modelos debconf, ou ficheiros desktops.

note: type: textblock
en: To address this problem, the only interface changes needed are:
pt: Para resolver este problema, as únicas mudanças na interface necessárias são:

note: type: textblock
en: take a hash as po_in_name (a list per language)
pt: obter 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: adicionar um argumento para traduzir para indicar a língua apontada

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: fazer uma função pushline_all, que deveria fazer pushline do conteúdo delepara todos idiomas, a usar uma sintaxe tipo mapa:

note: type: textblock
en: Will see if it's enough ;)
pt: Vai ver se é suficiente ;)

note: type: textblock
en: Locale::Po4a::Wml - convert WML (web markup language) documents from/to PO files
pt: Locale::Po4a::Wml - converte documentos WML (web markup language) de/a ficheiros 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: Locale::Po4a::Wml é um módulo para ajudar na tradução de documentos WML em outra língua [humana]. Não faça confusão com o WML que estamos a falar aqui (web markup language) e da porcaria WAP usado em telefones móveis.

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: Por favor note que este módulo conta com o módulo Locale::Po4a::Xhtml, que também conta com o módulo Locale::Po4a::Xml. Isto significa que todasas etiquetas para expressões de páginas web são assumidas, para 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: Este módulo funciona para alguns documentos simples, mas ainda é jovem. Atualmente, o maior problema do módulo é provavelmente que não pode lidar com documentos que não contêm etiquetas em linha de formatação XML, como <email "foo@example.org">, que são frequentemente definidos na WML. Melhorias serão adicionadas em futuros lançamentos.

note: type: textblock
en: Locale::Po4a::Xhtml - convert XHTML documents from/to PO files
pt: Locale::Po4a::Xhtml - converte documentos XHTML de/para ficheiros PO

note: type: textblock
en: Locale::Po4a::Xhtml is a module to help the translation of XHTML documents into other [human] languages.
pt: Locale::Po4a::Xhtml é um módulo para ajudar a tradução de documentos XHTMLem outras línguas [humanas].

note: type: textblock
en: Include files specified by an include SSI (Server Side Includes) element (e.g. <!--#include virtual="/foo/bar.html" -->).
pt: Incluí ficheiros especificados por um elemento SSI incluído (Server Side Includes) (por exemplo <!--#include virtual="/foo/bar.html" -->).

note: type: textblock
en: B<Note:> You should use it only for static files.
pt: B<Note:> Deve usá-lo apenas para ficheiros 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: Um parâmetro adicional I<rootpath> pode ser especificado. Especifica o caminho da raiz para encontrar ficheiros incluídos por um atributo B<virtual>.

note: type: textblock
en: Locale::Po4a::Xml - convert XML documents and derivates from/to PO files
pt: Locale::Po4a::Xml - converte documentos XML e derivados de/para ficheiros 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: Locale::Po4a::Xml é um módulo para ajudar a tradução de documentos XML em outro idioma [humano]. Também pode ser usado como uma base para a construção de módulos de documentos com base em XML.

note: type: =head1
en: TRANSLATING WITH PO4A::XML
pt: TRADUZIR 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: Este módulo pode ser usado diretamente para lidar com documentos XML genéricos. Isto irá extrair todo o conteúdo das etiquetas e, não atributos, já que é onde o texto é escrito na maioria dos documentos com base 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: Existem algumas opções (descrito na próxima secção), que podem personalizar este comportamento. Se isto não se encaixa no seu formato de documento que está encorajado a escrever o seu próprio módulo derivado deste, para descrever os detalhes do seu formato. Consulte a secção B<WRITING DERIVATE MODULES> abaixo, para 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: A opção de depuração global faz com que este módulo mostre as cadeia excluídas, para ver se ele ignora algo importante.

note: type: textblock
en: Prevents it to strip the spaces around the extracted strings.
pt: Impede-o para tirar os espaços em torno das cadeias 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: Canoniza a cadeia para traduzir, a considerar 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: Atributos são quebrados por predefinição. Essa opção desativa 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: Faz as etiquetas e atributos a procurar trabalhar de forma em maiúsculas e minúsculas. Se for definido, ele 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: Aspas de escapa em cadeias de saída.  Necessário, por exemplo, para criação de recursos de cadeias 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: 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: Quando definido, entidades externas estão incluídas no documento gerado (traduzido) e para a extração de cadeias. Se não for definido, vai 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: Esta opção define o comportamento do módulo quando ele encontrar uma sintaxe de XML inválida (uma etiqueta de fecho, que não coincide com a última etiqueta de abertura). Ele pode ter os seguintes valores:

note: type: textblock
en: This is the default value.  The module will exit with an error.
pt: Este é o valor predefinido. O módulo irá sair com um erro.

note: type: textblock
en: The module will continue, and will issue a warning.
pt: O módulo continuará e emitirá um aviso.

note: type: textblock
en: The module will continue without any warnings.
pt: O módulo vai continuar sem emitir um aviso.

note: type: textblock
en: Be careful when using this option.  It is generally recommended to fix the input file.
pt: Tenha cuidado ao usar esta opção. Recomenda-se geralmente para corrigir o ficheiro de entrada.

note: type: textblock
en: Note: This option is deprecated.
pt: Nota: Esta opção está 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: 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: A cadeias que vai tentar combinar com a primeira linha do doctype do documento (se definido). Se isso não acontecer, um aviso indicará que o documento poderá ser de 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: A cadeia a indicar o caminho (por exemplo, E<lt>bbbE<gt>E<lt>AAAE<gt>) de uma etiqueta onde um atributo lang="..." deve ser adicionado. O idioma será definido como o nome base do ficheiro PO sem qualquer extensão po.

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: 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: Nota: Esta opção está obsoleta. Deve usar as opções B<translated> e B<untranslated> em vez.

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: Lista de etiquetas separada por espaços que deseja traduzir ou ignorar. Por predefinição, as etiquetas especificadas serão excluídas, mas se usar a opção "tagsonly", etiquetas especificadas serão as únicas incluídas. As etiquetas devem estar em forma E<lt>aaaE<gt>, mas podem-se juntar a algum (E<lt>bbbE<gt>E<lt>aaaE<gt>) para dizer que o conteúdo da etiqueta E<lt>aaaE<gt> só será traduzido quando está numaetiqueta 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: Também pode especificar algumas opções de marcação para pôr alguns caracteres na frente da hierarquia de marcações. Por exemplo, pode pôr 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: Exemplo: WE<lt>chapterE<gt>E<lt>titleE<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: Lista de atributos das etiquetas separada por espaços que deseja traduzir. Pode especificar os atributos pelo nome deles (por exemplo, "lang"), mas pode prefixar com uma hierarquia de etiquetas, para especificar que este atributo só será traduzido quando está na etiqueta especificada. Por exemplo:E<lt>bbbE<gt>E<lt>aaaE<gt>lang especifica que o atributo lang só será traduzido se for em numa etiqueta E<lt>aaaE<gt> e é numa etiqueta 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: Não traduzir atributos em etiquetas em linha. Vez disso, substitua todos os atributos duma etiqueta 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: Isto é útil quando atributos não serão traduzidas, como isso simplifica as cadeias para tradutores e evita erros de digitação.

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: lista de etiquietas separadas por espaços que não deviam ser tratadas como etiquetas. Estas etiquetas são tradadas com em linha e, não precisam de ser fechadas.

note: type: textblock
en: Space-separated list of tags which should break the sequence.  By default, all tags break the sequence.
pt: Lisat de etiquetas separada por espaços que devem quebrar a sequência. Por predefinição, todas as etiquetas quebrar 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: As etiquetas devem estar na forma <aaa>, mas pode juntar algumas (<bbb><aaa>), se uma etiqueta (<aaa>) só deveria ser considerada quando está em outra etiqueta (<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: Note que uma marcação deve ser listada em apenas uma cadeia 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: Lista de etiquetas separada por espaços que devem ser tratados como em linha. Por predefinição todas as etiquetas quebram 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: Lista de etiquetas separadas por espaços que devem ser tratadas como espaços reservados. Os espaços reservados não quebram a sequência, mas o conteúdo dos espaços reservados é traduzido separadamente.

note: type: textblock
en: The location of the placeholder in its block will be marked with a string similar to:
pt: A localização do espaço reservado no bloco dele será marcado com uma cadeia semelhante 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: 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: lista de etiquetas separadas por espaço que o módulo não deve tentar definir por predefiniçã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: Se tiver uma marcação que tenha a configuração predefinida dela pela subclasse deste módulo, mas desejar definir uma configuração alternativa, será necessário listar essa marcação como parte da cadeia 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: Diretivas de suporte do pré-processador C. Quando esta opção está definida, po4a irá considerar as diretivas de pré-processamento como separadores de parágrafo. Isso é importante se o ficheiro XML deve ser processado, porque senão as directivas podem ser inseridas no meio de linhas se o po4a considerar que pertencem ao parágrafo corrente, que não será reconhecido pelo pré-processador. Nota: as directivas de pré-processamento só devem aparecer entre etiquetas (que não deve quebrar uma etiqueta).

note: type: textblock
en: Space-separated list of tags you want to translate.
pt: Listas de etiquetas separadas por espaços que quer 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: Também pode especificar algumas opções de marcação para por alguns caracteres na frente da hierarquia de marcações. Isso sobrescreve o comportamento predefinido 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: Etiquetas devem ser traduzidos e o conteúdo pode ser re-envolvido.

note: type: textblock
en: Tags should be translated and content should not be re-wrapped.
pt: Etiquetas devem ser traduzidos e o conteúdo não devia ser reenvolvido.

note: type: textblock
en: Tags should be translated inline.
pt: As etiquetas deverão ser traduzidas em linha.

note: type: textblock
en: Tags should be translated as placeholders.
pt: Etiquetas devem ser traduzidos em linha.

note: type: textblock
en: Internally, the XML parser only cares about these four options: I<w> I<W> I<i> I<p>.
pt: 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: * 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: * 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: * 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: * 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: Pode verificar o comportamento real do parâmetro interno a invocar 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: Note que uma marcação deve estar listada na cadeia de configuração B<translated> ou B<untranslated>.

note: type: textblock
en: Space-separated list of tags you do not want to translate.
pt: Listas de etiquetas separadas por espaços que não quer 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: Note que uma tag inline traduzível numa 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: As categorias predefinidas para etiquetas que não são nenhuns de: traduzidos, não traduzidos, partidos, em linha ou espaço reservado.

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: 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: ESCREVENDO MÓDULOS DERIVADOS

note: type: =head2
en: DEFINE WHAT TAGS AND ATTRIBUTES TO TRANSLATE
pt: DEFINIR QUE ETIQUETAS E ATRIBUTOS PARA TRADUÇÃO

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: A mais simples personalização é definir quais as etiquetas e atributos mais desejados para o analisador a traduzir. Isto deve ser feito na função 'initialize'. Primeiro, deve invocar o 'initialize' principal, para obter as opções de linha de comando e, em seguida, acrescentar as suas definições personalizadas para as opções de 'hash'. Se quiser tratar de algumas novas opções de linha de comando, deve defini-las antes invocar 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: 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 utilizadores sobrescrevam o comportamento predefinido definido no 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: Se não gostar do comportamento predefinido deste módulo xml e módulos derivados dele, poderá fornecer opções de linha de comando para alterar o comportamento deles.

note: type: textblock
en: See L<Locale::Po4a::Docbook(3pm)|Locale::Po4a::Docbook>,
pt: Veja L<Locale::Po4a::Docbook(3pm)|Locale::Po4a::Docbook>,

note: type: =head2
en: OVERRIDING THE found_string FUNCTION
pt: SUBSTITUINDO 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: Outro passo simples é substituir a função "found_string", que recebe as cadeias extraídas do analisador, a fim de traduzi-las. Lá pode controlar quais cadeias deseja traduzir e realizar neles as transformações antes ou depois da 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: Ele recebe o texto extraído, a referência de onde ele estava e um 'hash' que contém informações extras para controlar o que cadeias a traduzir, como traduzi-las e 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: O conteúdo dessas opções depende do tipo de cadeia é (especificado numa entrada do '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: A cadeia encontrada é o conteúdo de uma etiqueta traduzível. A entrada "tag_options" contém os carateres de opção na frente da hierarquia das etiquetas na opção do módulo "tags".

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: Significa que as cadeias encontradas é o valor de um atributo traduzível. A entrada "attribute" tem 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: Ela deve retornar o texto que irá substituir o original no documento traduzido. Aqui está um exemplo básico desta função:

note: type: textblock
en: There's another simple example in the new Dia module, which only filters some strings.
pt: Aqui está outro exemplo simples no novo módulo Dia , que só filtra algumas cadeias.

note: type: =head2
en: MODIFYING TAG TYPES (TODO)
pt: MODIFICANDO TIPOS DE ETIQUETAS (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: Este é mais complexo, mas permite uma personalização (quase) total. É baseado numa lista de 'hashes', cada um define o comportamento de um tipo de etiqueta. A lista deve ser ordenada para que as etiquetas mais gerais estão antes das mais concretas (ordenadas primeiro no início e, depois, pelas chaves de fecho). Para definir um tipo de etiqueta vai ter que fazer um hash com as seguintes chaves:

note: type: textblock
en: Specifies the beginning of the tag, after the "E<lt>".
pt: Especifice o princípio da etiqueta, depois de "E<lt>".

note: type: textblock
en: Specifies the end of the tag, before the "E<gt>".
pt: Especifice o fim da etiqueta, depois de "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: Ele diz que se esta é uma classe de etiquetas quebradas. Uma etiqueta não-quebrada (inline) é uma que pode ser tomada como parte do conteúdo de outra etiqueta. Pode levar o valor falso (0), verdadeiro (1) ou indefinido. Se deixá-lo indefinido, vai ter que definir a função f_breaking que vai dizer se uma etiqueta concreta desta classe é uma etiqueta de quebrar 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: É uma função que vai dizer se a próxima etiqueta é uma quebra ou não. Ele deve ser definido se a opção B<breaking> não é.

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: Se deixar esta chave indefinida, a função de extração de genéricos terá que extrair a etiqueta própria. É útil para as etiquetas que podem ter outras etiquetas ou estruturas especiais dentro deles, de modo que o analisador principal não fica louco. Esta função recebe um booleano que diz se a etiqueta deve ser removida do fluxo de entrada ou não.

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: Esta função recebe a etiqueta (no formato get_string_until()) e retorna a etiqueta traduzida (atributos traduzidos ou todos as necessárias transformações) como uma única sequência.

note: type: =head2
en: WORKING WITH TAGS
pt: TRABALHANDO COM ETIQUETAS

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: Esta função retorna o caminho para a etiqueta corrente a partir da raiz do documento na forma 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: Um conjunto adicional de etiquetas (sem parênteses) pode ser passado como argumento. Estes elementos de caminho são adicionados ao fim do caminho da corrente.

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: Esta função retorna o índice da lista tag_types que cabe na etiqueta seguinte no fluxo de entrada, ou -1, se é no fim do ficheiro 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: Aqui, a marcação 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: Isso funciona no vetor C<< @{$self->{TT}{doc_in}} >> a deter 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: Esta função retorna a próxima etiqueta do fluxo de entrada sem o início e o fim, numa forma de matriz, para manter as referências do ficheiro de entrada tem dois parâmetros: o tipo de etiqueta (como retornado por tag_type) e um booleano, que indica se deve ser removido a partir 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: Esta função retorna o nome da etiqueta passada como um argumento, no formulário da matriz retornada 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: Esta função retorna um booleano que diz que se a próxima etiqueta no fluxo de entrada é uma etiqueta quebrada ou não (etiqueta inline). Ele 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: Essa função converte a próxima etiqueta a partir do fluxo de entrada. Usando em cada etiqueta tipos personalizados de funções de traduçã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: Esta função retorna um valor de cadeia que diz que se o primeiro argumento (a hierarquia das etiquetas) corresponde a qualquer uma das etiquetas do segundo argumento (a lista de etiquetas ou a hierarquia). Se não corresponder, ele retorna 0. Caso contrário, retorna as opções de etiqueta correspondentes (os carateres de frente da etiqueta) ou 1 (se a etiqueta não tem opções).

note: type: =head2
en: WORKING WITH ATTRIBUTES
pt: 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: 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 cadeia simples com a marcação traduzida.

note: type: =head2
en: WORKING WITH TAGGED CONTENTS
pt: 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: Essa função obtém o texto até a próxima marcação de quebra (não em linha) do fluxo de entrada. Traduza-a a usar as funções de tradução personalizadas de cada tipo de marcação.

note: type: =head2
en: WORKING WITH THE MODULE OPTIONS
pt: TRABALHANDO COM OPÇÕES DE MÓDULOS

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: Esta função preenche as estruturas internas que contêm as etiquetas, atributos e dados em linha com as opções do módulo (especificado na linha de comando ou na função de inicialização).

note: type: =head2
en: GETTING TEXT FROM THE INPUT DOCUMENT
pt: OBTENÇÃO DE TEXTO A PARTIR 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: Esta função retorna uma matriz 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 desativado (a predefinição) e 1 ativado.

note: type: textblock
en: The valid options are:
pt: As opções válidas são:

note: type: textblock
en: This makes the returned array to contain the searched text
pt: Isto faz com que a matriz retornada contenha o texto procurado

note: type: textblock
en: This removes the returned stream from the input
pt: Isto remove o fluxo retornado a partir da entrada

note: type: textblock
en: This ensures that the searched text is outside any quotes
pt: Isto assegura que o text procurado está fora de qualquer citação

note: type: textblock
en: This denotes that the first argument is a regular expression rather than an plain string
pt: Isso indica que o primeiro argumento é uma expressão regular e não uma cadeia 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: Esta função recebe como argumento a referência a um parágrafo (no formato retornado por get_string_until), ignora os espaços de título dele e retorna-os como uma sequência simples.

note: type: textblock
en: This function returns a simple string with the text from the argument array (discarding the references).
pt: Esta função retorna uma cadeia simples com o texto do argumento da matriz (a descartar as referências).

note: type: textblock
en: This module can translate tags and attributes.
pt: Este módulo pode traduzir etiquetas e atributos.

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: Há um suporte mínimo para a tradução de entidades. Elas são traduzida como um todo e as etiquetas não são tidas em conta. As entidades multi linhas não são suportados e as entidades são sempre re-envolvidas durante a tradução.

note: type: textblock
en: MODIFY TAG TYPES FROM INHERITED MODULES (move the tag_types structure inside the $self hash?)
pt: MODIFICAR TIPOS DE ETIQUETAS A PARTIR DE MÓDULOS HERDADOS (move a estrutura tag_types dentro de hash $self hash?)

note: type: textblock
en: Locale::Po4a::Yaml - convert YAML files from/to PO files
pt: Locale::Po4a::Yaml - converte ficheiros YAML de/para ficheiros PO

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

note: type: textblock
en: The module extracts the value of YAML hashes and arrays. Hash keys are not extracted.
pt: 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: NOTA: Este módulo analisa o ficheiro YAML com YAML::Tiny.

note: type: textblock
en: Do not translate array values.
pt: Não traduz os valores de matrizes.
