
        *****************************************************
        *           GENERATED FILE, DO NOT EDIT             *
        * THIS IS NO SOURCE FILE, BUT RESULT OF COMPILATION *
        *****************************************************

This file was generated by po4a(7). Do not store it (in VCS, for example),
but store the PO file used as source file by po4a-translate.

In fact, consider this as a binary, and the PO file as a regular .c file:
If the PO get lost, keeping this translation up-to-date will be harder.

=encoding UTF-8

=head1 НАЗВА

Locale::Po4a::Pod — перетворення даних POD на файли PO, і навпаки

=head1 КОРОТКИЙ ОПИС

    use Locale::Po4a::Pod;
    my $parser = Locale::Po4a::Pod->new (sentence => 0, width => 78);

    # Прочитати POD з STDIN і записати до STDOUT.
    $parser->parse_from_filehandle;

    # Прочитати POD з file.pod і записати до file.txt.
    $parser->parse_from_file ('file.pod', 'file.txt');

=head1 ОПИС

Locale::Po4a::Pod — модуль, який допомагає у перекладі документації у форматі POD (основною мовою документації до Perl) іншими мовами (якими розмовляють люди).

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

Я вважаю цей модуль дуже стабільним. У нього лише одна відома вада, пов'язана із F</usr/lib/perl5/Tk/MainWindow.pod> (та деякими іншими сторінками, див. нижче), де міститься такий рядок:

  C<" #n">

На жаль, у версії po4a цей рядок ділиться за пробілом на два рядки. У результаті, якщо у початковій версії сторінка підручника містить таке:

 " #n"

то після обробки вона містить таке:

 "" #n""

Це логічно, оскільки CE<lt>щось тамE<gt> переписується як "щось там".

Повний список сторінок, які є проблемними у цьому сенсі, з моєї системи (у мене 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





=head1 ВНУТРІШНІ ПРИНЦИПИ РОБОТИ

Будучи класом, який походить від класу Pod::Parser, Locale::Po4a::Pod підтримує ті самі методи та інтерфейси. Докладний опис можна знайти на сторінці підручника щодо L<Pod::Parser>. Якщо коротко, клас створює обробки за допомогою C<< Locale::Po4a::Pod->new() >>, а потім викликає parse_from_filehandle() або parse_from_file().

new() може примати параметри у форматі пар ключ/значення. Ці параметри керують поведінкою обробника. Коректні параметри є спільними для усіх дочірніх класів Pod::Parser:

=over 4

=item B<alt>

Якщо встановлено значення true, вибирає альтернативний формат виведення, який, окрім інших речей, використовує інший стиль заголовків і позначає запис B<=item> двокрапкою на лівому полі. Типовим значенням є false.

=item B<code>

Якщо встановлено значення true, до виведених результатів буде включено не пов'язані із POD частини файла вхідних даних. Корисно для файлів із кодом, документованим за допомогою блоків POD, де слід перекласти POD, а код лишити незмінним.

=item B<indent>

Кількість пробілів у відступах для звичайного тексту і типові відступи для блоків B<=over>. Типове значення — 4.

=item B<loose>

Якщо встановлено значення true, після заголовка B<=head1> буде виведено порожній рядок. Якщо встановлено значення false (типовий варіант), після B<=head1> не буде додано порожній рядок, хоча такий рядок виводитиметься після B<=head2>. Це типова поведінка, оскільки таке форматування є очікуваним для сторінок підручника. Якщо ви форматуєте довільні текстові документи, встановлення значення true може покращити зовнішній вигляд результатів.

=item B<quotes>

Визначає лапки, які буде використано для тексту CE<lt>>. Якщо значенням є одинарний символ, він використовується для лівих і правих лапок; якщо значенням є два символи, перший символ використовується для лівих лапок, а другий — для правих; якщо ж символів чотири, перші два використовуються як ліві лапки, а останні два — як праві.

Може приймати особливе значення B<none>, яке означає, що навколо тексту CE<lt>> не додаватимуться лапки.

=item B<sentence>

Якщо встановлено значення true, Locale::Po4a::Pod вважатиме, що кожне речення завершується двома пробілами і намагатиметься зберігати такі інтервали між реченнями. Якщо встановлено значення false, усі послідовні пробіли у звичайних абзацах будуть стискатися до одинарного пробілу. Типовим значенням є true.

=item B<width>

Позиція, на якій слід переносити рядки тексту праворуч. Типове значення — 76.

=back

=head1 ТАКОЖ ПЕРЕГЛЯНЬТЕ

L<Pod::Parser>, L<Locale::Po4a::Man(3pm)>, L<Locale::Po4a::TransTractor(3pm)>, L<po4a(7)|po4a.7>

=head1 АВТОРИ

 Denis Barbier <barbier@linuxfr.org>
 Martin Quinson (mquinson#debian.org)

=head1 АВТОРСЬКІ ПРАВА ТА ЛІЦЕНЗУВАННЯ

© SPI, inc., 2002.

Ця програма є вільним програмним забезпеченням; ви можете поширювати її і/або вносити до неї зміни за умов дотримання GPL (див. файл COPYING).

