Provided by: po4a_0.55-1_all bug

NOME

       Locale::Po4a::AsciiDoc - converte documentos AsciiDoc de/para arquivos PO

DESCRIÇÃO

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

       Locale::Po4a::AsciiDoc é um módulo para ajudar a tradução de documentação no formato
       AsciiDoc.

OPÇÕES ACEITAS POR ESTE MÓDULO

       Estas são as opções específicas deste módulo:

       definitions
           O nome de um arquivo contendo definições para o po4a, como definido na seção
           PERSONALIZAÇÃO INTEGRADA. Você pode usar esta opção se não for possível colocar as
           definições no documento que está sendo traduzido.

           Em um arquivo de definições, as linhas não podem começar com duas barras, e sim
           diretamente pelo po4a:.

       entry
           Lista separada por espaço das entradas de atributos que você deseja traduzir. Por
           padrão, nenhuma entrada de atributo é traduzida.

       macro
           Lista separada por espaço das definições de macro.

       style
           Lista separada por espaço das definições de estilos.

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

PERSONALIZAÇÃO INTEGRADA

       O módulo AsciiDoc pode ser personalizado com linhas começando com //po4a:. Estas linhas
       são interpretadas como comandos para analisar. Os seguintes comandos são reconhecidos:

       //po4a: macro nome[lista de atributos]
           Isso permite descrever em detalhes os parâmetros de uma macro; nome deve ser um nome
           de macro válida e termina com um sublinhado se o alvo deve ser traduzido.

           O argumento 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.

           Se um sinal de mais (+) é prefixo de nome, então a macro e seus argumentos são
           traduzidos como um todo. Não há necessidade de definir uma lista de atributos neste
           caso, mas colchetes devem estar presentes.

       //po4a: estilo [lista de atributos]
           Isso permite descrever em detalhes quais atributos de um estilo deve ser traduzido.

           O argumento 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.

           Se um sinal de mais (+) é prefixo do nome do estilo, então a lista de atributos é
           traduzida como um todo. Não há necessidade de definir atributos traduzíveis.

           Se um sinal de menos (-) é prefixo do nome do estilo, então este atributo não é
           traduzido.

       //po4a: entrada nome
           Isso declara uma entrada de atributo como sendo traduzível. Por padrão, eles não estão
           traduzidos.

ESTADO DESTE MÓDULO

       Testado com sucesso em arquivos AsciiDoc simples.

AUTORES

        Nicolas François <nicolas.francois@centraliens.net>
        Denis Barbier <barbier@linuxfr.org>

COPYRIGHT E LICENÇA

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

       Esse programa é um software livre; você pode redistribuí-lo e/ou modificá-lo sob os termos
       da GPL (veja o arquivo COPYING).