.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.40)
.\"
.\" Standard preamble:
.\" ========================================================================
.de Sp \" Vertical space (when we can't use .PP)
.if t .sp .5v
.if n .sp
..
.de Vb \" Begin verbatim text
.ft CW
.nf
.ne \\$1
..
.de Ve \" End verbatim text
.ft R
.fi
..
.\" Set up some character translations and predefined strings.  \*(-- will
.\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left
.\" double quote, and \*(R" will give a right double quote.  \*(C+ will
.\" give a nicer C++.  Capital omega is used to do unbreakable dashes and
.\" therefore won't be available.  \*(C` and \*(C' expand to `' in nroff,
.\" nothing in troff, for use with C<>.
.tr \(*W-
.ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p'
.ie n \{\
.    ds -- \(*W-
.    ds PI pi
.    if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch
.    if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\"  diablo 12 pitch
.    ds L" ""
.    ds R" ""
.    ds C` ""
.    ds C' ""
'br\}
.el\{\
.    ds -- \|\(em\|
.    ds PI \(*p
.    ds L" ``
.    ds R" ''
.    ds C`
.    ds C'
'br\}
.\"
.\" Escape single quotes in literal strings from groff's Unicode transform.
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\"
.\" If the F register is >0, we'll generate index entries on stderr for
.\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index
.\" entries marked with X<> in POD.  Of course, you'll have to process the
.\" output yourself in some meaningful fashion.
.\"
.\" Avoid warning from groff about undefined register 'F'.
.de IX
..
.nr rF 0
.if \n(.g .if rF .nr rF 1
.if (\n(rF:(\n(.g==0)) \{\
.    if \nF \{\
.        de IX
.        tm Index:\\$1\t\\n%\t"\\$2"
..
.        if !\nF==2 \{\
.            nr % 0
.            nr F 2
.        \}
.    \}
.\}
.rr rF
.\" ========================================================================
.\"
.IX Title "PO2DEBCONF 1"
.TH PO2DEBCONF 1 "2020-12-30" "" "po-debconf"
.\" For nroff, turn off justification.  Always turn off hyphenation; it makes
.\" way too many mistakes in technical documents.
.if n .ad l
.nh
.Vb 2
\&  Translation:
\&    debian\-l10n\-russian@lists.debian.org
\&
\&    Yuri Kozlov <kozlov.y@gmail.com>, 2005, 2006
.Ve
.SH "НАЗВАНИЕ"
.IX Header "НАЗВАНИЕ"
po2debconf \*(-- объединяет мастер\-файл шаблонов и PO\-файлы
.SH "СИНТАКСИС"
.IX Header "СИНТАКСИС"
\&\fBpo2debconf\fR [\fB\-v\fR] [\fB\-h\fR] [\fB\-\-podir=\f(BIКАТАЛОГ\fB\fR] [\fB\-o \f(BIФАЙЛ\fB\fR] [\fB\-e
\&\f(BIСТРОКА\fB\fR] \fIмастер_файл\fR
.SH "ОПИСАНИЕ"
.IX Header "ОПИСАНИЕ"
Эта программа читает все PO\-файлы и один \fItemplates\fR файл, и создаёт файл
шаблонов Debconf, содержащий все переводы, подобно тому, как это делает
\&\fBdebconf\-mergetemplate\fR\|(1) (из пакета \f(CW\*(C`debconf\-utils\*(C'\fR). По умолчанию,
PO\-файлы ищутся в подкаталоге \fIpo\fR, который находится ниже местоположения
мастер\-файла.
.PP
Чтобы помочь норвежскому Bokmål в переходе с одного кода языка на
другой, коды \fBno\fR и \fBnb\fR обрабатываются специальным образом. Если
существует \fIno.po\fR, то он должен быть переименован в
\&\fInb.po\fR. Использование \fInb.po\fR делает переводы \f(CW\*(C`\-no\*(C'\fR и \f(CW\*(C`\-nb\*(C'\fR доступными
в файле шаблонов.
.PP
Строки в файлах шаблонов, начинающиеся с символа номера (\f(CW\*(C`#\*(C'\fR), являются
комментариями. Обычно в них записываются подсказки для переводчиков, и они
вырезаются программой \fBpo2debconf\fR. В \f(CW\*(C`po\-debconf\*(C'\fR 1.0 введены специальные
комментарии, которые имеют вид \f(CW\*(C`#flag:\f(CIdirective\f(CW\*(C'\fR. \f(CW\*(C`#flag:partial\*(C'\fR
является директивой для \fBpo2debconf\fR. Обычно, когда поле состоит из
нескольких параграфов (например, в \f(CW\*(C`_\|_Choices\*(C'\fR и \f(CW\*(C`_Description\*(C'\fR), оно
считается переведённым, только если переведены все параграфы. Если перед
полем указан \f(CW\*(C`#flag:partial\*(C'\fR, то переведённые строки могут быть вместе с
непереведёнными.
.SH "ПАРАМЕТРЫ"
.IX Header "ПАРАМЕТРЫ"
.IP "\fB\-h\fR, \fB\-\-help\fR" 4
.IX Item "-h, --help"
Показать справку по использованию и завершить работу.
.IP "\fB\-v\fR, \fB\-\-verbose\fR" 4
.IX Item "-v, --verbose"
Выводить подробности работы.
.IP "\fB\-\-podir=\f(BIКАТ\fB\fR" 4
.IX Item "--podir=КАТ"
Указать каталог для PO\-файлов. По умолчанию, PO\-файлы ищутся в подкаталоге
\&\fIpo\fR, который находится ниже местоположения мастер\-файла.
.IP "\fB\-o\fR, \fB\-\-output=\f(BIФАЙЛ\fB\fR" 4
.IX Item "-o, --output=ФАЙЛ"
Файл результата (по умолчанию используется стандартный вывод).
.IP "\fB\-e\fR, \fB\-\-encoding=\f(BIСТРОКА\fB\fR" 4
.IX Item "-e, --encoding=СТРОКА"
Преобразование кодировки. Параметр может принимать три значения: \f(CW\*(C`utf8\*(C'\fR
(преобразование в \s-1UTF\-8\s0), \f(CW\*(C`po\*(C'\fR (не изменять кодировку) и \f(CW\*(C`popular\*(C'\fR
(преобразование кодировки входных файлов зависит от их языка; переменная
среды \f(CW\*(C`PODEBCONF_ENCODINGS\*(C'\fR должна указывать на имя файла, содержащего
таблицу перекодировки).
.Sp
Такой файл приблизительно выглядит так:
.Sp
.Vb 7
\&  #
\&  #   # \-\- символ комментария
\&  #
\&  cs       ISO\-8859\-2
\&  da       ISO\-8859\-1
\&  de       ISO\-8859\-1
\&  el       ISO\-8859\-7
.Ve
.Sp
и т.д.
.Sp
Для кодировки по умолчанию использовалось \f(CW\*(C`popular\*(C'\fR, было изменено на
\&\f(CW\*(C`utf8\*(C'\fR начиная с po-debconf 0.9.0.
.SH "ВЫХОДНОЙ ФОРМАТ"
.IX Header "ВЫХОДНОЙ ФОРМАТ"
Начиная с debconf 1.2.0, был изменён формат шаблонов, кодировка стала частью
имени поля, то есть теперь это выглядит как
\&\f(CW\*(C`foo\-\f(CIязык\f(CW.\f(CIкодировка\f(CW\*(C'\fR. Если старые версии debconf обнаруживают такие
поля, то они их просто игнорируют и показывают оригинальный текст.
.PP
Можно изменить кодировку по умолчанию и выходной формат, создав файл
\&\fIpo/output\fR. Он содержит одну строку с двумя полями, первое поле задаёт
выходной формат (в данный момент допустимыми значениями первого поля
являются 1 для формата \f(CW\*(C`foo\-\f(CIязык\f(CW\*(C'\fR и 2 для \f(CW\*(C`foo\-\f(CIязык\f(CW.\f(CIкодировка\f(CW\*(C'\fR),
а второе поле задаёт кодировку, например
.PP
.Vb 1
\&   echo \*(Aq2 utf8\*(Aq > po/output
.Ve
.PP
тогда \fBpo2debconf\fR преобразует текст в \s-1UTF\-8.\s0
.PP
Если кодировка задана как \f(CW\*(C`po\*(C'\fR или \f(CW\*(C`utf8\*(C'\fR, то выходной формат всегда
устанавливается в 2, для того чтобы старые версии debconf не пытались
показывать текст с неправильной кодировкой.
.SH "СМОТРИТЕ ТАКЖЕ"
.IX Header "СМОТРИТЕ ТАКЖЕ"
\&\fBdebconf\-gettextize\fR\|(1), \fBdebconf\-updatepo\fR\|(1), \fBpo\-debconf\fR\|(7).
.SH "АВТОР"
.IX Header "АВТОР"
.Vb 1
\&  Дэнис Барбье (Denis Barbier) <barbier@linuxfr.org>
.Ve