The WebDevil » RoR

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.

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

Bzr rocks

dm — Wed, 02 Jul 2008 04:12:59 +0000

С первого знакомства мне очень понравился bazaar-ng. И вот почему.

Он нацелен на usability. И это видно сразу. Вот наверняка многие пользовались TortoiseSVN. Там все делается просто, легко и удобно, правда? А вот теперь пойдем в консоль удаленного сервера. И добавим маски для игнорирования файлов (логи, темпы, кеши всякие). А теперь еще добавим в репозитарий те два десятка сорсов в разных папках, которые написали/докопировали в проект.
Все svn это не проблематично, но несколько неудобно. В bzr же все это делается легким движением руки – правим .bzrignore в корне проекта добавляя маски, потом жмем bzr add && bzr commit.

Bzr ориентирован на ветки. И у меня получается ветка == проект. Я выгружаю себе его целиком. В результате в каждой папке нету папок .svn, есть лишь одна папка .bzr в корне проекта. Мне очень редко требовалось делать чекаут определенной папки из проекта.

Проект часто требуется обновить до того, что живет в репозитории. Bzr имеет т.н. легковесные чекауты, которые не содержат подробной истории изменений. Как-раз то, что чаще всего нужно на рабочем сервере.

Также весьма порадовала только-что сложившаяся ситуация: я делал commit, и внезапно пропал линк. bzr стоял и терпеливо ждал, пока я ребутнул модем. Как только пинги появились, он все быстро завершил. Ни обрывов, ни страшных ругательств небыло.

Что касается скорости работы – она вполне приемлема. Да, есть системы и быстрее, но bzr меня вполне устраивает. Кроме того, мне абсолютно неважно, будет коммит выполняться 5 или 10 секунд, или даже 20 – я же не собираюсь безостановочно коммитить.

Навеяно впечатлениями о Git.

Railsforum.ru

dm — Thu, 17 Jan 2008 23:24:17 +0000

Открылся новый ресурс – http://www.railsforum.ru.
Прошу любить и жаловать.

rails and bzr

dm — Wed, 16 Jan 2008 10:50:43 +0000

Попробовал bzr и остался весьма доволен.

Что же из себя представляет Bazaar? Bzr – распределенная система контроля версий. После SVN такой термин не совсем понятен. И зачем на что-то переходить когда и SVN отлично работает?
Распределенная система контроля версий не привязана к серверу. Что случится если в процессе работы над проектом теряется свзять с svn-сервером? Система рассчитана на обязательное его наличие. Как результат – работаем дальше без истории изменений.
А что же дает bzr?
Локальные коммиты. Используя его мы можем сделать bzr commit –local, и так у нас будет история и версионность. Локально. И при появлении сервера можно вновь делать коммиты на него.
Привязка-отвязка от сервера. Можно сделать чекаут, отвязать его от сервера. Например, при поездке куда-то.
Наш репозитарий может служить репозитарием для других. Так, можно иметь рабочий репозитарий для проектов, и репозитарий для активной разработки. После того как development-версия оттестирована можно делать коммит в рабочий репозитарий. Такое дополнительное звено для проверки работоспособности.

Собственно, существуют и другие подобные системы – git, mercurial. Но bzr считается самым дружественным. Далее на примере это можно будет увидеть

Итак, создание репозитария происходит командой bzr init-repository.

New branches created under the repository directory will store their revisions in the repository, not in the branch directory.

mkdir railsproject && cd railsproject

Создание проекта в нем – bzr init

Use this to create an empty branch, or before importing an existing project.
If there is a repository in a parent directory of the location, then the history of the branch will be stored in the repository.
Otherwise init creates a standalone branch which carries its own history in the .bzr directory.

Теперь на локальной машинке давайте создадим проект на rails:

rails railsproject

и сделаем чекаут:

bzr checkout bzr+ssh://my.server/home/user/bzr/railsproject/ .

Отлично. Теперь у нас есть папка .bzr в корне проекта. Прежде чем делать добавления в проект давайте пропишем маски для исключений. Это делается легко и просто =)

bzr ignore "log/*.log"
bzr ignore "tmp/*"

