LOCALE::PO4A::ASCIIDOC.3PM(1) User Contributed Perl Documentation NOME Locale::Po4a::AsciiDoc - converte documentos AsciiDoc de/para ficheiros PO DESCRICAO O objetivo do projeto po4a (PO for anything: PO para qualquer coisa) e facilitar traducoes (e o mais interessante, a manutencao das traducoes) a usar as ferramentas do gettext em areas em que nao se esperava, como na documentacao. Locale::Po4a::AsciiDoc e um modulo para ajudar a traducao de documentacao no formato AsciiDoc. OPCOES ACEITES POR ESTE MODULO Estas sao as opcoes particulares deste modulo: definitions O nome de um ficheiro que contem as definicoes para po4a, como definido na seccao INLINE CUSTOMIZATION. Pode usar esta opcao se nao e possivel por as definicoes no documento a ser traduzido. Num ficheiro de definicoes, as linhas nao podem comecar com duas barras e sim diretamente pelo po4a:. entry Lista separada por espacos das entradas de atributos que deseja traduzir. Por predefinicao, 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 Ativar a quebra de linha automatica em blocos nao verbais, mesmo que o resultado possa ser mal interpretado pelos formatadores AsciiDoc. Por predefinicao, o po4a nao quebra os ficheiros AsciiDoc produzidos, porque uma inspecao manual e necessaria para garantir que a quebra nao altera a formatacao. Considere, por exemplo, o seguinte item da lista: * uma frase comprida, que termina com um numero 1. Uma segunda frase. Se este envolver levar a seguinte apresentacao, o item e dividido numa sub-lista numerada. Para piorar a situacao, apenas os falantes do idioma utilizado na traducao podem inspecionar a situacao. * uma frase comprida que termina com um numero 1. Uma segunda frase. Note que nao embrulhar os ficheiros produzidos pelo po4a nao deve ser um problema, uma vez que esses ficheiros devem ser processados automaticamente. Eles nao devem ser considerados como ficheiros fonte de qualquer forma. Com esta opcao, o po4a produzira ficheiros AsciiDoc mais apresentaveis, mas pode levar a saidas com formatacao possivelmente erronea. noimagetargets Por predefinicao, 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 ao configurar esta opcao. tablecells Esta opcao e um sinalizador que permite a segmentacao de sub-tabelas em conteudo das celulas. A segmentacao e limitada ao conteudo da celula, sem qualquer analise dentro dele. compat Muda as regras de analise para compatibilidade com ferramentas diferentes. 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 fecho. nolinting Desativa mensagens em fiapos. Quando o codigo-fonte nao pode ser corrigido para uma estrutura de documento mais clara, essas mensagens sao inuteis. cleanspaces Remove espacos extras dos segmentos da fonte no modo no-wrap. Isto e util quando as ferramentas de traducao sao sensiveis ao numero de espacos. yfm_keys Lista separada por virgula de chaves para processar para traducao na seccao 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 seccao YAML Front Matter. yfm_paths Lista separada por virgulas de caminhos hash para processar para extracao na seccao 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 EM LINHA O modulo AsciiDoc pode ser personalizado com linhas a comecar 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 prefixado ao nome, entao a macro e os argumentos dele sao traduzidos como um todo. Nao ha necessidade de definir uma lista de atributos neste caso, mas colchetes devem estar presentes. //po4a: style [lista de atributos] Isso descreve em detalhe quais atributos de um estilo devem ser traduzidos. O argumento lista de atributos 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 (+) for prefixado ao 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 (-) for prefixado ao nome do estilo, entao este atributo nao e traduzido. Se um sinal de percentagem (%) for acrescentado ao nome do estilo, entao o estilo e processado como literalmente. As linhas em paragrafo ou bloco de tal estilo sao apresentadas nos ficheiros po e as entras correspondentes sao marcadas como no-wrap. //po4a: entry nome Isso declara uma entrada de atributo como sendo traduzivel. Por predefinicao nao estao traduzidos. ESTADO DESTE MODULO Testado com sucesso em ficheiros AsciiDoc simples. AUTORES Nicolas Francois Denis Barbier DIREITOS DE AUTOR E LICENCA Copyright (C) 2005-2008 Nicolas FRANCOIS . Copyright (C) 2012 Denis BARBIER . Copyright (C) 2017 Martin Quinson . Este programa e um software livre; pode redistribui-lo e/ou modifica-lo sob os termos da GPL v2.0 ou posterior (veja o ficheiro COPYING). perl v5.42.0 2025-11-22 LOCALE::PO4A::ASCIIDOC.3PM(1)