.\" -*- 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::POD.3PM 1"
.TH LOCALE::PO4A::POD.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
.SH НАЗВА
.IX Header "НАЗВА"
Locale::Po4a::Pod — перетворення даних POD на файли PO, і навпаки
.SH "КОРОТКИЙ ОПИС"
.IX Header "КОРОТКИЙ ОПИС"
.Vb 2
\&    use Locale::Po4a::Pod;
\&    my $parser = Locale::Po4a::Pod\->new();
\&
\&    # Читаємо POD зі STDIN і записуємо до STDOUT.
\&    $parser\->parse_from_filehandle;
\&
\&    # Читаємо POD з file.pod і записуємо до file.txt.
\&    $parser\->parse_from_file (\*(Aqfile.pod\*(Aq, \*(Aqfile.txt\*(Aq);
.Ve
.SH ОПИС
.IX Header "ОПИС"
Locale::Po4a::Pod — модуль, який допомагає у перекладі документації у
форматі POD (основною мовою документації до Perl) іншими мовами (якими
розмовляють люди).
.PP
У новій версії можна скористатися новим обробником
SimplePod. Ним варто користуватися замість
поточного модуля Pod. Якщо ви виявите якісь вади, будемо дуже раді вашим
звітам щодо них.
.PP
Протягом перехідного періоду буде показано наведене вище попередження. Щоб
вимкнути його показ, скористайтеся параметром \f(CW\*(C`no\-warn\-simple\*(C'\fR.
.SH "СТАН ЦЬОГО МОДУЛЯ"
.IX Header "СТАН ЦЬОГО МОДУЛЯ"
Я вважаю цей модуль дуже стабільним. У нього лише одна відома вада,
пов\*(Aqязана із \fI/usr/lib/perl5/Tk/MainWindow.pod\fR (та деякими іншими
сторінками, див. нижче), де міститься такий рядок:
.PP
.Vb 1
\&  C<" #n">
.Ve
.PP
На жаль, у версії po4a цей рядок ділиться за пробілом на два рядки. У
результаті, якщо у початковій версії сторінка підручника містить таке:
.PP
.Vb 1
\& " #n"
.Ve
.PP
то після обробки вона містить таке:
.PP
.Vb 1
\& "" #n""
.Ve
.PP
Це логічно, оскільки C<щось там> переписується як "щось там".
.PP
Повний список сторінок із цією проблемою на комп\*(Aqютері автора (з 564
сторінок; зауважте, що кількість залежить від вибраної позиції перенесення
рядків):
.PP
.Vb 8
\& /usr/lib/perl5/Tk/MainWindow.pod
\& /usr/share/perl/5.8.0/overload.pod
\& /usr/share/perl/5.8.0/pod/perlapi.pod
\& /usr/share/perl/5.8.0/pod/perldelta.pod
\& /usr/share/perl/5.8.0/pod/perlfaq5.pod
\& /usr/share/perl/5.8.0/pod/perlpod.pod
\& /usr/share/perl/5.8.0/pod/perlre.pod
\& /usr/share/perl/5.8.0/pod/perlretut.pod
.Ve
.SH "ВНУТРІШНІ ПРИНЦИПИ РОБОТИ"
.IX Header "ВНУТРІШНІ ПРИНЦИПИ РОБОТИ"
Будучи класом, який походить від класу Pod::Parser, Locale::Po4a::Pod
підтримує ті самі методи та інтерфейси. Докладний опис можна знайти на
сторінці підручника щодо Pod::Parser. Якщо коротко, клас створює обробки
за допомогою \f(CW\*(C`Locale::Po4a::Pod\->new()\*(C'\fR, а потім викликає
\&\fBparse_from_filehandle()\fR або \fBparse_from_file()\fR.
.SH "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
.IX Header "ТАКОЖ ПЕРЕГЛЯНЬТЕ"
Pod::Parser, \fBLocale::Po4a::Man\fR\|(3pm),
\&\fBLocale::Po4a::TransTractor\fR\|(3pm), \fBpo4a\fR\|(7)
.SH АВТОРИ
.IX Header "АВТОРИ"
.Vb 2
\& Denis Barbier <barbier@linuxfr.org>
\& Martin Quinson (mquinson#debian.org)
.Ve
.SH "АВТОРСЬКІ ПРАВА ТА ЛІЦЕНЗУВАННЯ"
.IX Header "АВТОРСЬКІ ПРАВА ТА ЛІЦЕНЗУВАННЯ"
© SPI, inc., 2002.
.PP
Ця програма є вільним програмним забезпеченням; ви можете поширювати її
і/або вносити до неї зміни за умов дотримання GPL версії 2.0 або пізнішої
(див. файл COPYING).