table of contents
LOCALE::PO4A::SIMPLEPOD.3PM(1) | User Contributed Perl Documentation | LOCALE::PO4A::SIMPLEPOD.3PM(1) |
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
DESCRIÇÃO¶
Este é um módulo para ajudar a tradução de documentação no formato POD (a linguagem preferido para documentar Perl) para outros idiomas.
As principais diferenças entre o formato Pod atual e o formato SimplePod são as seguintes:
- 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.
- Parágrafos podem ser renderizados com quebra de linha. O módulo Pod::Parser pode aplicar um tratamento especial para quebra de linha, dificultando a replicação com Pod::Simple. No entanto, Pod::Simple parece produzir uma saída mais natural.
- No SimplePod, a mensagem "=for" (por exemplo, "=for comment text") não inclui um nome de formato (como "comment"), portanto, a mensagem consiste apenas em texto. Em contraste, o formato Pod atual mantém o nome do formato, resultando em uma mensagem como "comment text". O comportamento anterior é considerado mais confortável para tradutores.
- Entradas como a abaixo, que denotam "=end
comment", não estão mais presentes como visto no
módulo Pod atual. Como essas mensagens não são
traduzíveis, sua ausência é uma melhoria.
#. type: =end #: sample.pod:10 msgid "comment" msgstr ""
- Blocos de texto cuja validade do formato POD é incerta agora são tratados como "no-wrap". Isso se aplica, por exemplo, ao conteúdo dentro de um bloco "=begin html". No módulo Pod, eles não eram tratados como "no-wrap", o que às vezes resultava em quebra de linha.
- A seção de parâmetros "=begin" não está mais sujeita à tradução. No módulo Pod atual, ela está incluída. Se houver demanda para incluí-la na tradução, por favor, informe.
ESTADO DESTE MÓDULO¶
Este módulo ainda é um módulo recém-desenvolvido, portanto, é menos estável que o Locale::Po4a::Pod. Ele continua a evoluir e há espaço para mais refinamentos. Seu comportamento pode mudar com o tempo, e opções adicionais podem ser introduzidas para otimizar melhor a experiência de tradução para os usuários. Feedbacks e casos de uso de aplicações reais desempenharão um papel fundamental na orientação de seu desenvolvimento futuro.
O código é totalmente coberto pelo nosso conjunto de testes e não temos conhecimento de nenhum bug existente. No entanto, até 2025, ele não havia sido testado em fluxos de trabalho de tradução reais por projetos externos. Dito isso, acreditamos que o módulo está pronto para uso em produção, mesmo que alguns bugs possam ser inevitavelmente descobertos à 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"" <https://github.com/mquinson/po4a/issues/256>.
VEJA TAMBÉM¶
Pod::Simple, Locale::Po4a::Pod, Locale::Po4a::TransTractor, po4a(7), Locale::Po4a::SimplePod::Parser.
AUTORES¶
gemmaro <gemmaro.dev@gmail.com>
TRADUÇÃO¶
Luiz Fernando Ranghetti <elchevive@opensuse.org> Rafael Fontenelle <rafaelff@gnome.org>
COPYRIGHT E LICENÇA¶
Copyright (C) 2025 gemmaro <gemmaro.dev@gmail.com>.
Esse programa é um software livre; você pode redistribuí-lo e/ou modificá-lo sob os termos da GPL v2.0 ou posterior (veja o arquivo COPYING).
2025-09-14 | perl v5.40.1 |