Alterator/i18n: различия между версиями

Текущая версия от 20:21, 20 июля 2015

Интернационализация

Интернационализация (i18n) — процесс подготовки приложения для работы с разноязычными пользователями. Традиционно приложение пишется на английском языке, а затем готовится словарь для перевода строк на английском языке на родной язык пользователя.

За интернационализацией приложения следует его локализация. Интернационализацию выполняет разработчик модуля при помощи команды make update-po, а локализацию — переводчик.

Хорошим тоном считается автоматически создаваемый словарь. Для этого строковые ресурсы в приложении подлежащие переводу оформляются особым образом. Подобное оформление зависит от используемого языка программирования.

Описание интерфейса

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

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

Пример для qt:

...
(po-domain "основной словарь")
...
(label text (_ "текст"))
(label text (_ "текст" "дополнительный словарь"))
...

Инструкцией po-domain можно задать основной словарь, если он не должен вычисляться автоматически из адреса модуля. Функция _ используется для получения перевода, принимает необязательный второй параметр, указывающий словарь.

Пример для html:

<html po-domain="основной словарь" ... >
...
  <span translate="_">текст</span>
  <span translate="дополнительный словарь">текст</span>
...
  <input name="name" value="будет переведено" translate="_"/>
</html>

Необязательным атрибутом po-domain можно задать основной словарь, если он не должен вычисляться автоматически.

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

Бэкенды

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

основной словарь указывается явно или вычисляется как «alterator-<бэкенд>».
есть функции для переводов, они или используют основной словарь или тот что указан в дополнительном параметре.

Бэкенд на shell

po_domain="название словаря"
...
  write_enum_item "aaa" "`_ "для перевода используется основной словарь"`"
  write_enum_item "bbb" "`_ "для перевода используется дополнительный словарь" "дополнительный словарь"`"

Переменная po_domain содержит имя основного словаря. Функция _ используется для получения перевода, принимает необязательный второй параметр, указывающий словарь. Предпочтительно использовать обратные кавычки '`' вместо конструкции $() ибо последняя не подхватывается утилитой xgettext.

Бэкенд на perl

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

Desktop-файлы

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

Alterator

Alterator • Alterator/Master Class • Alterator FAQ • Alterator-ahttpd-server reload with systemd • Alterator/Alterator-vm next • Alterator-zabbix-node: Развёртывание центра мониторинга • Alterator/Alterator-net-domain • Alterator/JSON • Alterator/libraries • Alterator:Установщик • Alterator/architecture • Alterator/catch message • Alterator/class alterator-listbox • Alterator/class test and btn • Alterator/debug • Alterator/etcgit • Alterator/form • Alterator/html-validate • Alterator/i18n • Alterator/Ideas • Alterator/l10n • Alterator/objects • Alterator/PackageManagementProposal • Alterator/ruby • Alterator/shell • Alterator/todo • Alterator/translate • Alterator/woo • Виджеты • Выпуски Alterator • Инструментарий для развёртывания Zabbix-ноды • Модули Alterator • Настройка внешнего вида Alterator • Первое знакомство с альтератором • Управление пользователями в LDAP • ЦУС • Категория:Alterator modules • Категория:Alterator releases • Категория:Alterator-Установщик • Категория:Виджеты Alterator • Категория:Модули Alterator

@@ Строка 1: / Строка 1: @@
-[[Category:Sisyphus]]
+<onlyinclude>
-=== Локализация ===
+=== Интернационализация ===
-В alterator встроена система автоматического перевода текстовых сообщений на язык пользователя. Для того чтобы её задействовать необходимо отметить эти сообщения в описании интерфейса специальным образом и указать название используемого словаря.
+[[ruwp:Интернационализация|Интернационализация]] (i18n) — процесс подготовки приложения для работы с разноязычными пользователями. Традиционно приложение пишется на английском языке, а затем готовится словарь для перевода строк на английском языке на родной язык пользователя.
+За интернационализацией приложения следует его [[Alterator/l10n|локализация]]. Интернационализацию выполняет разработчик модуля при помощи команды {{cmd|make update-po}}, а локализацию — переводчик.
+Хорошим тоном считается автоматически создаваемый словарь. Для этого строковые ресурсы в приложении подлежащие переводу оформляются особым образом. Подобное оформление зависит от используемого языка программирования.
 ==== Описание интерфейса ====
 Если адрес описания интерфейса ''/<модуль>/foo/bar'', то по умолчанию этому интерфейсу сопоставляется словарь ''alterator-<модуль>'' и соответственно имя его специально указывать не надо.
 Вы можете явно указать другой словарь с помощью команды po-domain. Кроме того другой словарь можно задавать явно для каждого сообщения.
 Пример для qt:
-<pre>...
+<source lang="lisp">...
 (po-domain "основной словарь")
 ...
 (label text (_ "текст"))
 (label text (_ "текст" "дополнительный словарь"))
