
        *****************************************************
        *           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::Text: преобразование обычных текстовых документов из/в
PO-файлы

=head1 ОПИСАНИЕ

Целью проекта po4a (PO for anything, PO везде и для всего) является
облегчение процесса перевода (и что более важно — поддержки перевода),
используя инструменты gettext в тех случаях, когда их применение может
выглядеть неожиданным, например для документации.

Locale::Po4a::Text — это модуль, предназначенным для помощи в переводе
документов на другие [человеческие] языки.

Абзацы отделяются друг от друга пустыми строками (или строками, содержащими
только пробелы и табуляции).

Если в абзаце есть строки, начинающиеся с пробела (или табуляции), то
переносы строк в этом параграфе сохранены.

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

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

=over

=item B<keyvalue>

Обрабатывать абзацы, которые выглядят как пара ключ-значение (разделённые
двоеточием), как «буквальные» (verbatim, т.е. добавлять флаг C<no-wrap> в
PO-файл). Парой ключ-значение считается строка вида C<ключ:значение>,
содержащая один или несколько символов не являющихся двоеточием или
пробелом, за которыми следует двоеточие, за которым следует хотя бы один
непробельный символ перед концом строки.

=item B<nobullets>

Отключить автоматическое обнаружение ненумерованных списков.

По умолчанию при обнаружении маркера ненумерованного списка в начале строки,
абзац не считается «дословным» (verbatim, т.е. флаг C<no-wrap> в PO-файл не
добавляется) и переводы строк в нём будут расставлены автоматически.

=item B<tabs=>I<режим>

Указывает, как следует обрабатывать табуляции. I<режим> может быть одним из:

=over

=item B<split>

Строки, содержащие только одну табуляцию будут разделять абзацы.

=item B<verbatim>

Переносы строк в параграфах, содержащих табуляции, будут сохранены.

=back

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

=item B<breaks=>I<regex>

Регулярное выражение для строк, разделяющих абзацы. К этому регулярному
выражению будут добавлены специальные символы (^$) так, чтобы оно
сопоставляло всю строку целиком.

=item B<debianchangelog>

Обрабатывать верхний и нижний колонтитулы описаний пакетов, которые содержат
только непереводимую информацию, специальным образом.

=item B<fortunes>

Обрабатывать формат B<fortune>, в котором афоризмы разделяются строкой,
состоящей из '%' или '%%', и '%%' используется в качестве начала
комментария.

=item B<markdown>

Обрабатывать некоторую разметку, специфичную для текстов в формате Markdown.

=item B<yfm_keys> (только для markdown)

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

=item B<yfm_lenient> (только для markdown)

Допускать возникновение ошибок при анализе некорректного YAML-заголовка
(Front Matter). Это особенно полезно, если ваш файл начинается с
горизонтальной линии, а не собственно с YAML-заголовка, и вы по какой-то
неизвестной причине убеждены, что вам необходимы продолжать использовать
только три дефиса (и не больше) для обозначения этой линии линии.

=item B<yfm_paths> (только для markdown)

=item B<yfm_paths>

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

=item B<yfm_skip_array> (только для markdown)

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

=item B<control>[B<=>I<список_полей>]

Обрабатывать control-файлы Debian. Также можно задать список (разделённый
запятыми) полей, значения которых будут извлечены для перевода.

=item B<neverwrap>

Сохранять все переносы. Это значит, что всё содержимое будет передано
дословно (verbatim), даже простые текстовые абзацы.

=back

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

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

=head1 АВТОРЫ

 Николя Франсуа (Nicolas François) <nicolas.francois@centraliens.net>

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

 Copyright © 2005-2008 Николя Франсуа (Nicolas FRANÇOIS) <nicolas.francois@centraliens.net>.
 Copyright © 2008-2009, 2018 Йонас Смедегард (Jonas Smedegaard) <dr@jones.dk>.
 Copyright © 2020 Мартин Кенсон (Martin Quinson) <mquinson#debian.org>.

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