.\" -*- 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 ficheiros PO, com Pod::Simple .SH RESUMO .IX Header "RESUMO" .Vb 2 \& [po4a_paths] /path/to/pot $lang:/path/to/po \& [type:SimplePod] /path/to/source.pod $lang:/path/to/localized.pod .Ve .PP ou .PP .Vb 3 \& [po4a_paths] /path/to/pot $lang:/path/to/po \& [po4a_alias:pod] SimplePod \& [type:pod] /path/to/source.pod $lang:/path/to/localized.pod .Ve .SH DESCRIÇÃO .IX Header "DESCRIÇÃO" Isto é um módulo para ajudar a tradução da documentação em formato POD (o idioma preferido para documentar Perl) em outras línguas humanas. .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 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. .IP \(bu 4 Parágrafos podem ser renderizados com dobragem de linha. O módulo Pod::Parser pode aplicar manuseamento especial para dobragem de linha, tornando isso difícil de replicar com o Pod::Simple. No entanto, o Pod::Simple parece produzir resultados mais naturais . .IP \(bu 4 No SimplePod, a mensagem \f(CW\*(C`=for\*(C'\fR (ex. \f(CW\*(C`=for comment text\*(C'\fR) não inclui um nome de formato (tal como \f(CW\*(C`comment\*(C'\fR), assim a mensagem consiste apenas de texto. Em contraste, o formato Pod atual retêm o nome de formato, resultando numa mensagem tipo \f(CW\*(C`comment text\*(C'\fR. O comportamento anterior é considerado mais confortável para tradutores. .IP \(bu 4 Entradas como a de baixo, que denotam \f(CW\*(C`=end comment\*(C'\fR, já não estão presentes como se via no módulo Pod atual. Como estas não são mensagens traduzíveis, a 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 são agora tradados como \f(CW\*(C`no\-wrap\*(C'\fR. Isto aplica\-se, por exemplo, ao conteúdo dentro de um bloco \f(CW\*(C`=begin html\*(C'\fR. No módulo Pod, estes não eram tratados como \&\f(CW\*(C`no\-wrap\*(C'\fR, o que por vezes resultava em dobragem de linha. .IP \(bu 4 A secção parâmetro \f(CW\*(C`=begin\*(C'\fR não é mais sujeita a tradução. No módulo Pod atual, é incluída. Se existir uma obrigação de a incluir na tradução, por favor reporte isso. .SH "ESTADO DESTE MÓDULO" .IX Header "ESTADO DESTE MÓDULO" Este módulo é ainda um novo desenvolvimento, assim menos estável que o Locale::Po4a::Pod. Ele continua a evoluir, e há espaço para mais melhoramentos. O seu comportamento pode mudar com o tempo, e podem ser introduzidas opções adicionais para melhor optimizar a experiência de tradução para os utilizadores. O feedback e casos de uso de aplicações do mundo real irão ter um papel chave em guiar o seu futuro desenvolvimento. .PP O código é totalmente coberto pela nossa suite de teste, e não conhecemos nenhuns bugs existentes. No entanto, até 2025, não foi testado na batalha de fluxos de trabalho de traduções no mundo real por projetos externos. Dito isto, acreditamentos que o módulo está pronto para uso produtivo, mesmo que alguns bugs sejam inevitavelmente descobertos ao ganhar uma adoção mais ampla. .PP Este módulo destina\-se a substituir o atual módulo Locale::Po4a::Pod. A razão é que Pod::Parser, o qual é usado pelo actual Locale::Po4a::Pod, está agora descontinuado, e é recomendado usar Pod::Simple em vez deste. Veja também 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 "DIREITOS DE AUTOR E LICENÇA" .IX Header "DIREITOS DE AUTOR E LICENÇA" .Vb 1 \& Copyright (C) 2025 gemmaro . .Ve .PP Este programa é um software livre; pode redistribuí\-lo e/ou modificá\-lo sob os termos da GPL v2.0 ou posterior (veja o ficheiro COPYING).