LOCALE::PO4A::DOCBOOK.3PM(1) | User Contributed Perl Documentation | LOCALE::PO4A::DOCBOOK.3PM(1) |
НАЗВАНИЕ
Locale::Po4a::Docbook: преобразование документов DocBook XML из/в PO-файлы
ОПИСАНИЕ
Целью проекта po4a (PO for anything, PO везде и для всего) является облегчение процесса перевода (и что более важно — поддержки перевода), используя инструменты gettext в тех случаях, когда их применение может выглядеть неожиданным, например для документации.
Locale::Po4a::Docbook — это модуль, предназначенным для помощи в переводе документов DocBook XML на другие [человеческие] языки.
СОСТОЯНИЕ ЭТОГО МОДУЛЯ
Этот модуль полностью функционален так как он полагается на модуль Locale::Po4a::Xml. Этот модуль только объявляет переводимые теги и атрибуты.
Единственная проблема в том, что он пока не поддерживает объектов-подстановок (entities), в том числе объектов-подстановок включения файлов, но вы можете переводить большинство этих файлов отдельно. И зачастую это упростит сопровождение оных.
ПЕРЕОПРЕДЕЛЕНИЕ ПОВЕДЕНИЯ ПО УМОЛЧАНИЮ ПАРАМЕТРАМИ КОМАНДНОЙ СТРОКИ
Поведение системного модуля по умолчанию настроено из соображений, что на всякий случай необходимо подстраховаться.
Например, по умолчанию тег <author> ожидает, что он будет находиться в секции <para>. Но вы можете использовать его непосредственно под <bookinfo>. В этом случае вы, возможно, захотите переводить его её независимо для каждого автора.
Если поведение по умолчанию модуля xml и унаследованных от него модулей вас не устраивает, вы можете передать некоторые параметры командной строки, дабы изменить данное поведение. Например, вы можете добавить следующее в файл настроек po4a:
opt:"-k 0 -o nodefault=\"<bookinfo> <author>\" \ -o break=\"<bookinfo> <author>\" \ -o untranslated=\"<bookinfo>\" \ -o translated=\"<author>\""
Это переопределит поведение по умолчанию для <bookinfo> и <author>, сделает так что <bookinfo> и <author> будут разбивать входной поток данный на этих тегах, установит, что содержимое тега <bookinfo> не должно переводиться и что содержимое <author>, напротив, должно переводиться.
СМОТРИТЕ ТАКЖЕ
Locale::Po4a::TransTractor(3pm), Locale::Po4a::Xml(3pm), po4a(7)
АВТОРЫ
Жорди Вилальта (Jordi Vilalta) <jvprat@gmail.com>
АВТОРСКИЕ ПРАВА И ЛИЦЕНЗИИ
Copyright © 2004 Жорди Вилальта (Jordi Vilalta) <jvprat@gmail.com> Copyright © 2007-2009 Николя Франсуа (Nicolas François) <nicolas.francois@centraliens.net>
Данная программа является свободным программным обеспечением; вы можете распространять и/или изменять её на условиях Универсальной общественной лицензии (GPL) GNU v2.0 или новее (см. файл COPYING).
2024-06-26 | perl v5.38.2 |