LOCALE::PO4A::POD.3PM

Section: User Contributed Perl Documentation (1)
Updated: 2025-07-02
Index Return to Main Contents

НАЗВАНИЕ

Locale::Po4a::Pod: преобразование POD-данных из/в PO-файлы

КРАТКОЕ СОДЕРЖАНИЕ

    use Locale::Po4a::Pod;
    my $parser = Locale::Po4a::Pod->new();

    # Read POD from STDIN and write to STDOUT.
    $parser->parse_from_filehandle;

    # Read POD from file.pod and write to file.txt.
    $parser->parse_from_file ('file.pod', 'file.txt');

ОПИСАНИЕ

Locale::Po4a::Pod — это модуль, предназначенным для помощи в переводе документации в формате POD (предпочтительный язык разметки документации Perl) на другие [человеческие] языки.

A new SimplePod parser is now available. Please consider using it instead of the current Pod module. If you encounter any bugs, your reports would be greatly appreciated.

The above warning message will be displayed for a transitional period. To disable it, set the "no-warn-simple" option.

СОСТОЯНИЕ ЭТОГО МОДУЛЯ

Я думаю, что этот модуль стабилен, как скала, и есть только одна известная ошибка в /usr/lib/perl5/Tk/MainWindow.pod (и в некоторых других страницах, см. ниже), которые содержат:

  C<" #n">

Из-за неудачного стечение обстоятельств, в версии po4a часть этой строки было перенесена на следующую на пробеле. В результате в исходной версии man-страница содержит:

 " #n"

а моя содержит:

 "" #n""

что логично, т.к. C<foobar> преобразуется в "foobar".

Полный список страниц, на которых возникала подобная проблема на моей машине (из 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)

АВТОРСКИЕ ПРАВА И ЛИЦЕНЗИИ

Данная программа является свободным программным обеспечением; вы можете распространять и/или изменять её на условиях Универсальной общественной лицензии (GPL) GNU v2.0 или новее (см. файл COPYING).

This document was created by using the manual pages.
Time: 01:03:48 GMT, July 02, 2025