gettext_rails¶ ↑

gettext_rails provides the localization for Ruby on Rails-2.3 or later using Ruby-GetText-Package.

• Autodetect client locale using locale/locale_rails.

• Easy maintainance of translations to use powerful tools for gettext family.

• Model translation using gettext_activerecord.

• Localization for some helpers.

• Works with other Rails I18n backend.

  • Note that gettext_rails is not the one of I18n backend.

• Thread safe.

Website¶ ↑

• homepage

• on rubyforge

• on github

Requirements¶ ↑

• Ruby 1.8.3 or later

• Rubygems

• locale gem

• locale_rails gem

• gettext gem

• gettext_activerecord gem

• gettext_rails gem

Install¶ ↑

#Uninstall old gettext if exists.
(sudo/su on POSIX system)
gem uninstall gettext

#from github (edge/unstable)  (not supported yet)
(sudo/su on POSIX system)
#gem install mutoh-gettext_rails -s http://gems.github.com/

#from rubyforge (stable)
(sudo/su on POSIX system)
gem install gettext_rails

Usage¶ ↑

See sample direcotries for more details.

Rakefile¶ ↑

require 'rubygems'

desc "Create mo files"
task :makemo do
  require 'gettext_rails/tools'
  GetText.create_mofiles
end

task :updatepo do
  require 'gettext_rails/tools'
  # Need to access DB to find Model table/column names.
  # Use config/database.yml which is the same style with rails.
  GetText.update_pofiles("sample_rails", ["topic.rb"], "sample_rails 1.0.0")
end

config/environment.rb¶ ↑

Rails::Initializer.run do |config|
  :
  :
  config.gem "locale"
  config.gem "locale_rails"
  config.gem "gettext"
  config.gem "gettext_activerecord"
  config.gem "gettext_rails"
end

application_controller.rb ¶ ↑

class ApplicationController < ActionController::Base
  init_gettext "blog"  # replace "blog" to your textdomain name.
end

Then …¶ ↑

$ rake updatepo
$ cd po
$ mkdir ja
$ msginit -l ja_JP.UTF-8 -i blog.pot -o ja/sample.po
$ Edit ja/sample.po
$ cd ../../
$ rake makemo
$ ruby sample.rb

See Ruby-GetText-Package HOWTO for Ruby on Rails for more details.

Support matrix¶ ↑

• gettext_rails-2.2.0 - rails-2.3.2,2.3.3,2.3.4,2.3.5

• gettext_rails-2.1.0 - rails-2.3.2,2.3.3,2.3.4

• gettext_rails-2.0.2 - rails-2.3.2

• gettext_rails-2.0.1 - rails-2.3.2

• gettext_rails-2.0.0 - rails-2.3.2

License¶ ↑

This program is licenced under the same licence as Ruby(See COPYING) or LGPL(Lesser General Public License: www.gnu.org/licenses/lgpl-3.0.txt).

• Copyright © 2001-2009 Masao Mutoh <mutoh at highwhay.ne.jp>

Translators¶ ↑

• Bosnian(bs) - Sanjin Sehic <saserr at gmail.com>

• Bulgarian(bg) - Sava Chankov <sava.chankov at gmail.com>

• Catalan(ca) - Ramon Salvadó <rsalvado at gnuine.com>

• Chinese(Simplified)(zh_CN)

  • Yang Bob <bob.yang.dev at gmail.com> (current)

  • Yingfeng <blogyingfeng at gmail.com>

• Chinese(Traditional)(zh_TW)

  • Yang Bob <bob.yang.dev at gmail.com> (current)

  • LIN CHUNG-YI <xmarsh at gmail.com>

• Croatian(hr) - Sanjin Sehic <saserr at gmail.com>

• Czech(cs) - Karel Miarka <kajism at yahoo.com>

• Dutch(nl) - Bart ten Brinke<info at retrosync.com> (current)

  Menno Jonkers <ruby-gettext at jonkers.com>

• Esperanto(eo) - Malte Milatz <malte at gmx-topmail.de>

• Estonian(et) - Erkki Eilonen <erkki at itech.ee>

• French(fr)

  • Vincent Isambart <vincent.isambart at gmail.com> (current)

  • David Sulc <davidsulc at gmail.com>

  • David Sulc <davidsulc at gmail.com>

  • Laurent Sansonetti <laurent.sansonetti at gmail.com>

• German(de)

  • Patrick Lenz <patrick at limited-overload.de> (current)

  • Detlef Reichl <detlef.reichl at gmx.org>

  • Sven Herzberg <herzi at abi02.de>

  • Sascha Ebach <se at digitale-wertschoepfung.de>

• Greek(el) - Vassilis Rizopoulos <damphyr at gmx.net>

• Hungarian(hu) - Tamás Tompa <tompata at gmail.com>

• Italian(it)

  • Marco Lazzeri <marco.lazzeri at gmail.com>

  • Gabriele Renzi <surrender_it at yahoo.it>

• Japanese(ja) - Masao Mutoh <mutomasa at gmail.com>

• Korean(ko) - Gyoung-Yoon Noh <nohmad at gmail.com>

• Latvian(lv) - Aivars Akots <aivars.akots at gmail.com>

• Norwegian(nb) - Runar Ingebrigtsen <runar at mopo.no>

• Portuguese(Brazil)(pt_BR)

  • Antonio S. de A. Terceiro <terceiro at softwarelivre.org> (current)

  • Joao Pedrosa <joaopedrosa at gmail.com>

• Russian(ru) - Yuri Kozlov <kozlov.y at gmail.com>

• Serbian(sr) - Slobodan Paunović“ <slobodan.paunovic at gmail.com>

• Spanish(es)

  • David Espada <davinci at escomposlinux.org> (current)

  • David Moreno Garza <damog at damog.net>

• Ukrainian(uk) - Alex Rootoff <rootoff at pisem.net>

• Vietnamese(vi) - Ngoc Dao Thanh <ngocdaothanh at gmail.com>

Status of translations¶ ↑

• Bosnian(bs) - 1.90.0 (old)

• Bulgarian(bg) - 2.0.0

• Catalan(ca) - 2.0.0

• Croatian(hr) - 1.90.0 (old)

• Chinese(zh_CN) - 2.0.0

• Chinese(zh_TW) - 2.0.0

• Czech(cs) - 1.9.0 (old)

• Dutch(nl) - 2.0.2

• English(default) - 1.90.0 (old)

• Esperanto(eo) - 2.0.0

• Estonian(et) - 2.0.0

• French(fr) - 2.0.0

• German(de) - 2.0.0

• Greek(el) - 2.0.0

• Hungarian(hu) - 2.0.0

• Italian(it) - 1.6.0 (old)

• Japanese(ja) - 2.1.0

• Korean(ko) - 1.9.0 (old)

• Latvian(lv) - 2.0.0

• Norwegian(nb) - 2.0.0

• Portuguese(Brazil)(pt_BR) - 2.0.0

• Russian(ru) - 2.0.0

• Serbian(sr) - 1.91.0 (old)

• Spanish(es) - 2.0.0

• Ukrainian(uk) - 2.0.0

• Vietnamese(vi) - 2.0.0

Maintainer¶ ↑

Masao Mutoh <mutomasa at gmail.com>