-...</pre>
+...
-Инструкцией <tt>po-domain</tt> можно задать основной словарь, если он не должно вычисляться автоматически из адреса модуля.
+</source>
+Инструкцией <tt>po-domain</tt> можно задать основной словарь, если он не должен вычисляться автоматически из адреса модуля.
 Функция <tt>_</tt> используется для получения перевода, принимает необязательный второй параметр, указывающий словарь.
 Пример для html:
-<pre><html po-domain="основной словарь" ... >
+<source lang="html4strict">
+<html po-domain="основной словарь" ... >
 ...
    <span translate="_">текст</span>
@@ Строка 26: / Строка 32: @@
 ...
    <input name="name" value="будет переведено" translate="_"/>
-</html></pre>
+</html>
-Необязательным атрибутом <tt>po-domain</tt> можно задать основной словарь, если он не должно вычисляться автоматически.
+</source>
+Необязательным атрибутом <tt>po-domain</tt> можно задать основной словарь, если он не должен вычисляться автоматически.
-Атрибут <tt>translate</tt>  применяется к span и input типа reset и submit. Наличие атрибута означает, что содержимое данного span или value данного input надо перевести используя указанный словарь, "_" -- означает основной словарь. Для обратной совместимости с предыдущими модулями если у input атрибут translate отсутствует, то value всё-равно переводится и используется словарь по умолчанию.
-==== Бакенды ====
+Атрибут <tt>translate</tt> применяется к span и input типа reset и submit. Наличие атрибута означает, что содержимое данного span или value данного input надо перевести используя указанный словарь, «_» — означает основной словарь. Для обратной совместимости с предыдущими модулями если у input атрибут translate отсутствует, то value всё-равно переводится и используется словарь по умолчанию.
-Команды, приходящие к бакенду, содержат информацию о языке используемом для переводов (параметр language). Перевод сообщений в бакендах устроен по тому же принципу что и в описаниях интерфейсов:
+==== Бэкенды ====
-* основной словарь указывается явно или вычисляется как "alterator-<бакенд>".
+Команды, приходящие к бэкенду, содержат информацию о языке используемом для переводов (параметр language). Перевод сообщений в бэкендах устроен по тому же принципу что и в описаниях интерфейсов:
+* основной словарь указывается явно или вычисляется как «alterator-<бэкенд>».
 * есть функции для переводов, они или используют основной словарь или тот что указан в дополнительном параметре.
-===== Бакенд на shell =====
+===== Бэкенд на shell =====
+<source lang="bash">
-<pre>po_domain="название словаря"
+po_domain="название словаря"
 ...
    write_enum_item "aaa" "`_ "для перевода используется основной словарь"`"
-   write_enum_item "bbb" "`_ "для перевода используется дополнительный словарь" "дополнительный словарь"`"</pre>
+   write_enum_item "bbb" "`_ "для перевода используется дополнительный словарь" "дополнительный словарь"`"
+</source>
 Переменная <tt>po_domain</tt> содержит имя основного словаря. Функция <tt>_</tt> используется для получения перевода, принимает необязательный второй параметр, указывающий словарь.
 Предпочтительно использовать обратные кавычки '`' вместо конструкции $() ибо последняя не подхватывается утилитой xgettext.
-===== Бакенд на perl =====
+===== Бэкенд на perl =====
+<source lang="perl">
-<pre>$TEXTDOMAIN = "название словаря"
+$TEXTDOMAIN = "название словаря"
 ...
 write_string_param("aaa", _("text"));
-write_string_param("bbb", _("text", "дополнительный словарь"));</pre>
+write_string_param("bbb", _("text", "дополнительный словарь"));
+</source>
-==== Единая база переводов ====
+==== Desktop-файлы ====
+Из desktop-файлов для перевода берутся поля Name и Comment…
-Для переводов стоит пользоваться единой базой переводов '''alterator-l10n'''. Данный пакет содержит переводы для всех модулей альтераторов. Тем самым достигается единый стиль названий (например перевод "Apply" и "Reset"). Чтобы подключить модуль к единой базе необходимо выполнить следующие действия:
+{{Category navigation|title=Alterator|category=Alterator|sortkey={{SUBPAGENAME}}}}
-# сказать make update-po и получить файл-заготовку
-# связаться с мантейнером пакета alterator-l10n (inger@, cas@) и переслать свой .pot файл.
-# Дождитесь когда ваш пакет будет включён в alterator-l10n
-# Добавить пакет alterator-l10n в сборочные зависимости модуля (buildprereq)
-После этого при каждой сборке пакета автоматически будут создаваться и размещаться в результирующем rpm-пакете) переводы для всех поддерживаемых языков. Если в вашем модуле уже были свои варианты переводов (файлы po/<language>.po), то их надо удалить.