.\" -*- mode: troff; coding: utf-8 -*- .\" Automatically generated by Pod::Man 5.01 (Pod::Simple 3.43) .\" .\" 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 .\" ======================================================================== .\" .IX Title "LOCALE::PO4A::POD.3PM 1" .TH LOCALE::PO4A::POD.3PM 1 2024-06-26 "perl v5.38.2" "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) на другие [человеческие] языки. .SH "СОСТОЯНИЕ ЭТОГО МОДУЛЯ" .IX Header "СОСТОЯНИЕ ЭТОГО МОДУЛЯ" Я думаю, что этот модуль стабилен, как скала, и есть только одна известная ошибка в \fI/usr/lib/perl5/Tk/MainWindow.pod\fR (и в некоторых других страницах, см. ниже), которые содержат: .PP .Vb 1 \& C<" #n"> .Ve .PP Из\-за неудачного стечение обстоятельств, в версии po4a часть этой строки было перенесена на следующую на пробеле. В результате в исходной версии man\-страница содержит: .PP .Vb 1 \& " #n" .Ve .PP а моя содержит: .PP .Vb 1 \& "" #n"" .Ve .PP что логично, т.к. C преобразуется в "foobar". .PP Полный список страниц, на которых возникала подобная проблема на моей машине (из 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) \& Мартин Кенсон (Martin Quinson) (mquinson#debian.org) .Ve .SH "АВТОРСКИЕ ПРАВА И ЛИЦЕНЗИИ" .IX Header "АВТОРСКИЕ ПРАВА И ЛИЦЕНЗИИ" Copyright © 2002 SPI, Inc. .PP Данная программа является свободным программным обеспечением; вы можете распространять и/или изменять её на условиях Универсальной общественной лицензии (GPL) GNU v2.0 или новее (см. файл COPYING).