Программирование на языке Ruby
вернуться

Фултон Хэл
Шрифт:

• РО-файл — это переносимый объектный файл. Так называется текстовое (понятное человеку) представление справочника сообщений. У каждого такого файла есть вариант для различных поддерживаемых локалей. РОТ-файл — это шаблон.

• МО-файл — это переносимый двоичный файл справочника. Он создается из РО-файла. Библиотека для Ruby умеет читать только МО-файлы, но не РО-файлы.

• Текстовый домен — это, по существу, просто базовое имя МО-файла. Он ассоциирован с приложением (привязан к нему).

4.3.3. Локализация простого приложения

В следующем примере определяется класс Person, после чего с ним выполняются различные действия. Метод show выводит локализованные сообщения:

require 'gettext'

class Person

 include GetText

 def initialize(name, age, children_num)

@name, @age, @children_num = name, age, children_num

bindtextdomain("myapp")

 end

 def show

puts _("Information")

puts _("Name: %{name}, Age: %{age}") % {:name => @name, :age => @age}

puts n_("%{name} has a child.", "%{name} has %{num} children.",

@children_num) % {:name => @name, :num => @children_num}

 end

end

john = Person.new("John", 25, 1)

john.show

linda = Person.new("Linda", 30, 3)

linda.show

Предположим, что этот код сохранен в файле

myapp/person.rb
. Как вы скоро увидите, иерархия каталогов имеет значение. Вызов метода
bindtextdomain
связывает текстовый домен
"myapp"
с объектом
Person
во время выполнения.

В методе

show
есть три обращения к библиотеке
gettext
. Вызываемый метод называется
_
(одно подчеркивание), чтобы не отвлекать внимание.

Первое обращение просто выводит локализованное сообщение, соответствующее строке

"Information"
. Второе демонстрирует локализованное сообщение с двумя параметрами. В хэше задается список значений, подставляемых в строку. Интерполировать их напрямую нельзя, потому что это вступало бы в противоречие с основной целью: хранить в справочнике небольшое число сообщений.

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

Тот же метод можно вызвать и короче:

puts _("Name: %s, Age: %d") % [@name, @age]

Однако мы рекомендуем более длинную запись. Она понятнее и дает больше информации переводчику.

Метод

n_
предназначен для обработки единственного и множественного числа. Значение параметра
@children_num
— индекс, говорящий о том, какую из заранее заданных строк использовать. (Правило
Plural-Forms
, о котором я скоро расскажу, определяет порядок вычисления индекса.)

Отметим, что сообщения по умолчанию обязаны быть англоязычными (даже если родной язык программиста не английский). Нравится вам это или нет, но английский ближе всего к универсальному языку с точки зрения большинства переводчиков.

Я сказал, что нам пригодится программа

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.ро
. Второй параметр — массив целевых файлов. Обычно он задается примерно так: