ОПИСАНИЕ¶

ВВЕДЕНИЕ¶

СИНТАКСИС ФАЙЛА НАСТРОЙКИ¶

Определение путей к входным файлам переводчика

Автоопределение путей и языков

Определение документов для перевода

Определение параметров для модулей

Определение ссылок (aliases)

Раздельный режим

ПАРАМЕТРЫ¶

EXAMPLE¶

НЕДОСТАТКИ¶

СМОТРИ ТАКЖЕ¶

АВТОРЫ¶

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

Определение шаблона языков¶

Эта дополнительная команда может упростить весь файл настройки и сделать его более масштабируемым. Вам необходимо указать список языков, на которые вы хотите перевести документы. Это довольно просто:

 [po4a_langs] fr de

Это позволит вам расширить $lang на все определённые языки в оставшейся части файла настройки.

Определение путей к входным файлам переводчика¶

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

 [po4a_paths] doc/l10n/project.doc.pot \
              fr:doc/l10n/fr.po de:doc/l10n/de.po

Вызывается команда [po4a_paths]. Первым аргументом является путь к используемому POT файлу. Следующие аргументы носят говорящие сами за себя названия:

    <lang>:<path to the PO file for this lang>

Если вы определили шаблон языков, то вы можете переписать строку выше следующим образом:

 [po4a_paths] doc/l10n/project.doc.pot $lang:doc/l10n/$lang.po

You can also use $master to refer to the document filename. In this case, po4a will use a split mode: one POT and one PO (for each language) will be created for each document specified in the po4a configuration file. See the Split mode section.

 [po4a_paths] doc/$master/$master.pot $lang:doc/$master/$lang.po

Автоопределение путей и языков¶

Эта команда не должна использоваться вместе с командами [po4a_langs] или [po4a_paths].

При использовании этой команды, вы должны создать пустой POT файл при первом вызове po4a, чтобы указать имя POT файла.

 [po_directory] po4a/po/

Определение документов для перевода¶

 [type: sgml] doc/my_stuff.sgml fr:doc/fr/mon_truc.sgml \
              de:doc/de/mein_kram.sgml
 [type: pod] script fr:doc/fr/script.1 de:doc/de/script.1 \
             add_fr:doc/l10n/script.fr.add

Это должно быть понятно само по себе. Заметим, что во втором случае doc/l10n/script.fr.add является дополнением, предназначенным для добавления к французской версии этого документа. Пожалуйста, прочитайте po4a(7), чтобы узнать подробней о дополнениях.

Более детально, формат имеет вид:

 [type: <format>] <master_doc> (<lang>:<localized_doc>)* \
                  (add_<lang>:<modifier>*<addendum_path>)*

Если модификатор отсутствует, addendum_path является путём к дополнению. Модификаторами являются

?

Если этот файл не существует, то включить addendum_path , в противном случае ничего не делать.

@

addendum_path is not a regular addendum but a file containing a list of addenda, one by line. Each addendum may be preceded by modifiers.

!

addendum_path отбрасывается, он не загружается и не будет загружаться никакими будущими дополнениями.

Если вы определили шаблон языков, то вы можете переписать строку выше следующим образом:

 [type: pod] script $lang:doc/$lang/script.1 \
             add_fr:doc/l10n/script.fr.add

Если бы все языки имели дополнения с подобными путями, можно было бы написать что-то вроде:

 [type: pod] script $lang:doc/$lang/script.1 \
             add_$lang:doc/l10n/script.$lang.add

Определение параметров для модулей¶

If you need a specific option for one of the documents you want to translate, you can also specify it in the configuration file. Options are introduced by the opt keyword. The argument of the opt keyword must be quoted with double quotes if it contains a space (e.g. if you specify multiple options, or an option with an argument). You can also specify options that will only apply to a specific language by using the opt_lang keyword.

Ниже приведен пример: [type:man] t-05-config/test02_man.1 $lang:tmp/test02_man.$lang.1 \ opt:"-k 75" opt_it:"-L UTF-8" opt_fr:-v

Аргументы могут содержать пробелы, если вы используете одинарные или двойные кавычки: [po4a_alias:man] man opt:"-o \"mdoc=NAME,SEE ALSO\" -k 20"

Если вы хотите использовать одни и те же параметры для нескольких документов, можете использовать псевдоним (см. раздел Specifying aliases ниже по тексту).

Вы также можете установить параметры для всех документов, указанных в файле настроек: [options] opt:"..." opt_fr:"..."

Определение ссылок (aliases)¶

 [po4a_alias:test] man opt:"-k 21" opt_es:"-o debug=splitargs"

