НАЗВА¶

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) іншими мовами (якими розмовляють люди).

У новій версії можна скористатися новим обробником SimplePod. Ним варто користуватися замість поточного модуля Pod. Якщо ви виявите якісь вади, будемо дуже раді вашим звітам щодо них.

Протягом перехідного періоду буде показано наведене вище попередження. Щоб вимкнути його показ, скористайтеся параметром "no-warn-simple".

СТАН ЦЬОГО МОДУЛЯ¶

Я вважаю цей модуль дуже стабільним. У нього лише одна відома вада, пов'язана із /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).