
        *****************************************************
        *           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 НАЗВАНИЕ

po4a-translate - преобразует PO-файлы обратно в формат документации

=head1 КРАТКОЕ СОДЕРЖАНИЕ

B<po4a-translate> B<-f> I<формат> B<-m> I<мастер_документ.doc> B<-p>
I<XX.po> B<-l> I<XX.doc>

(I<XX.doc> является выходным параметром, все остальные являются входными)

=head1 ОПИСАНИЕ

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

Скрипт B<po4a-translate> отвечает за преобразование перевода (который был
выполнен в PO-файле) обратно в формат документации. Данный PO-файл должен
являться переводом POT-файла, созданного с помощью L<po4a-gettextize(1)>.

=head1 ПАРАМЕТРЫ

=over 4

=item B<-f>, B<--format>

Формат документации которой вы хотите обработать. Используйте параметр
B<--help-format>, чтобы просмотреть список доступных форматов.

=item B<-a>, B<--addendum>

Файл дополнения, который будет добавлен в итоговый файл (например, для того,
чтобы добавить имена переводчиков или раздел «Об этом переводе»). Первая
строка в файле должна являться заголовком PO4A, указывающим местоположение,
куда именно следует подставить данный файл (см. раздел B<КАК добавить
дополнительный текст в перевод> в L<po4a(7)>).

=item B<-A>, B<--addendum-charset>

Кодировка аддендумов. Обратите внимание, что все аддендумы должны иметь одну
и ту же кодировку.

=item B<-m>, B<--master>

Файл, содержащий мастер-документ для перевода.

=item B<-M>, B<--master-charset>

Кодировка файла, содержащаяся в документе для перевода.

=item B<-l>, B<--localized>

Файл, в который локализованный (переведённый) документ должен быть записан.

=item B<-L>, B<--localized-charset>

Кодировка файла, содержащего переведённый документ.

=item B<-p>, B<--po>

Файл, из которого будет читаться каталог сообщений (message catalog).

=item B<-o>, B<--option>

Дополнительные параметры, передаваемые модулю формата. См. описание
возможных параметров и их значений в документации каждого конкретного
модуля. Например, вы можете указать '-o tablecells' парсеру AsciiDoc, в то
время как парсер text принимал бы '-o tabs=split'.

=item B<-k>, B<--keep>

Минимальное пороговое значение, в процентах, для сохранения (например, для
записи) результирующего файла (по умолчанию: 80). То есть, по умолчанию, для
того чтобы файл был записан, необходимо перевести как минимум 80%.

=item B<-w>, B<--width>

Количество символов в строке, после которых текст в результирующем файле
переносится на новую строку, если формат это поддерживает (значение по
умолчанию: 76). Если значение равно нулю или меньше нуля, строки
переноситься не будут (полезно в случаях, когда разбиение на строки нарушает
разметку).

=item B<-h>, B<--help>

Отобразить короткую справку.

=item B<--help-format>

Выводит список поддерживаемых po4a форматов.

=item B<-V>, B<--version>

Отобразить версию и завершить работу сценария.

=item B<-v>, B<--verbose>

Увеличить количество выводимой пояснительной информации.

=item B<-d>, B<--debug>

Вывод отладочной информации.

=back

=head1 Добавление материалов (кроме перевода) в создаваемые файлы

Чтобы добавить дополнительное содержимое в создаваемый документ, помимо
собственно перевода (например: имя переводчика, или раздел «Об этом
переводе»), вам необходимо использовать параметр B<--addendum>.

В первой строке аддендума должен содержаться заголовок, указывающий куда
именно в документе он (аддендум) должно быть добавлен (он может
располагаться до или после указанного раздела документа). Остальное
содержимое данного файла будет взято дословно и добавлено в итоговый файл
без каких-либо преобразований.

Заметим, что если po4a-translate не сможет добавить один из указанных
файлов, то весь перевод будет отброшен (потому что пропущенный файл может
оказаться тем, в котором указан автор и его контактные данные, что в свою
очередь привело бы к невозможности для пользователей связаться с ним и
сообщить об ошибке в переводе).

Заголовок имеет довольно жёсткий синтаксис. Для получения более подробной
информации о том, как использовать данные возможности и как они работают,
обратитесь к man-странице L<po4a(7)>.

=head1 СМОТРИТЕ ТАКЖЕ

L<po4a-gettextize(1)>, L<po4a-normalize(1)>, L<po4a-updatepo(1)>, L<po4a(7)>

=head1 АВТОРЫ

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

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

Copyright 2002-2023 by SPI, inc.

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