Alterator/i18n

Материал из ALT Linux Wiki

(Различия между версиями)
Перейти к: навигация, поиск
(→Локализация)
Строка 1: Строка 1:
<onlyinclude>
<onlyinclude>
 +
=== Интернационализация ===
=== Интернационализация ===
-
[[ruwp:Интернационализация|Интернационализация]] (i18n) - процесс подготовки приложения для работы с разноязычными пользователями. Традиционно приложение пишется на английском языке, а затем готовится словарь для перевода строк на английском языке на родной язык пользователя.
+
[[ruwp:Интернационализация|Интернационализация]] (i18n) — процесс подготовки приложения для работы с разноязычными пользователями. Традиционно приложение пишется на английском языке, а затем готовится словарь для перевода строк на английском языке на родной язык пользователя.
-
За интернационализацией приложения следует его [[Alterator/l10n|локализация]]. Интернационализацию выполняет разработчик модуля, а локализацию - переводчик.
+
За интернационализацией приложения следует его [[Alterator/l10n|локализация]]. Интернационализацию выполняет разработчик модуля, а локализацию — переводчик.
Хорошим тоном считается автоматически создаваемый словарь. Для этого строковые ресурсы в приложении подлежащие переводу оформляются особым образом. Подобное оформление зависит от используемого языка программирования.
Хорошим тоном считается автоматически создаваемый словарь. Для этого строковые ресурсы в приложении подлежащие переводу оформляются особым образом. Подобное оформление зависит от используемого языка программирования.
Строка 10: Строка 11:
Если адрес описания интерфейса ''/<модуль>/foo/bar'', то по умолчанию этому интерфейсу сопоставляется словарь ''alterator-<модуль>'' и соответственно имя его специально указывать не надо.
Если адрес описания интерфейса ''/<модуль>/foo/bar'', то по умолчанию этому интерфейсу сопоставляется словарь ''alterator-<модуль>'' и соответственно имя его специально указывать не надо.
-
Вы можете явно указать другой словарь с помощью команды po-domain. Кроме того другой словарь можно задавать явно для каждого сообщения.  
+
Вы можете явно указать другой словарь с помощью команды po-domain. Кроме того другой словарь можно задавать явно для каждого сообщения.
Пример для qt:
Пример для qt:
Строка 35: Строка 36:
Необязательным атрибутом <tt>po-domain</tt> можно задать основной словарь, если он не должно вычисляться автоматически.
Необязательным атрибутом <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). Перевод сообщений в бэкендах устроен по тому же принципу что и в описаниях интерфейсов:
Команды, приходящие к бэкенду, содержат информацию о языке используемом для переводов (параметр language). Перевод сообщений в бэкендах устроен по тому же принципу что и в описаниях интерфейсов:
-
* основной словарь указывается явно или вычисляется как "alterator-<бэкенд>".
+
* основной словарь указывается явно или вычисляется как «alterator-<бэкенд>».
* есть функции для переводов, они или используют основной словарь или тот что указан в дополнительном параметре.
* есть функции для переводов, они или используют основной словарь или тот что указан в дополнительном параметре.
===== Бэкенд на shell =====
===== Бэкенд на shell =====
-
 
<source lang="bash">
<source lang="bash">
po_domain="название словаря"
po_domain="название словаря"
Строка 55: Строка 54:
===== Бэкенд на perl =====
===== Бэкенд на perl =====
-
 
<source lang="perl">
<source lang="perl">
$TEXTDOMAIN = "название словаря"
$TEXTDOMAIN = "название словаря"
Строка 64: Строка 62:
==== Desktop-файлы ====
==== Desktop-файлы ====
-
Из desktop-файлов для перевода берутся поля Name и Comment...
+
Из desktop-файлов для перевода берутся поля Name и Comment…
 +
 
 +
[[Категория:Alterator]]

Версия 17:13, 12 апреля 2009


Содержание

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

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

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

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

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

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

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

Пример для qt: 

"основной словарь""текст""текст" "дополнительный словарь"))
...

Инструкцией 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…

 
Личные инструменты