LOCALE::PO4A::TEXT.3PM(1) User Contributed Perl Documentation NOME Locale::Po4a::Text - converte documentos de texto 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::Text e um modulo para ajudar na traducao de documentos de texto em outras linguas [humanas]. Os paragrafos sao divididos em linhas vazias (ou linhas que contem apenas espacos ou tabulacoes). Se um paragrafo contem uma linha iniciada por um espaco (ou tabulacao), este paragrafo nao sera re-envolvido. OPCOES ACEITES POR ESTE MODULO Estas sao as opcoes particulares deste modulo: keyvalue Trata como literais os paragrafos que se parecem com um par de valores-chave separados por dois pontos (com o sinalizador "no-wrap" no ficheiro PO). Uma cadeia de par de valores-chave e uma cadeia como "key: value", contendo um ou mais caracteres diferentes de dois pontos e nao de espaco seguidos por dois pontos seguidos por pelo menos um caractere nao espacial antes do final da linha. nobullets Desativar a deteccao de 'bullets'. Por predefinicao, quando um marcador e detetado, um paragrafo de marcador nao e considerado como um paragrafo literal (com a opcao "no-wrap" no ficheiro PO). Em vez disso, realiza-se nova quebra de linha no paragrafo correspondente na traducao. tabs=mode Especifica como tabulacoes devem ser tratadas. O mode pode ser qualquer um de: split Linhas com tabulacoes apresentam quebras no paragrafo atual. verbatim Paragrafo a conter tabulacoes nao sera re-envolvido. Por predefinicao, tabulacoes sao consideradas como espacos. breaks=regex Uma expressao regular correspondente a linhas que introduzem pausas. A regular expressao sera ancorada de forma que toda a linha deve corresponder. debianchangelog Manipula o cabecalho e rodape das versoes de lancamento, que so podem conter informacoes nao traduziveis. fortunes Lida com o formato 'fortunes', que separa as 'fortunes' com uma linha que consiste em '%' ou '%%', e usa '%%' como o inicio de um comentario. markdown Lida com alguma marcacao especial em textos formatados em Markdown. yfm_keys (somente Markdown) 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_lenient (somente Markdown) Permite que o analisador YAML Front Matter falhe em cabecalhos malformados. Isto e particularmente util quando o seu ficheiro comeca com uma regua horizontal em vez de YAML Front Matter, mas insiste em usar tres tracos apenas para a sua regua. yfm_paths (somente Markdown) 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. yfm_skip_array (somente Markdown) Nao traduz os valores de vetor na seccao YAML Front Matter. control[=field_list] Lida com ficheiros control do Debian. Pode ser fornecida uma lista separada por virgulas com os campos a serem traduzidos. neverwrap Evita que po4a faca a quebra de qualquer linha. Isso significa que todo conteudo e tratado literalmente, ate mesmo paragrafos simples. ESTADO DESTE MODULO Testado com sucesso em ficheiros de texto simples e ficheiros NEWS.Debian. AUTORES Nicolas Francois DIREITOS DE AUTOR E LICENCA Copyright (C) 2005-2008 Nicolas FRANCOIS . Copyright (C) 2008-2009, 2018 Jonas Smedegaard . Copyright (C) 2020 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::TEXT.3PM(1)