
        *****************************************************
        *           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

1;

__END__

=head1 НАЗВА

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

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

  [po4a_paths] /шлях/до/pot $lang:/шлях/до/po
  [type:SimplePod] /шлях/до/джерела.pod $lang:/шлях/до/перекладеного.pod

або

  [po4a_paths] /шлях/до/pot $lang:/шлях/до/po
  [po4a_alias:pod] SimplePod
  [type:pod] /шлях/до/джерела.pod $lang:/шлях/до/перекладеного.pod

=head1 ОПИС

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

Основні відмінності між поточним форматом Pod і форматом SimplePod:

=over

=item *

У форматі SimplePod ніколи не використовуються додаткові символи розриву
рядка у повідомленнях для перекладу. А ось у поточному форматі Pod можуть
міститися зайві символи розриву рядка, зокрема у записах повідомлень із
цитуванням.

=item *

Абзаци може бути відтворено із перенесенням рядків. Модуль L<Pod::Parser>
може застосовувати спеціальну обробку перенесення рядків, яку важко
відтворити за допомогою L<Pod::Simple>.  Втім, результати застосування
L<Pod::Simple>, здається, виглядають природніше.

=item *

У SimplePod повідомлення C<=for> (наприклад, C<=for коментар текст>) не
містить назви формату (наприклад, C<коментар>), тому повідомлення
складається виключно з тексту. Натомість, поточний формат Pod зберігає назву
формату, у результаті чого виникає повідомлення типу C<коментар
текст>. Перший варіант вважається зручнішим для перекладачів.

=item *

Записів, подібні до наведеного нижче, що позначають C<=кінець коментаря>,
більше немає, як це трапляється у поточному модулі Pod. Оскільки це
повідомлення, які не можна перекладати, те, що їх немає, є покращенням.

  #. type: =end
  #: sample.pod:10
  msgid "comment"
  msgstr ""

=item *

Текстові блоки, коректність формату POD яких є невизначеною, тепер
обробляються як C<no-wrap>. Це стосується, наприклад, вмісту всередині блоку
C<=begin html>. У модулі Pod вони не оброблялися як C<no-wrap>, що іноді
призводило до перенесення рядків.

=item *

Розділ параметра C<=begin> більше не підлягає перекладу. У поточному модулі
Pod він включений до рядків. Якщо вам потрібне включення його до перекладу,
будь ласка, повідомте про це.

=back

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

Цей модуль все ще перебуває у розробці, тому він менш стабільний, ніж
L<Locale::Po4a::Pod>. Він продовжує розвиватися, і є простір для подальшого
вдосконалення. Його поведінка може змінюватися з часом, і можуть бути
введені додаткові параметри для кращої оптимізації процесу перекладу для
користувачів. Відгуки та варіанти використання з реальних застосувань
відіграватимуть ключову роль у його подальшому розвитку.

Код повністю охоплено нашим набором тестів, і нам невідомо про жодні наявні
помилки. Однак станом на 2025 рік він не проходив бойових випробувань у
реальних робочих процесах перекладу зовнішніми проєктами. Тим не менш, ми
вважаємо, що модуль готовий до використання у реальному середовищі, навіть
якщо деякі помилки неминуче будуть виявлені, коли сфера його впровадження
зростатиме.

Цей модуль призначений для заміни поточного модуля
L<Locale::Po4a::Pod>. Причина полягає в тому, що L<Pod::Parser>, який
використовується поточним L<Locale::Po4a::Pod>, тепер застарів, і ми
рекомендуємо використовувати замість нього L<Pod::Simple>. Див. також L<вада
GitHub 256 "Consider migration away from deprecated
C<Pod::Parser>"|https://github.com/mquinson/po4a/issues/256>.

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

L<Pod::Simple>, L<Locale::Po4a::Pod>, L<Locale::Po4a::TransTractor>,
L<po4a(7)|po4a.7>, L<Locale::Po4a::SimplePod::Parser>.

=head1 АВТОРИ

  gemmaro <gemmaro.dev@gmail.com>

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

  © gemmaro <gemmaro.dev@gmail.com>, 2025.

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