.\" -*- 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 коментар текст\*(C'\fR) не містить назви формату (наприклад, \f(CW\*(C`коментар\*(C'\fR), тому повідомлення складається виключно з тексту. Натомість, поточний формат Pod зберігає назву формату, у результаті чого виникає повідомлення типу \f(CW\*(C`коментар текст\*(C'\fR. Перший варіант вважається зручнішим для перекладачів. .IP \(bu 4 Записів, подібні до наведеного нижче, що позначають \f(CW\*(C`=кінець коментаря\*(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 256 "Consider migration 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 \& © gemmaro , 2025. .Ve .PP Ця програма є вільним програмним забезпеченням; ви можете поширювати її і/або вносити до неї зміни за умов дотримання GPL версії 2.0 або пізнішої (див. файл COPYING).