LOCALE::PO4A::SIMPLEPOD.3PM(1) User Contributed Perl Documentation 1; __END__ NOME Locale::Po4a::SimplePod - converte dados POD de/para ficheiros PO, com Pod::Simple RESUMO [po4a_paths] /path/to/pot $lang:/path/to/po [type:SimplePod] /path/to/source.pod $lang:/path/to/localized.pod ou [po4a_paths] /path/to/pot $lang:/path/to/po [po4a_alias:pod] SimplePod [type:pod] /path/to/source.pod $lang:/path/to/localized.pod DESCRICAO Isto e um modulo para ajudar a traducao da documentacao em formato POD (o idioma preferido para documentar Perl) em outras linguas humanas. As principais diferencas entre o formato Pod atual e o formato SimplePod sao as seguintes: o O formato SimplePod nunca inclui novas linhas adicionais nas mensagens a traduzir. O formato Pod atual, no entanto, pode conter novas linhas extra, em particular em entradas de mensagens literais. o Paragrafos podem ser renderizados com dobragem de linha. O modulo Pod::Parser pode aplicar manuseamento especial para dobragem de linha, tornando isso dificil de replicar com o Pod::Simple. No entanto, o Pod::Simple parece produzir resultados mais naturais . o No SimplePod, a mensagem "=for" (ex. "=for comment text") nao inclui um nome de formato (tal como "comment"), assim a mensagem consiste apenas de texto. Em contraste, o formato Pod atual retem o nome de formato, resultando numa mensagem tipo "comment text". O comportamento anterior e considerado mais confortavel para tradutores. o Entradas como a de baixo, que denotam "=end comment", ja nao estao presentes como se via no modulo Pod atual. Como estas nao sao mensagens traduziveis, a sua ausencia e uma melhoria. #. type: =end #: sample.pod:10 msgid "comment" msgstr "" o Blocos de texto cuja validade do formato POD e incerta sao agora tradados como "no-wrap". Isto aplica-se, por exemplo, ao conteudo dentro de um bloco "=begin html". No modulo Pod, estes nao eram tratados como "no-wrap", o que por vezes resultava em dobragem de linha. o A seccao parametro "=begin" nao e mais sujeita a traducao. No modulo Pod atual, e incluida. Se existir uma obrigacao de a incluir na traducao, por favor reporte isso. ESTADO DESTE MODULO Este modulo e ainda um novo desenvolvimento, assim menos estavel que o Locale::Po4a::Pod. Ele continua a evoluir, e ha espaco para mais melhoramentos. O seu comportamento pode mudar com o tempo, e podem ser introduzidas opcoes adicionais para melhor optimizar a experiencia de traducao para os utilizadores. O feedback e casos de uso de aplicacoes do mundo real irao ter um papel chave em guiar o seu futuro desenvolvimento. O codigo e totalmente coberto pela nossa suite de teste, e nao conhecemos nenhuns bugs existentes. No entanto, ate 2025, nao foi testado na batalha de fluxos de trabalho de traducoes no mundo real por projetos externos. Dito isto, acreditamentos que o modulo esta pronto para uso produtivo, mesmo que alguns bugs sejam inevitavelmente descobertos ao ganhar uma adocao mais ampla. Este modulo destina-se a substituir o atual modulo Locale::Po4a::Pod. A razao e que Pod::Parser, o qual e usado pelo actual Locale::Po4a::Pod, esta agora descontinuado, e e recomendado usar Pod::Simple em vez deste. Veja tambem 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 DIREITOS DE AUTOR E LICENCA Copyright (C) 2025 gemmaro . 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::SIMPLEPOD.3PM(1)