.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man v6.0.2 (Pod::Simple 3.45) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" \*(C` and \*(C' are quotes in nroff, nothing in troff, for use with C<>. .ie n \{\ . ds C` "" . ds C' "" 'br\} .el\{\ . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Required to disable full justification in groff 1.23.0. .if n .ds AD l .\" ======================================================================== .\" .IX Title "LOCALE::PO4A::SIMPLEPOD.3PM 1" .TH LOCALE::PO4A::SIMPLEPOD.3PM 1 2025-11-22 "perl v5.42.0" "User Contributed Perl Documentation" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .PP 1; .PP _\|_END_\|_ .SH NOME .IX Header "NOME" Locale::Po4a::SimplePod \- converte dados POD de/para arquivos PO, com Pod::Simple .SH SINOPSE .IX Header "SINOPSE" .Vb 2 \& [po4a_paths] /caminho/para/pot $lang:/caminho/para/po \& [type:SimplePod] /caminho/para/fonte.pod $lang:/caminho/para/localizado.pod .Ve .PP ou .PP .Vb 3 \& [po4a_paths] /caminho/para/pot $lang:/caminho/para/po \& [po4a_alias:pod] SimplePod \& [type:pod] /caminho/para/fonte.pod $lang:/caminho/para/localizado.pod .Ve .SH DESCRIÇÃO .IX Header "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. .PP As principais diferenças entre o formato Pod atual e o formato SimplePod são as seguintes: .IP \(bu 4 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. .IP \(bu 4 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. .IP \(bu 4 No SimplePod, a mensagem \f(CW\*(C`=for\*(C'\fR (por exemplo, \f(CW\*(C`=for comment text\*(C'\fR) não inclui um nome de formato (como \f(CW\*(C`comment\*(C'\fR), portanto, a mensagem consiste apenas em texto. Em contraste, o formato Pod atual mantém o nome do formato, resultando em uma mensagem como \f(CW\*(C`comment text\*(C'\fR. O comportamento anterior é considerado mais confortável para tradutores. .IP \(bu 4 Entradas como a abaixo, que denotam \f(CW\*(C`=end comment\*(C'\fR, 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. .Sp .Vb 4 \& #. type: =end \& #: sample.pod:10 \& msgid "comment" \& msgstr "" .Ve .IP \(bu 4 Blocos de texto cuja validade do formato POD é incerta agora são tratados como \f(CW\*(C`no\-wrap\*(C'\fR. Isso se aplica, por exemplo, ao conteúdo dentro de um bloco \&\f(CW\*(C`=begin html\*(C'\fR. No módulo Pod, eles não eram tratados como \f(CW\*(C`no\-wrap\*(C'\fR, o que às vezes resultava em quebra de linha. .IP \(bu 4 A seção de parâmetros \f(CW\*(C`=begin\*(C'\fR 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. .SH "ESTADO DESTE MÓDULO" .IX Header "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. .PP 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. .PP 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 \&\f(CW\*(C`Pod::Parser\*(C'\fR" . .SH "VEJA TAMBÉM" .IX Header "VEJA TAMBÉM" Pod::Simple, Locale::Po4a::Pod, Locale::Po4a::TransTractor, \&\fBpo4a\fR\|(7), Locale::Po4a::SimplePod::Parser. .SH AUTORES .IX Header "AUTORES" .Vb 1 \& gemmaro .Ve .SH TRADUÇÃO .IX Header "TRADUÇÃO" .Vb 2 \& Luiz Fernando Ranghetti \& Rafael Fontenelle .Ve .SH "COPYRIGHT E LICENÇA" .IX Header "COPYRIGHT E LICENÇA" .Vb 1 \& Copyright (C) 2025 gemmaro . .Ve .PP 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).