LOCALE::PO4A::ASCIIDOC.3PM(1) User Contributed Perl Documentation NOME Locale::Po4a::AsciiDoc - converte documentos AsciiDoc de/para arquivos PO DESCRICAO O objetivo do projeto po4a (PO for anything, ou PO para qualquer coisa) e facilitar traducoes (e o mais interessante, a manutencao das traducoes) usando as ferramentas do gettext em areas em que nao se esperava, como documentacao. Locale::Po4a::AsciiDoc e um modulo para ajudar a traducao de documentacao no formato AsciiDoc. OPCOES ACEITAS POR ESTE MODULO Estas sao as opcoes especificas deste modulo: definitions O nome de um arquivo contendo definicoes para o po4a, como definido na secao PERSONALIZACAO INTEGRADA. Voce pode usar esta opcao se nao for possivel colocar as definicoes no documento que esta sendo traduzido. Em um arquivo de definicoes, as linhas nao podem comecar com duas barras, e sim diretamente pelo po4a:. entry Lista separada por espaco das entradas de atributos que voce deseja traduzir. Por padrao, nenhuma entrada de atributo e traduzida. macro Lista separada por espaco das definicoes de macro. style Lista separada por espaco das definicoes de estilos. forcewrap Habilita a quebra automatica de linha em blocos de texto nao literais, mesmo que o resultado possa ser mal interpretado pelos formatadores AsciiDoc. Por padrao, po4a nao aplicara a quebra os arquivos AsciiDoc produzidos porque uma inspecao manual e obrigatoria para garantir que o quebra nao altere a formatacao. Considere, por exemplo, o seguinte item da lista: * uma frase longa que termina com um numero 1. Uma segunda frase. Se a quebra levar a apresentacao a seguir, o item sera dividido em uma sub-lista numerada. Para piorar as coisas, apenas os falantes do idioma usado na traducao podem inspecionar a situacao. * uma longa frase que esta terminando com um numero 1. Uma segunda frase. Observe que nao fazer quebra os arquivos produzidos pelo po4a nao deve ser um problema, uma vez que esses arquivos devem ser processados automaticamente. Eles nao devem ser considerados como arquivos fonte de qualquer maneira. Com esta opcao, o po4a produzira arquivos AsciiDoc mais apresentaveis, mas pode levar a saidas com formatacao possivelmente erronea. noimagetargets Por padrao, os alvos das imagens de bloco sao traduziveis para dar oportunidade de fazer com que o conteudo aponte para imagens traduzidas. Isso pode ser impedido configurando essa opcao. tablecells Essa e uma opcao que permite segmentacao de uma subtabela em conteudo de celula. A segmentacao esta limitada a conteudo de celula, sem qualquer analise de que esta dentro. compat Muda as regras de analise para compatibilidade com diferentes ferramentas. As opcoes disponiveis sao "asciidoc" ou "asciidoctor". O Asciidoctor possui regras de analise mais rigidas, como a igualdade do comprimento das aberturas dos blocos de abertura e fechamento. nolinting Desativa mensagens lintagem. Quando o codigo-fonte nao pode ser corrigido para uma estrutura de documento mais clara, essas mensagens sao inuteis. cleanspaces Remove extra spaces from the source segments in no-wrap mode. This is useful when the translation tools are sensitive to the number of spaces. yfm_keys Lista separada por virgula de chaves para processar para traducao na secao YAML Front Matter. Todas as outras chaves sao ignoradas. As chaves sao combinadas com uma correspondencia que diferencia maiusculas de minusculas. Se yfm_paths e yfm_keys forem usadas juntas, os valores serao incluidos se forem correspondidos por pelo menos uma das opcoes. Os valores das matrizes sempre sao traduzidos, a menos que a opcao yfm_skip_array seja fornecida. yfm_skip_array Nao traduz os valores de vetor na secao YAML Front Matter. yfm_paths Lista separada por virgula de caminhos hash para processar para extracao na secao YAML Front Matter; todos os outros caminhos sao ignorados. Os caminhos sao combinados com uma correspondencia que diferencia maiusculas de minusculas. Se yfm_paths e yfm_keys forem usadas juntas, os valores serao incluidos se forem correspondidos por pelo menos uma das opcoes. Os valores das matrizes sempre sao retornados, a menos que a opcao yfm_skip_array seja fornecida. PERSONALIZACAO INTEGRADA O modulo AsciiDoc pode ser personalizado com linhas comecando com //po4a:. Estas linhas sao interpretadas como comandos para analisar. Os seguintes comandos sao reconhecidos: //po4a: macro nome[lista de atributos] Isso descreve em detalhe os parametros de uma macro; nome deve ser um nome de macro valida e termina com um sublinhado se o alvo deve ser traduzido. O argumento lista de argumentos e uma lista separada por virgulas que contem informacoes sobre argumentos traduziveis. Esta lista contem numeros, para definir parametros posicionais, ou atributos nomeados. Se um sinal de mais (+) e prefixo de nome, entao a macro e seus argumentos sao traduzidos como um todo. Nao ha necessidade de definir uma lista de atributos neste caso, mas colchetes devem estar presentes. //po4a: estilo [lista de atributos] Isso descreve em detalhe quais atributos de um estilo deve ser traduzido. O argumento lista de argumentos e uma lista separada por virgulas que contem informacoes sobre argumentos traduziveis. Esta lista contem numeros, para definir parametros posicionais, ou atributos nomeados. O primeiro atributo e o nome do estilo e nao sera traduzido. Se um sinal de mais (+) e prefixo do nome do estilo, entao a lista de atributos e traduzida como um todo. Nao ha necessidade de definir atributos traduziveis. Se um sinal de menos (-) e prefixo do nome do estilo, entao este atributo nao e traduzido. //po4a: entrada nome Isso declara uma entrada de atributo como sendo traduzivel. Por padrao, eles nao estao traduzidos. ESTADO DESTE MODULO Testado com sucesso em arquivos AsciiDoc simples. AUTORES Nicolas Francois Denis Barbier COPYRIGHT E LICENCA Copyright (C) 2005-2008 Nicolas FRANCOIS . Copyright (C) 2012 Denis BARBIER . Copyright (C) 2017 Martin Quinson . Esse programa e um software livre; voce pode redistribui-lo e/ou modifica-lo sob os termos da GPL v2.0 ou posterior (veja o arquivo COPYING). perl v5.38.2 2024-06-26 LOCALE::PO4A::ASCIIDOC.3PM(1)