.\" -*- 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 ИМЕ .IX Header "ИМЕ" Locale::Po4a::SimplePod \- двосмерна конверзија POD података и PO фајлова са Pod::Simple .SH СИНОПСИС .IX Header "СИНОПСИС" .Vb 2 \& [po4a_paths] /путања/до/pot $lang:/путања/до/po \& [type:SimplePod] /путања/до/извор.pod $lang:/путања/до/локализовани.pod .Ve .PP или .PP .Vb 3 \& [po4a_paths] /путања/до/pot $lang:/путања/до/po \& [po4a_alias:pod] SimplePod \& [type:pod] /путања/до/извор.pod $lang:/путања/до/локализовани.pod .Ve .SH ОПИС .IX Header "ОПИС" Ово је модул који помаже превођење документације у POD формату (препоручени језик за документовање Perl кода) на друге људске језике. .PP Главне разлике између текућег Pod формата и SimplePod формата су: .IP \(bu 4 SimplePod формат у поруке које се преводе никада не укључује додатне преломе редова. Текући Pod формат, међутим, може да има додатне преломе редова, посебно у ставкама дословних порука. .IP \(bu 4 Пасуси могу да се исписују са обавијањем. Модул Pod::Parser би могао да промени специјалну обраду за обавијање линија, што се тешко може постићи са Pod::Simple. Ипак, изгледа да Pod::Simple производи природнији излаз. .IP \(bu 4 У SimplePod, \f(CW\*(C`=for\*(C'\fR порука (нпр. \f(CW\*(C`=for comment text\*(C'\fR) не укључује име формата (као што је \f(CW\*(C`comment\*(C'\fR), тако да се порука састоји само од текста. За разлику од тога, текући Pod формат задржава име формата, па је резултат порука као што је \f(CW\*(C`comment text\*(C'\fR. Сматра се да је оно прво понашање удобније за преводиоце. .IP \(bu 4 Ставке као што је она испод, која означава \f(CW\*(C`=end comment\*(C'\fR, више нису присутне као што се виде у текућем Pod модулу. Пошто ове поруке не могу да се преведу, њихово одсуство представља побољшање. .Sp .Vb 4 \& #. type: =end \& #: sample.pod:10 \& msgid "comment" \& msgstr "" .Ve .IP \(bu 4 Блокови текста за које није сигурно да поштују POD формат сада се третирају као \f(CW\*(C`no\-wrap\*(C'\fR. Ово се, на пример, примењује на садржај унутар \f(CW\*(C`=begin html\*(C'\fR блока. У Pod модулу, они се нису третирали као \f(CW\*(C`no\-wrap\*(C'\fR, па је понекад последица тога било обавијање линије. .IP \(bu 4 Одељак \f(CW\*(C`=begin\*(C'\fR параметра више није предмет превођења. У текућем Pod модулу, он се преводи. Ако постоји потреба да се укључи у превод, молимо вас да то пријавите. .SH "СТАТУС ОВОГ МОДУЛА" .IX Header "СТАТУС ОВОГ МОДУЛА" Овај модул се још увек развија, тако да није стабилан као Locale::Po4a::Pod. Још увек еволуира и постоји простор за даља унапређења. Временом се његово понашање може променити, и можда ће се увести додатне опције за бољу оптимизацију корисничког искуства превођења. Повратне информације и случајеви употребе из реалних апликација ће имати одлучујућу улогу у смеру даљег развоја. .PP Код је у потпуности покривен нашом свитом тестова и немамо сазнања о било каквим постојећим баговима. Ипак, у 2025 години, није подробно тестиран у реалним преводилачким токовима рада у постојећим пројектима. С тим у виду, верујемо да је модул спреман за праву употребу, чак и ако се током ширег прихватања открију неки неизбежни багови. .PP Предвиђено је да овај модул замени текући Locale::Po4a::Pod модул. Разлог за то је што је Pod::Parser, који користи текући Locale::Po4a::Pod, сада превазиђен, и препорука је да се уместо њега користи Pod::Simple. Погледајте и GitHub issue #256 "Consider migrating away from deprecated \&\f(CW\*(C`Pod::Parser\*(C'\fR" . .SH "ПОГЛЕДАЈТЕ ТАКОЂЕ" .IX Header "ПОГЛЕДАЈТЕ ТАКОЂЕ" Pod::Simple, Locale::Po4a::Pod, Locale::Po4a::TransTractor, \&\fBpo4a\fR\|(7), Locale::Po4a::SimplePod::Parser. .SH АУТОРИ .IX Header "АУТОРИ" .Vb 1 \& gemmaro .Ve .SH "ПРАВА УМНОЖАВАЊА И ЛИЦЕНЦА" .IX Header "ПРАВА УМНОЖАВАЊА И ЛИЦЕНЦА" .Vb 1 \& Права умножавања (C) 2025 gemmaro . .Ve .PP Овај програм је слободан софтвер; можете да га редистрибуирате и/или мењате под условима GPL v2.0 или новије (погледајте фајл COPYING).