The WebDevil » locales

Multilingual site on Rails

dm — Thu, 28 Aug 2008 22:29:35 +0000

Задавался давно уже вопросом о том, как сделать многоязычный сайт на рельсах. Сначала нехватало знаний, потом времени.
Недавно понадобилось таки реализовать такой сайт. Сразу скажу, получилось.

Первым делом задумался над переводом в шаблонах. Благо, тут вариантов было много и я выбрал simple-localization. С рельсами 2.1 работает версия 3.0. Но она ставится экспортом из svn:

cd vendor/plugins
svn co http://svn.arkanis.de/projects/rails_plugins/simple_localization/branches/3.0 simple_localization

Теперь можно вставлять конструкции l(:domain, :key), которые из файла перевода из раздела app: будут брать домен и ключ, указанные в методе. Кстати, я вынес файлы перевода в директорию translations в корень проекта.
Также в перевод я добавил массив с датами в родительном падеже (:declinable_monthnames).
Подключается плагин в config/initializers/simple_localization.rb строками:

SimpleLocalization.init :languages => [:ru, :en, :uk], :lang_file_dir => "#{RAILS_ROOT}/translations"

class Date
silence_warnings do
DECLINABLE_MONTHNAMES = ArkanisDevelopment::SimpleLocalization::ProxyObject.new :dates, :declinable_monthnames do |localized_data|
[nil] + localized_data
end
end
end

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

ActionController::Routing::Routes.draw do |map|

map.with_options :path_prefix => '/:lang' do |lang|
lang.connect 'news', :controller=>"news", :action=>"index"
lang.connect 'news/:id', :controller=>"news", :action=>"show"
lang.connect '', :controller=>"pages", :action=>"index"
lang.connect 'feedback', :controller=>"pages", :action=>"feedback"
lang.connect '*link', :controller=>"pages", :action=>"show"
end

map.root :controller => "pages", :action=>"index"
end

В app/controllers/application.rb добавил парочку методов и фильтр:

class ApplicationController < ActionController::Base
before_filter :localize
...
def localize
if params && params[:lang] && Localization.loaded_languages.include?(params[:lang].to_sym)
Localization.use params[:lang].to_sym
end
end

#it can accept only URL_FOR :(
def localized_redirect(url)
url = '' if url=='/'
redirect_to "/#{Localization.used.to_s}/#{url}"
end
end

Тут я задумался как работать с урлами. Ведь они же будут на корень ссылаться.
Так в config/initializers/simple_localization.rb был добавлен еще кусок кода, в котором переопределялись основные хелперы:

module ActionView
module Helpers
module UrlHelper
def url_for(options = {})
case options
when Hash
show_path = options[:host].nil? ? true : false
options = { :only_path => show_path }.update(options.symbolize_keys)
escape = options.key?(:escape) ? options.delete(:escape) : true
url = @controller.send(:url_for, options)
when String
escape = true
url = options
when NilClass
url = @controller.send(:url_for, nil)
else
escape = false
url = polymorphic_path(options)
end
url = escape ? escape_once(url) : url