Мне кажется, это приятней и понятней чем в svn. Кроме того, в корне проекта появился файлик .bzrignore, в который можно дописывать маски.
Если в маске встречается символ “/” то путь определяется от корня проекта. Например, вложенная где-нибудь папка log будет добавлена в репозитарий со всем содержимым. Для такого случая есть префикс “/**/logs/*.log”.
Отлично, теперь в корне проекта сделаем

bzr add
bzr commit -m "initial import"

и наши файлы ушли в репозитарий. Все, можно работать.
Чтобы не делать много мелких несущественных коммитов можно делать их локально – “bzr commit –local”.
Более подробный мануал по bzr иожно найти на оффсайте.

Rails and multilingual site

dm — Mon, 14 Jan 2008 07:57:56 +0000

Надо сделать сайт с поддержкой многоязычности. И вот к чему я пришел.

Во-первых, структура публикаций выходит одинаковая (новости, статьи…).
То есть для использования прекрасно подходит SingleTableInheritance. При таком подходе все поля очень близких по структуре классов сводятся в одну таблицу в БД.
Также надо добавить поле “type” – тип публикации. Он будет содержать имя класса, на самом деле.

Далее, надо что-то сделать с языком. Вариант №1 – сделать композитный первичный ключ, который будет состоять из id + language. Но мне больше нравится вариант с разделением локализуемой части и нелокализуемой:

И далее по ссылкам:
compositekeys gem и ее практическое использование в rails

Также для Content задействовал Scope-out.

Чтобы модель “знала” какой язык сейчас запрошен:

## config/environment.rb
...
$language = 'ru'
...

## config/initializers/activerecord_localized.rb
class ActiveRecord::Base
def self.set_language(lang)
@@language = lang
end
end
## app/controllers/application.rb
class ApplicationController < ActionController::Base
...
before_filter :set_model_language
private
def set_model_language
@@language = params[:lang] || $language
ActiveRecord::Base.set_language @@language
end
end

## app/models/news.rb
class Content < ActiveRecord::Base
scope_out :localized, :conditions => ['language=?', defined?(@@language) ? @@language : $language]
...
end

Задумался, как бы получше сделать локализацию Views. Пока думаю о написании helper’а, который будет подставлять из конфига стоки вместо констант – как упрощенный вариант ActiveCulture.

Кто чего подскажет?

lighttpd and rails

dm — Sat, 05 Jan 2008 02:33:27 +0000

Сделал небольшую пачку оберток на сервере для управления приложениями.

Для начала воспользовался кластером mongrel:

gem install mongrel_cluster

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

adduser --system --no-create-home --shell /bin/false --group mongrel

Правда, мне понадобилось сделать vipw и vigr, чтобы подправить ID пользователя и группы – чтоб они совпадали.

Теперь, в папке с приложением сделал

mongrel_rails cluster::configure -e production -p 3000 -N 5 -c ./ -a 127.0.0.1 --user mongrel --group mongrel

и получил в результате в config/mongrel_cluster.yml конфиг для кластера монгрелей. Вот такого вида:

---
user: mongrel
cwd: /var/www/lighttpd/www.example.com
log_file: log/mongrel.log
port: "8000"
environment: production
group: mongrel
address: 127.0.0.1
pid_file: tmp/pids/mongrel.pid
servers: 5

Запускается оно через mongrel_rails cluster::start.
Но надо же что-то сделать, чтоб оно загружалось при старте системы. И вот что я нашел и сделал.

mkdir /etc/mongrel_cluster/
mkdir /etc/mongrel_cluster/available
mkdir /etc/mongrel_cluster/enabled
mv /var/www/lighttpd/www.example.com/config/mongrel_cluster.yml /etc/mongrel_cluster/available/www.example.com.yml
ln -s /etc/mongrel_cluster/available/www.example.com.yml /etc/mongrel_cluster/enabled/www.example.com.yml

Теперь создадим скрипт /etc/init.d/mongrel_cluster:

#!/bin/bash

set -e

mongrel_cluster_ctl -v -c /etc/mongrel_cluster/enabled $@

и выполняем

chmod +x /etc/init.d/mongrel_cluster
update-rc.d -f mongrel_cluster defaults

Также для удобства запуска-остановки отдельного приложения я сделал мелкий скрипт /etc/mongrel_cluster/operation.sh:

#!/bin/bash

set -e

CONFIGS=/etc/mongrel_cluster/enabled

mongrel_rails cluster::$1 -C $CONFIGS/$2.yml

Поьзоваться им можно так: /etc/mongrel_cluster/operation.sh start www.example.com
Собственно, на этом с монгрелем все.
Далее – lighttpd. Почему не nginx? Я не нашел никаких доводов за или против. В конце-концов, оба они работают как reverse-proxy к монгрелю, и несложно сменить демон – никаких переработок приложения не потребуется.

Итак, вот конфиг lighttpd:

server.modules = ( "mod_access", "mod_accesslog", "mod_compress", "mod_rewrite", "mod_proxy", "mod_redirect" )
server.document-root = "/var/www/lighttpd/default/"
server.errorlog = "/var/log/lighttpd/error.log"
server.port = 80
server.bind = "77.120.99.179"
server.pid-file = "/var/run/lighttpd.pid"
server.username = "www-data"
server.groupname = "www-data"
server.tag = "lighttpd"

index-file.names = ( "index.php", "index.html", "index.htm" )
url.access-deny = ( "~", ".inc" )
static-file.exclude-extensions = ( ".php", ".pl", ".fcgi" )

accesslog.filename = "/var/log/lighttpd/access.log"

compress.cache-dir = "/var/cache/lighttpd/compress/"
compress.filetype = ("text/plain", "text/html", "application/x-javascript", "text/css", "text/xml" )

include_shell "/usr/share/lighttpd/create-mime.assign.pl"
include_shell "/usr/share/lighttpd/include-conf-enabled.pl"

var.basedir = "/var/www/lighttpd/"

#### SITES ####
$HTTP["host"] == "example.com" {
url.redirect = ("^/(.*)$" => "http://www.example.com/$1")
}
$HTTP["host"] == "www.example.com" {
server.name = "www.example.com"
server.document-root = basedir + server.name + "/public"
accesslog.filename = basedir + server.name + "/log/access.log"

$HTTP["url"] !~ "^/(stylesheets|javascripts|images|files)/" {
proxy.balance = "fair"
proxy.server = (
"/" => (
( "host" => "127.0.0.1", "port" => 8000 ),
( "host" => "127.0.0.1", "port" => 8001 ),
( "host" => "127.0.0.1", "port" => 8002 ),
( "host" => "127.0.0.1", "port" => 8003 ),
( "host" => "127.0.0.1", "port" => 8004 )
)
)
}
}

Я обеспечил прямой доступ к статике посредством lighttpd, не заворачивая статику через mongrel (везде я встречал заворачивание всего на монгрели, что, ИМХО, не есть хорошо).
Весьма настоятельно рекомендую в приложении создать файлик log/access.log и обеспечить в него запись пользователю www-data, от которого работает lighttpd.

Собственно, все. Ругайте.

UPD: в процессе работы проявились особенности Safari & IE. Для них надо в конфиге lighttpd добавить

$HTTP["useragent"] =~ "^(.*MSIE.*)|(.*AppleWebKit.*)$" {
server.max-keep-alive-requests = 0
}

ruby directory listing

dm — Fri, 28 Dec 2007 22:27:54 +0000

Делая первые шаги в руби и рельсах наткнулся на необходимость получить листинг папки без “.” и “..”. Вот так реализовалось:

class Dir
def self.listing(path, &block)
return nil if path.nil?
entries = Dir.entries(path).reject! { |filename| filename=='.' or filename=='..'}
entries.each(&block) if block_given?
entries
end
end

Огромаднейшее спасибо kpumuk‘у за подсказки и помощь нюбу =)

rails got the power

dm — Wed, 19 Dec 2007 12:38:24 +0000

Работаю сейчас над проектом. И вот для публикации надо сделать

кол-во просмотров
теги
рейтинги
комментарии

Начал писать на рельсах. И обнаружил

Только кол-во просмотров надо писать самому. Сильно впечатлился.

Rails 2 released

dm — Fri, 07 Dec 2007 19:10:24 +0000

Приятно видеть, что вышел Rails 2.0.1 (это потому что был найден небольшой баг сразу после выпуска 2.0.0).

Список изменений и улучшений. В общем и целом – фреймворк стал легче, многое из него убрали в плагины.

NetBeans 6.0 released

dm — Mon, 03 Dec 2007 21:26:22 +0000

Наконец-то вышел NetBeans 6.0 – замечательная Java IDE. Для меня она ценна изумительной поддержкой Ruby, а также наличием в плагинах средств для работы с UML, PHP, C/C++.