NOME

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

DESCRIÇÃO

       A missão do projeto po4a (em inglês, PO for anything) é facilitar as traduções (e o mais interessante, a
       manutenção de traduções) usando ferramentas de gettext em áreas onde elas não eram esperadas, 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.

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 por Nicolas FRANÇOIS <nicolas.francois@centraliens.net>.
        Copyright 2012 por Denis BARBIER <barbier@linuxfr.org>.
        Copyright 2017 por 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).

Ferramentas do Po4a                                2017-08-26                        Locale::Po4a::AsciiDoc(3pm)