if url =~ /\/.+/ and url !~ /^\/(#{Localization.loaded_languages.join('|')})(\/.+)?$/
url = "/#{Localization.used.to_s}#{url}"
end
url
end

def link_to(name, options = {}, html_options = nil)
url = case options
when String
self.url_for options
when :back
@controller.request.env["HTTP_REFERER"] || 'javascript:history.back()'
else
self.url_for(options)
end

if html_options
html_options = html_options.stringify_keys
href = html_options['href']
convert_options_to_javascript!(html_options, url)
tag_options = tag_options(html_options)
else
tag_options = nil
end

href_attr = "href=\"#{url}\"" unless href
"#{name || url}"
end

end
end
end

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

Теперь дело дошло и до хранения локализованого контента в БД. Вот как у меня устроена таблица Pages:

class CreatePages < ActiveRecord::Migration
def self.up
create_table :pages, :force=>true do |t|
t.string :lang, :title, :link, :null=>false
t.text :body
t.boolean :textilize, :default=>1, :null=>false
t.timestamps
end

add_index :pages, [:link, :lang], :unique=>true
add_index :pages, [:link]

end

def self.down
drop_table :pages
end
end

а в app/models/page.rb имеем следующее:

class Page < ActiveRecord::Base
named_scope :localized, :conditions=>{:lang=>Localization.used.to_s}
end

Так можно оперировать локализоваными страницами как Page.localized.

Вроде бы из интересного все, остальное рутина. Если у кого есть советы как что дополнить/измениь – с радостью выслушаю.

locales

dm — Tue, 07 Aug 2007 15:52:57 +0000

Сайт работает в cp1251. Не моя прихоть, так сложилось.

И вот в него вкручивается gettext. Все было бы неплохо, только из трех языков ru, en, uk – для последнего отсутствует локаль uk_UA.cp1251.

Я пол-дня мучался, пока добрый Rubik не направил в сторону localedef.

Итак, вот что вышло:

sudo localedef -f CP1251 -i en_US en_US.cp1251
sudo localedef -f CP1251 -i uk_UA uk_UA.cp1251

и локали появились. Теперь сайт спокойно использует их, а вместе с ним и gettext заработал.

gettext and cyrillic

dm — Tue, 07 Aug 2007 14:24:44 +0000

Возникла задача – подружить gettext и кириллицу. Да к тому же еще и кириллицу в cp1251. И, что самое главное, оригинальные строки для перевода в кириллице.

Попробовав Zend_Translate ощутил несоответствие идее:

require_once("Zend/Translate.php");

$translate = new Zend_Translate('gettext', '/my/path/source-de.mo', 'de');

print $translate->_("Example")."\n";

Вот что должно произойти если нет /my/path/source-de.mo? Правильно, должно отобразиться “Example”. На самом же деле отображаются матюки об отсутствии .mo. Что есть неправильно.

Кроме того Zend_Translate не предоставляет никаких возможностей по работе с кодировками.

Хоть я и приверженец ZF, но тут он меня сильно разочаровал.

Так я вернулся к стандартному подходу, несколько доправив его. Итак, вот что получилось:

locale -a

убедился что есть локаль ru_RU.cp1251 на сервере. В убунте если она отсутствует ее можно создать так:

sudo locale-gen ru_RU.CP1251

Отлично. Теперь очередь php:

$language = 'ru_RU.cp1251';
putenv("LANG=$language");
setlocale(LC_ALL, $language);

$domain = 'messages';
bindtextdomain($domain, "./locale");
bind_textdomain_codeset ($domain, 'cp1251');
textdomain($domain);

echo gettext("мегастрока");
?>

По сравнению со стандартным примером тут появилась такая строка:

bind_textdomain_codeset ($domain, 'cp1251');

Это говорит, что все строки будут нам возвращаться в cp1251.

Далее мы выдираем на сервере все строки для перевода:

xgettext ./*.php --from-code=cp1251

с указанием кодировки, в которой текст внутри, потому что по умолчанию gettext считает, что там ASCII.

Теперь внутри файла messages.po все лежит в UTF-8, и никаких проблем… если бы не cp1251, черт подери.

iconv -f utf-8 -t cp1251 ./messages.po > messages.po1251

Вот так мы конвертаем его в cp1251. Полученый файл редактируем, добавляя перевод, и кроме того заменяем в нем строку:

"Content-Type: text/plain; charset=UTF-8\n"

на

"Content-Type: text/plain; charset=CP1251\n"

Теперь переименовываем файл messages.po1251 и убираем из его имени 1251, затем делаем

msgfmt messages.po

и так получаем скомпилированый перевод. Который теперь работает Наконец-то.

А вообще русские строки в качестве ключей работают чудесно и без такого шаманства если они в UTF8.