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

Requirements

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.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).

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(ua) - 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(ua) - 2.0.0
Vietnamese(vi) - 2.0.0

Maintainer

Masao Mutoh <mutomasa at gmail.com>