Таким образом определяется псевдоним модуля с именем test, основанный на модуле man, с ключём -k 21 - для всех языков и с ключём -o debug=splitargs - только для перевода на Испанский.

This module alias can then be used like a regular module:

 [type:test] t-05-config/test02_man.1 $lang:tmp/test02_man.$lang.1 \
            opt_it:"-L UTF-8" opt_fr:-v

Обратите внимание, что вы можете указать дополнительные параметры для каждого файла.

Раздельный режим¶

В случае применения раздельного режима используются большой временный POT и большие временные PO файлы. Это позволяет распределить переводы во все PO файлы.

Если два PO файла имеют различные переводы для одной и той же строки, po4a будет помечать данные строчки как неточно переведённые и потребует подтвердить переводы во всех PO файлах, содержащих данную строку. Затем, когда переводчик обновит перевод и снимет пометку "неточно переведённый" с одного PO файла, перевод данной строки будет обновлен в каждом PO файле автоматически.

If there are name conflicts because several files have the same filename, the name of the master file can be specified by adding a "master:file="name option:

 [po4a_langs] de fr ja
 [po4a_paths] l10n/po/$master.pot $lang:l10n/po/$master.$lang.po
 [type: xml] foo/gui.xml $lang:foo/gui.$lang.xml master:file=foo-gui
 [type: xml] bar/gui.xml $lang:bar/gui.$lang.xml master:file=bar-gui

OPTIONS WHICH MODIFY POT HEADER¶

--porefs type[,wrap|nowrap]

Specify the reference format. Argument type can be one of never to not produce any reference, file to only specify the file without the line number, counter to replace line number by an increasing counter, and full to include complete references (default: full).

Argument can be followed by a comma and either wrap or nowrap keyword. References are written by default on a single line. The wrap option wraps references on several lines, to mimic gettext tools (xgettext and msgmerge). This option will become the default in a future release, because it is more sensible. The nowrap option is available so that users who want to keep the old behavior can do so.

--msgid-bugs-address email@address

Установить адрес для посылки сообщений о msgid ошибках. По умолчанию, созданные POT файлы не имеют поля Report-Msgid-Bugs-To.

--copyright-holder string

Указать владельца авторских прав в заголовке POT файла. Значение по умолчанию "Free Software Foundation, Inc."

--package-name string

Указать имя пакета в заголовке POT файла. Значение по умолчанию "PACKAGE".

--package-version string

Указать версию пакета в заголовке POT файла. Значение по умолчанию "VERSION".

OPTIONS TO MODIFY PO FILES¶

--msgmerge-opt options

Дополнительные настройки для msgmerge(1).

Примечание: $lang будет распространён на текущий язык.

--no-previous

Данный параметр удаляет параметр --previous из настроек msgmerge. Это позволяет использовать версии gettext более ранние чем 0.16.

--previous

Данный параметр добавляет --previous к настройкам msgmerge. А это требует gettext версии 0.16 или выше, и активирован по умолчанию.

EXAMPLE¶

So for our case we would call

 cd man && po4a-gettextize -f man -m foo.1 -p foo.pot

You would then send this file to the appropriate language lists or offer it for download somewhere on your website.

Now let's assume you received three translations before your next release: de.po (including an addendum de.add), sv.po and pt.po. Since you don't want to change your Makefile(s) whenever a new translation arrives you can use po4a with an appropriate configuration file in your Makefile. Let's call it po4a.cfg. In our example it would look like the following:

 [po_directory] man/po4a/po/

 [type: man] man/foo.1 $lang:man/translated/$lang/foo.1 \
            add_$lang:?man/po4a/add_$lang/$lang.add opt:"-k 80"

In this example we assume that your generated man pages (and all PO and addenda files) should be stored in man/translated/$lang/ (respectively in man/po4a/po/ and man/po4a/add_$lang/) below the current directory. In our example the man/po4a/po/ directory would include de.po, pt.po and sv.po, and the man/po4a/add_de/ directory would include de.add.

Note the use of the modifier ? as only the German translation (de.po) is accompanied by an addendum.

To actually build the translated man pages you would then (once!) add the following line in the build target of the appropriate Makefile:

        po4a po4a.cfg

Once this is set up you don't need to touch the Makefile when a new translation arrives, i.e. if the French team sends you fr.po and fr.add then you simply drop them respectively in man/po4a/po/ and man/po4a/add_fr/ and the next time the program is built the French translation is automatically build as well in man/translated/fr/.

Note that you still need an appropriate target to install localized manual pages with English ones.

Finally if you do not store generated files into your version control system, you will need a line in your clean target as well: -rm -rf man/translated