LOCALE::PO4A::POD.3PM(1) | User Contributed Perl Documentation | LOCALE::PO4A::POD.3PM(1) |
НАЗВА
Locale::Po4a::Pod — перетворення даних POD на файли PO, і навпаки
КОРОТКИЙ ОПИС
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 ('file.pod', 'file.txt');
ОПИС
Locale::Po4a::Pod — модуль, який допомагає у перекладі документації у форматі POD (основною мовою документації до Perl) іншими мовами (якими розмовляють люди).
СТАН ЦЬОГО МОДУЛЯ
Я вважаю цей модуль дуже стабільним. У нього лише одна відома вада, пов'язана із /usr/lib/perl5/Tk/MainWindow.pod (та деякими іншими сторінками, див. нижче), де міститься такий рядок:
C<" #n">
На жаль, у версії po4a цей рядок ділиться за пробілом на два рядки. У результаті, якщо у початковій версії сторінка підручника містить таке:
" #n"
то після обробки вона містить таке:
"" #n""
Це логічно, оскільки C<щось там> переписується як "щось там".
Повний список сторінок із цією проблемою на комп'ютері автора (з 564 сторінок; зауважте, що кількість залежить від вибраної позиції перенесення рядків):
/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
ВНУТРІШНІ ПРИНЦИПИ РОБОТИ
Будучи класом, який походить від класу Pod::Parser, Locale::Po4a::Pod підтримує ті самі методи та інтерфейси. Докладний опис можна знайти на сторінці підручника щодо Pod::Parser. Якщо коротко, клас створює обробки за допомогою "Locale::Po4a::Pod->new()", а потім викликає parse_from_filehandle() або parse_from_file().
ТАКОЖ ПЕРЕГЛЯНЬТЕ
Pod::Parser, Locale::Po4a::Man(3pm), Locale::Po4a::TransTractor(3pm), po4a(7)
АВТОРИ
Denis Barbier <barbier@linuxfr.org> Martin Quinson (mquinson#debian.org)
АВТОРСЬКІ ПРАВА ТА ЛІЦЕНЗУВАННЯ
© SPI, inc., 2002.
Ця програма є вільним програмним забезпеченням; ви можете поширювати її і/або вносити до неї зміни за умов дотримання GPL версії 2.0 або пізнішої (див. файл COPYING).
2024-06-26 | perl v5.38.2 |