Программирование на языке Ruby
Шрифт:
Отметим, что сообщения по умолчанию обязаны быть англоязычными (даже если родной язык программиста не английский). Нравится вам это или нет, но английский ближе всего к универсальному языку с точки зрения большинства переводчиков.
Я сказал, что нам пригодится программа
rake
. Создадим файл Rakefile
(в каталоге myapp
) для сопровождения справочников сообщений. Он будет выполнять две основные операции: обновлять РО-файлы и создавать МО-файлы.
require 'gettext/utils'
desc "Update pot/po files."
task :updatepo do
GetText.update_pofiles("myapp", ["person.rb"], "myapp 1.0.0")
end
desc "Create mo-files"
task :makemo do
GetText.create_mofiles
end
Здесь мы воспользовались библиотекой
gettext/utils
, в которой имеются функции для работы со справочниками сообщения. Метод update_pofiles
создает начальный файл myapp/ро/myapp.pot
на основе исходного текста person.rb
. При втором (и всех последующих) вызовах эта функция выполнит обновление, или слияние файла myapp/po/myapp.pot
и всех файлов вида myapp/po/#{lang}/myapp.ро
. Второй параметр — массив целевых файлов. Обычно он задается примерно так:
GetText.update_pofiles("myapp",
Dir.glob("{lib,bin}/**/*.{rb,rhtml}"),
"myapp 1.0.0")
Вызов метода
GetText.create_mofiles
создает необходимые подкаталоги в каталоге data/locale/
и генерирует МО-файлы из РО-файлов. Итак, выполнив команду
rake updatepo
, мы создадим каталог myapp/ро
, а в нем файл myapp.pot
. Теперь отредактируем заголовок файла
po/myapp.pot
. Он содержит описание приложения (название, имя автора, адрес электронной почты, условия лицензирования и т.д.).
# Пример приложения. (Осмысленное название)
# Copyright (С) 2006 Foo Bar (Автор приложения)
# Файл распространяется по лицензии XXX. (Лицензия)
#
# FIRST AUTHOR <EMAIL@ADDRESS>, YEAR. (Информация о переводчике)
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: myapp 1.0.0\n" (ID и версия проекта)
#...
Что такое маркер
fuzzy
? Так отмечается тот факт, что какая-то часть не переведена или перевод вызывает сомнения. Все автоматически сгенерированные сообщения помечаются таким образом, чтобы человек знал, что их нужно проверить и изменить. Файл
myapp.pot
нужно разослать переводчикам. (Конечно, вы можете перевести его и самостоятельно.) Предположим, что вы переводите на японский язык. На машине установлена локаль
ja_jp.UTF-8
, что означает «Япония (ja
), японский язык (JP
), кодировка UTF-8». Для начала скопируем файл
myapp.pot
в myapp.ро
. При наличии набора GNU-утилит gettext
лучше воспользоваться командой msginit
, а не просто cp
. Эта утилита учитывает переменные окружения и правильно устанавливает некоторые переменные в заголовке. В UNIX она вызывается следующим образом:
LANG=ja_JP.UTF-8 msginit -i myapp.pot -o myapp.po
Затем отредактируйте файл
myapp.ро
, как показано в листинге 4.3. Редактировать необходимо в той кодировке, которая указана в строке Content-Type
. Листинг 4.3. Файл myapp.ро после редактирования
# Пример приложения.
# Copyright (С) 2006 Foo Bar
# Файл распространяется по лицензии XXX.
#
# Ваше имя <yourname@foo.com>, 2006. (Вся информация о переводчике)
# (Удалите строку 'fuzzy')
msgid ""
msgstr ""
"Project-Id-Version: myapp 1.0.0\n"
"POT-Creation-Date: 2006-05-22 23:27+0900\n"
"PO-Revision-Date: 2006-05-23 14:39+0900\n"
# Информация о текущем переводчике.
"Last-Translator: Your Name <foo@bar.com>\n"
"Language-Team: Japanese\n" (Ваш язык)
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=UTF-8\n" (Кодировка файла)
"Content-Transfer-Encoding: 8bit \r."
# Форма множественного числа.
"Plural-Forms: nplurals=2; plural=(n != l);\n"
#: person.rb:12
msgid "Information"
msgstr "Jouhou"
#: person.rb:13
msgid "Name: %{name}, Age: %{age}"
msgstr "Namae: %{name}, Nenrei: %{age}"
#: person.rb:14
msgid "%{name} has a child."
msgid_plural "%{name} has %{num} children."
msgstr[0] "%{name} ha hitori kodomo ga imasu."
msgstr[1] "%{name) ha %{num} nin no kodomo ga imasu."
Тегом
msgid
помечается исходное сообщение, а тегом msgstr
— переведенное. При наличии строки msgid_plural
необходимо включить отдельные строки msgstr[i]
в соответствии с правилом Plural-Forms
. Индекс i
вычисляется на основе выражения Plural-Forms
. В данном случае при num != 1
используется msgstr[1]
(сообщение с существительным во множественном числе).
Поделиться:
Популярные книги
Я царь. Книга XXVIII
28. Дорогой барон!
Фантастика:
боевая фантастика
аниме
попаданцы
5.60
рейтинг книги
Воронцов. Перезагрузка. Книга 3
3. Воронцов. Перезагрузка
Фантастика:
попаданцы
альтернативная история
фэнтези
фантастика: прочее
6.00
рейтинг книги
Ожерелье Странника
Приключения:
исторические приключения
7.50
рейтинг книги
Последний реанорец. Том IV
3. Высшая Речь
Фантастика:
фэнтези
5.20
рейтинг книги
Полнолуние
Любовные романы:
остросюжетные любовные романы
8.87
рейтинг книги
Сборник коротких эротических рассказов
Любовные романы:
эро литература
love action
7.41
рейтинг книги
Эпоха Опустошителя. Том IV
4. Вечное Ристалище
Фантастика:
попаданцы
аниме
фэнтези
5.00
рейтинг книги
Менталист. Трансформация
4. Выиграть у времени
Фантастика:
фэнтези
альтернативная история
7.28
рейтинг книги
Параллельные миры
Научно-образовательная:
прочая научная литература
8.11
рейтинг книги
Наномашины, "Шива"! Том 7
7. Первый среди карапузов
Фантастика:
городское фэнтези
попаданцы
аниме
фэнтези
5.00
рейтинг книги
Я – Стрела. Трилогия
Я - Стрела
Любовные романы:
любовно-фантастические романы
эро литература
6.82
рейтинг книги
Апокриф
10. Фронтир
Фантастика:
боевая фантастика
космическая фантастика
космоопера
5.00
рейтинг книги
Последний Паладин
1. Путь Паладина
Фантастика:
фэнтези
попаданцы
аниме
5.00
рейтинг книги
Вольный Лекарь. Ученик. Трилогия
Вольный лекарь
Фантастика:
фэнтези
попаданцы
5.00