LOCALE::PO4A::SIMPLEPOD.3PM(1) User Contributed Perl Documentation 1; __END__ NOME Locale::Po4a::SimplePod - converte dados POD de/para arquivos PO, com Pod::Simple SINOPSE [po4a_paths] /caminho/para/pot $lang:/caminho/para/po [type:SimplePod] /caminho/para/fonte.pod $lang:/caminho/para/localizado.pod ou [po4a_paths] /caminho/para/pot $lang:/caminho/para/po [po4a_alias:pod] SimplePod [type:pod] /caminho/para/fonte.pod $lang:/caminho/para/localizado.pod DESCRICAO Este e um modulo para ajudar a traducao de documentacao no formato POD (a linguagem preferido para documentar Perl) para outros idiomas. As principais diferencas entre o formato Pod atual e o formato SimplePod sao as seguintes: o O formato SimplePod nunca inclui quebras de linha adicionais em mensagens a serem traduzidas. O formato Pod atual, no entanto, pode conter quebras de linha extras, principalmente em entradas de mensagens literais. o Paragrafos podem ser renderizados com quebra de linha. O modulo Pod::Parser pode aplicar um tratamento especial para quebra de linha, dificultando a replicacao com Pod::Simple. No entanto, Pod::Simple parece produzir uma saida mais natural. o No SimplePod, a mensagem "=for" (por exemplo, "=for comment text") nao inclui um nome de formato (como "comment"), portanto, a mensagem consiste apenas em texto. Em contraste, o formato Pod atual mantem o nome do formato, resultando em uma mensagem como "comment text". O comportamento anterior e considerado mais confortavel para tradutores. o Entradas como a abaixo, que denotam "=end comment", nao estao mais presentes como visto no modulo Pod atual. Como essas mensagens nao sao traduziveis, sua ausencia e uma melhoria. #. type: =end #: sample.pod:10 msgid "comment" msgstr "" o Blocos de texto cuja validade do formato POD e incerta agora sao tratados como "no-wrap". Isso se aplica, por exemplo, ao conteudo dentro de um bloco "=begin html". No modulo Pod, eles nao eram tratados como "no-wrap", o que as vezes resultava em quebra de linha. o A secao de parametros "=begin" nao esta mais sujeita a traducao. No modulo Pod atual, ela esta incluida. Se houver demanda para inclui-la na traducao, por favor, informe. ESTADO DESTE MODULO Este modulo ainda e um modulo recem-desenvolvido, portanto, e menos estavel que o Locale::Po4a::Pod. Ele continua a evoluir e ha espaco para mais refinamentos. Seu comportamento pode mudar com o tempo, e opcoes adicionais podem ser introduzidas para otimizar melhor a experiencia de traducao para os usuarios. Feedbacks e casos de uso de aplicacoes reais desempenharao um papel fundamental na orientacao de seu desenvolvimento futuro. O codigo e totalmente coberto pelo nosso conjunto de testes e nao temos conhecimento de nenhum bug existente. No entanto, ate 2025, ele nao havia sido testado em fluxos de trabalho de traducao reais por projetos externos. Dito isso, acreditamos que o modulo esta pronto para uso em producao, mesmo que alguns bugs possam ser inevitavelmente descobertos a medida que for sendo adotado mais amplamente. This module is intended to replace the current Locale::Po4a::Pod module. The reason is that Pod::Parser, which is used by the current Locale::Po4a::Pod, is now deprecated, and it is recommended to use Pod::Simple instead. See also GitHub issue #256 "Consider migrating away from deprecated "Pod::Parser"" . VEJA TAMBEM Pod::Simple, Locale::Po4a::Pod, Locale::Po4a::TransTractor, po4a(7), Locale::Po4a::SimplePod::Parser. AUTORES gemmaro TRADUCAO Luiz Fernando Ranghetti Rafael Fontenelle COPYRIGHT E LICENCA Copyright (C) 2025 gemmaro . 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.42.0 2025-11-22 LOCALE::PO4A::SIMPLEPOD.3PM(1)