Translation:
debian−l10n−russian [AT] lists.org
Yuri Kozlov <kozlov.y [AT] gmail.com>, 2005, 2006
НАЗВАНИЕ
po2debconf -- объединяет мастер−файл шаблонов и PO−файлы
СИНТАКСИС
po2debconf [−v] [−h] [−−podir=КАТАЛОГ] [−o ФАЙЛ] [−e СТРОКА] мастер_файл
ОПИСАНИЕ
Эта программа читает все PO−файлы и один templates файл, и создаёт файл шаблонов Debconf, содержащий все переводы, подобно тому, как это делает debconf−mergetemplate(1) (из пакета "debconf−utils"). По умолчанию, PO−файлы ищутся в подкаталоге po, который находится ниже местоположения мастер−файла.
Чтобы помочь норвежскому Bokmål в переходе с одного кода языка на другой, коды no и nb обрабатываются специальным образом. Если существует no.po, то он должен быть переименован в nb.po. Использование nb.po делает переводы "−no" и "−nb" доступными в файле шаблонов.
Строки в файлах шаблонов, начинающиеся с символа номера ("#"), являются комментариями. Обычно в них записываются подсказки для переводчиков, и они вырезаются программой po2debconf. В "po−debconf" 1.0 введены специальные комментарии, которые имеют вид "#flag:directive". "#flag:partial" является директивой для po2debconf. Обычно, когда поле состоит из нескольких параграфов (например, в "__Choices" и "_Description"), оно считается переведённым, только если переведены все параграфы. Если перед полем указан "#flag:partial", то переведённые строки могут быть вместе с непереведёнными.
ПАРАМЕТРЫ
−h, −−help
Показать справку по использованию и завершить работу.
−v, −−verbose
Выводить подробности работы.
−−podir=КАТ
Указать каталог для PO−файлов. По умолчанию, PO−файлы ищутся в подкаталоге po, который находится ниже местоположения мастер−файла.
−o, −−output=ФАЙЛ
Файл результата (по умолчанию используется стандартный вывод).
−e, −−encoding=СТРОКА
Преобразование кодировки. Параметр может принимать три значения: "utf8" (преобразование в UTF−8 ), "po" (не изменять кодировку) и "popular" (преобразование кодировки входных файлов зависит от их языка; переменная среды "PODEBCONF_ENCODINGS" должна указывать на имя файла, содержащего таблицу перекодировки).
Такой файл приблизительно выглядит так:
# # # −− символ комментария # cs ISO−8859−2 da ISO−8859−1 de ISO−8859−1 el ISO−8859−7
и т.д.
Для кодировки по умолчанию использовалось "popular", было изменено на "utf8" начиная с po-debconf 0.9.0.
ВЫХОДНОЙ ФОРМАТ
Начиная с debconf 1.2.0, был изменён формат шаблонов, кодировка стала частью имени поля, то есть теперь это выглядит как "foo−язык.кодировка". Если старые версии debconf обнаруживают такие поля, то они их просто игнорируют и показывают оригинальный текст.
Можно изменить кодировку по умолчанию и выходной формат, создав файл po/output. Он содержит одну строку с двумя полями, первое поле задаёт выходной формат (в данный момент допустимыми значениями первого поля являются 1 для формата "foo−язык" и 2 для "foo−язык.кодировка"), а второе поле задаёт кодировку, например
echo '2 utf8' > po/output
тогда po2debconf преобразует текст в UTF−8.
Если кодировка задана как "po" или "utf8", то выходной формат всегда устанавливается в 2, для того чтобы старые версии debconf не пытались показывать текст с неправильной кодировкой.
СМОТРИТЕ ТАКЖЕ
debconf−gettextize(1), debconf−updatepo(1), po−debconf(7).
АВТОР
Дэнис Барбье (Denis Barbier) <barbier [AT] linuxfr.org>