
        *****************************************************
        *           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::AsciiDoc — перетворення документів AsciiDoc на файли PO, і
навпаки

=head1 ОПИС

Метою проєкту po4a (PO для усього) є спрощення перекладу (та, що ще
цікавіше, супровід перекладів) за допомогою інструментів gettext у областях,
де такий переклад спочатку не передбачався, зокрема у документації.

Locale::Po4a::AsciiDoc — модуль, який допомагає у перекладі документації у
форматі AsciiDoc.

=head1 ПАРАМЕТРИ, ЯКІ МОЖНА ПЕРЕДАВАТИ ЦЬОМУ МОДУЛЮ

Ось параметри, які можна передавати цьому модулю:

=over

=item B<definitions>

Назва файла, що містить визначення для po4a, як це визначено у розділі
B<НАЛАШТОВУВАННЯ НА МІСЦІ>. Ви можете скористатися цим параметром, якщо
вставляння визначень до документа, який ви перекладаєте, є неможливим.

У файлі визначень рядки мають починатися не з двох символів похилої риски, а
безпосередньо із B<po4a:>.

=item B<entry>

Список відокремлених пробілами записів атрибутів, вміст яких ви хочете
перекладати. Типово, атрибути не перекладаються.

=item B<macro>

Список відокремлених пробілами визначень макросів.

=item B<style>

Список відокремлених пробілами визначень стилів.

=item B<forcewrap>

Увімкнути автоматичне перенесення рядків у блоках, які не є блоками з
наперед визначеним форматуванням, навіть якщо результат може бути оброблено
з помилками засобами форматування AsciiDoc.

Типово, po4a не переноситиме рядки у створених файлах AsciiDoc, оскільки
уникнути впливу перенесення рядків на форматування тексту у таких файлах
можна лише вручну. Розгляньмо, наприклад, такий пункт списку:

 * довге речення, яке завершується цифрою 1. Друге речення.

Якщо перенесення рядків призводить до наведеного нижче варіанта, пункт буде
поділено — з'явиться упорядкований підлеглий список. Погіршує ситуацію і те,
що помилку зможуть помітити лише ті, хто користуватиметься перекладом.

 * довге речення, яке завершується цифрою
   1. Друге речення.

Зауважте, що якщо рядки у файлі, який буде створено po4a, не буде
перенесено, ніяких проблем виникнути не повинно — ці файли все одно буде
оброблено автоматично. Їх не слід розглядати з точки зору подальшого
редагування людиною.

Використання цього параметра надає змогу po4a створювати файли AsciiDoc із
зручнішим для редагування форматуванням, але може призвести до помилок під
час обробки природними для формату файлів засобами форматування.

=item B<noimagetargets>

Типово, записи блоків зображень можна перекладати, щоб надати можливість
перекладачеві вказати зображення із перекладеними повідомленнями. Вимкнути
переклад цих блоків можна за допомогою цього параметра.

=item B<tablecells>

Цей параметр є прапорцем, який вмикає поділ за підтаблицями у вмісті
комірки. Поділ обмежено вмістом комірки, без обробки даних всередині.

=item B<compat>

Перемикає правила обробки для сумісності із різними
інструментами. Доступними значеннями є «asciidoc» і
«asciidoctor». Asciidoctor має строгіші правила обробки, зокрема вимагає
збереження довжини початкових і завершальних обв'язок блоків.

=item B<nolinting>

Вимкнути повідомлення щодо правильності коду. Якщо початковий код не можна
виправити з метою поліпшення структурування документа, ці повідомлення не
мають сенсу.

=item B<cleanspaces>

Вилучити зайві пробіли з частин початкового тексту у режимі без перенесення
рядків. Корисно, якщо інструменти перекладу є чутливими до кількості
пробілів.

=item B<yfm_keys>

Список відокремлених комами ключів, які слід обробляти для перекладу у
вступній частині YAML. Усі інші ключі буде пропущено. Відповідність ключів
встановлюватиметься з врахуванням регістру. Якщо B<yfm_paths> і B<yfm_keys>
використано разом, значення буде включено, якщо буде встановлено
відповідність хоч за одним параметром. Значення масивів завжди
перекладатимуться, якщо не вказано параметр B<yfm_skip_array>.

=item B<yfm_skip_array>

Не перекладати значення масивів у вступному розділі YAML.

=item B<yfm_paths>

Список відокремлених комами шляхів хешів, які слід обробляти для видобування
у вступному розділі YAML. Усі інші шляхи буде пропущено. Відповідність
шляхів встановлюватиметься з врахуванням регістру. Якщо B<yfm_paths> і
B<yfm_keys> використано разом, значення буде включено, якщо буде встановлено
відповідність хоч за одним параметром. Значення масивів завжди
перекладатимуться, якщо не вказано параметр B<yfm_skip_array>.

=back

=head1 НАЛАШТОВУВАННЯ НА МІСЦІ

Налаштувати модуль AsciiDoc можна рядками, які починаються з
B<//po4a:>. Такі рядки вважатимуться командами, які віддаються засобу
обробки. Передбачено такі команди:

=over 4

=item B<//po4a: macro >I<назва>B<[>I<список атрибутів>B<]>

Цей рядок докладно описує параметри B<макроса>; I<назва> має бути коректною
назвою макроса і має завершуватися символом підкреслювання, якщо ціль має
бути перекладено.

Аргумент I<список атрибутів> є списком відокремлених комами значень, які
містять дані щодо придатних до перекладу аргументів. У цьому списку
містяться або номери, для визначення позиційних параметрів, або іменовані
атрибути.

Якщо перед назвою стоятиме символ «плюс» (B<+>), макрос і його аргументи
перекладатимуться як ціле. У цьому випадку немає потреби у визначенні списку
атрибутів, але квадратні дужки все ж доведеться дописати.

=item B<//po4a: style >B<[>I<список атрибутів>B<]>

Цей рядок надає змогу докладно описати атрибути стилю, які слід перекласти.

Аргумент I<список атрибутів> є списком відокремлених комами значень, які
містять дані щодо придатних до перекладу аргументів. У цьому списку
містяться або номери, для визначення позиційних параметрів, або іменовані
атрибути. Перший атрибут є назвою стилю, його не буде перекладено.

Якщо перед назвою стилю вказано символ «плюс» (B<+>), список атрибутів
перекладається як ціле. У такому випадку немає потреби у визначенні
атрибутів, які слід перекладати.

Якщо перед назвою стилю вказано символ «мінус» (B<->), список атрибутів не
перекладається.

Якщо до назви стилю додано символ відсотків (B<%>), стиль буде оброблено
буквально. Рядки у абзаці або блоці такого стилю буде збережено у файлах po,
а відповідні запис буде позначено як записи без перенесення рядків.

=item B<//po4a: entry >I<назва>

Ця команда оголошує запис атрибута як придатний до перекладу. Типово, записи
атрибутів не перекладаються.

=back

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

Успішно перевірено на простих файлах AsciiDoc.

=head1 АВТОРИ

 Nicolas François <nicolas.francois@centraliens.net>
 Denis Barbier <barbier@linuxfr.org>

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

 © Nicolas FRANÇOIS <nicolas.francois@centraliens.net>, 2005–2008.
 © Denis BARBIER <barbier@linuxfr.org>, 2012.
 © Martin Quinson <mquinson#debian.org>, 2017.

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