Alterator/i18n

<onlyinclude>
=== Локализация ===
В alterator встроена система автоматического перевода текстовых сообщений на язык пользователя. Для того чтобы её задействовать необходимо отметить эти сообщения в описании интерфейса специальным образом и указать название используемого словаря.

==== Описание интерфейса ====
Если адрес описания интерфейса ''/<модуль>/foo/bar'', то по умолчанию этому интерфейсу сопоставляется словарь ''alterator-<модуль>'' и соответственно имя его специально указывать не надо.

Вы можете явно указать другой словарь с помощью команды po-domain. Кроме того другой словарь можно задавать явно для каждого сообщения. 

Пример для qt:
<source lang="scheme">...
(po-domain "основной словарь")
...
(label text (_ "текст"))
(label text (_ "текст" "дополнительный словарь"))
...
</source>
Инструкцией <tt>po-domain</tt> можно задать основной словарь, если он не должно вычисляться автоматически из адреса модуля.
Функция <tt>_</tt> используется для получения перевода, принимает необязательный второй параметр, указывающий словарь.

Пример для html:
<source lang="html4strict">
<html po-domain="основной словарь" ... >
...
  <span translate="_">текст</span>
  <span translate="дополнительный словарь">текст</span>
...
  <input name="name" value="будет переведено" translate="_"/>
</html>
</source>
Необязательным атрибутом <tt>po-domain</tt> можно задать основной словарь, если он не должно вычисляться автоматически.

Атрибут <tt>translate</tt>  применяется к span и input типа reset и submit. Наличие атрибута означает, что содержимое данного span или value данного input надо перевести используя указанный словарь, "_" -- означает основной словарь. Для обратной совместимости с предыдущими модулями если у input атрибут translate отсутствует, то value всё-равно переводится и используется словарь по умолчанию.

==== Бэкенды ====

Команды, приходящие к бэкенду, содержат информацию о языке используемом для переводов (параметр language). Перевод сообщений в бэкендах устроен по тому же принципу что и в описаниях интерфейсов:
* основной словарь указывается явно или вычисляется как "alterator-<бэкенд>".
* есть функции для переводов, они или используют основной словарь или тот что указан в дополнительном параметре.

===== Бэкенд на shell =====

<source lang="bash">
po_domain="название словаря"
...
  write_enum_item "aaa" "`_ "для перевода используется основной словарь"`"
  write_enum_item "bbb" "`_ "для перевода используется дополнительный словарь" "дополнительный словарь"`"
</source>
Переменная <tt>po_domain</tt> содержит имя основного словаря. Функция <tt>_</tt> используется для получения перевода, принимает необязательный второй параметр, указывающий словарь.
Предпочтительно использовать обратные кавычки '`' вместо конструкции $() ибо последняя не подхватывается утилитой xgettext.

===== Бэкенд на perl =====

<source lang="perl">
$TEXTDOMAIN = "название словаря"
...
write_string_param("aaa", _("text"));
write_string_param("bbb", _("text", "дополнительный словарь"));
</source>

==== Desktop-файлы ====

Из desktop-файлов для перевода берутся поля Name и Comment...

==== Единая база переводов ====

Для переводов стоит пользоваться единой базой переводов '''alterator-l10n'''. Данный пакет содержит переводы для всех модулей альтераторов. Тем самым достигается единый стиль названий (например перевод «Apply» и «Reset»). Чтобы подключить модуль к единой базе необходимо выполнить следующие действия:
# свяжитесь с мантейнером пакета alterator-l10n ({{man|inger}}, {{man|slazav}}, {{man|cas}}) и сообщите URL репозитория в [http://git.altlinux.org git.altlinux.org]
# дождитесь когда ваш пакет будет включён в alterator-l10n
# добавьте пакет alterator-l10n в сборочные зависимости модуля (тег BuildPreReq)

После этого при каждой сборке пакета автоматически будут создаваться и размещаться в результирующем rpm-пакете) переводы для всех поддерживаемых языков.
Если в вашем модуле уже были свои варианты переводов (каталог po), то их надо удалить вместе с pot-файлом.
</onlyinclude>

[[Alterator/AlteratorL10N]] --  Более актуальтая информация о alterator-rl10n


{{Alterator modules-nav}}