oracular (3) Locale::Po4a::Pod.3pm.gz

Provided by: po4a_0.73-2ubuntu1_all bug

НАЗВА

       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).