
        *****************************************************
        *           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, т.е. добавлять флаг С<no-wrap> в PO-файл). Парой ключ-значение считается строка вида C<ключ:значение>, содержащая один или несколько символов не являющихся двоеточием или пробелом, за которыми следует двоеточие, за которым следует хотя бы один непробельный символ перед концом строки.

=item B<nobullets>

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

По умолчанию при обнаружении маркера ненумерованного списка в начале строки, абзац не считается «дословным» (verbatim, т.е. флаг С<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).

