Scroll to navigation

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