
        *****************************************************
        *           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 for anything, PO везде и для всего) является
облегчение процесса перевода (и что более важно — поддержки перевода),
используя инструменты gettext в тех случаях, когда их применение может
выглядеть неожиданным, например для документации.

Locale::Po4a::AsciiDoc — это модуль, предназначенным для помощи в переводе
документации в формате AsciiDoc.

=head1 ПАРАМЕТРЫ ПРИНИМАЕМЫЕ ЭТИМ МОДУЛЕМ

Ниже приведены специфические для данного модуля параметры:

=over

=item B<definitions>

Имя файла с po4a-определениями (definitions), которые описаны в разделе
B<ВСТРОЕННЫЕ НАСТРОЙКИ ПОВЕДЕНИЯ>. Вы можете использовать этот параметр,
если добавить эти определения непосредственно в переводимый документ не
является возможным.

В файле с определениями строки должны начинаться не, как комментарии, с двух
слешей, а сразу с B<po4a:>.

=item B<entry>

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

=item B<macro>

Список определений макросов (macro definitions), разделённых пробелами.

=item B<style>

Список определений стилей (style definitions), разделённых пробелами.

=item B<forcewrap>

Включить автоматический перенос строк (кроме дословных (verbatim) блоков),
даже если результат может быть в дальнейшем некорректно интерпретирован
другими инструментами 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-загаловка (Front Matter),
которые нужно переводить. Все остальные ключи переводиться не будут. Ключи
чувствительны к регистру. Если одновременно заданы и B<yfm_keys>, и
B<yfm_paths>, то значения ключей будут переводиться, если они перечислены
хотя бы в одном из этих параметров. Значения массивов всегда переводятся
(если не задан параметр B<yfm_skip_array>).

=item B<yfm_skip_array>

Не переводить значения массивов, присутствующих в YAML-загаловке (Front
Matter).

=item B<yfm_paths>

Список (разделённый запятыми) «путей» из ключей хешей в YAML-заголовке
(Front Matter), которые нужно переводить. Все остальные пути переводиться не
будут. Пути чувствительны к регистру. Если одновременно заданы и
B<yfm_keys>, и B<yfm_paths>, то значения ключей будут переводиться, если они
перечислены хотя бы в одном из этих параметров. Значения массивов всегда
переводятся (если не задан параметр B<yfm_skip_array>).

=back

=head1 ВСТРОЕННЫЕ НАСТРОЙКИ ПОВЕДЕНИЯ

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

=over 4

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

Этот параметр описывает, как именно нужно обрабатывать B<макрос> и его
параметры. I<Имя> должно быть действительным именем макроса. Если цель
(target) макроса должна быть переведена, то к имени оного должно быть
добавлено подчёркивание.

I<список атрибутов> — это список аргументов макроса, разделённых пробелами,
которые также должны быть переведены. Этот список состоит либо из чисел,
которые задают номера позиционных параметров, либо из непосредственно самих
имён оных атрибутов.

Если в начало I<имени> добавлен знак плюс (B<+>), то макрос и все его
аргументы переводятся как единое целое. В этом случае нет необходимости
задавать список аргументов, но скобки всё равно должны присутствовать.

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

Этот параметр описывает, какие именно атрибуты стиля должны переводиться.

I<список атрибутов> — это список аргументов, разделённых запятыми, которые
должны быть переведены. Этот список содержит либо числа, которые задают
номера позиционных параметров, либо непосредственно сами имена оных. При
этом первым аргументом считается имя стиля, которое в любом случае не будет
переведено.

Если в начало имени стиля добавлен знак плюс (B<+>), то весь список
атрибутов переводится как единое целое. В этом случае нет необходимости
задавать список атрибутов.

Если в начало имени стиля добавлен знак минус (B<->), то его атрибуты не
будут переводиться.

Если к названию стиля добавлен знак процента (B<%>), то стиль обрабатывается
как дословный (verbatim). Расстановка переводов строк в абзаце или блоке с
таким стилем сохраняются при их добавлении в PO-файл, а соответствующие
записи помечаются как «no-wrap» (без переноса).

=item B<//po4a: entry >I<имя>

Этот параметр делает значение атрибута переводимым. По умолчанию значения
атрибутов остаются без перевода.

=back

=head1 СОСТОЯНИЕ ЭТОГО МОДУЛЯ

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

=head1 АВТОРЫ

 Николя Франсуа (Nicolas François) <nicolas.francois@centraliens.net>
 Денис Барбье (Denis Barbier) <barbier@linuxfr.org>

=head1 АВТОРСКИЕ ПРАВА И ЛИЦЕНЗИИ

 Copyright © 2005-2008 Николя Франсуа (Nicolas FRANÇOIS) <nicolas.francois@centraliens.net>.
 Copyright © 2012 Денис Барбье (Denis BARBIER) <barbier@linuxfr.org>.
 Copyright © 2017 Мартин Кенсон (Martin Quinson) <mquinson#debian.org>.

Данная программа является свободным программным обеспечением; вы можете
распространять и/или изменять её на условиях Универсальной общественной
лицензии (GPL) GNU v2.0 или новее (см. файл COPYING).
