Ruby-Gettext-Package

Ruby-GetText-Package is a Localization(L10n) library and tool

which is modeled after the GNU gettext package.

This library translates original messages to localized

messages using client-side locale information(environment

variable or CGI variable).

The tools for developers support creating, useing, and modifying

localized message files(message catalogs).

((Rails)) Rails support has been removed.

Rails / ActiveRecord specific code now lives in gettext_rails and gettext_activerecord.

Website

Features

  • Simple APIs(similar to GNU gettext)

  • rgettext creates po-files from

    • ruby scripts

    • glade-2 XML file(.glade)

    • ERB file(.rhtml, .erb)

    • Anything (with your own parsers)

    • The po-files are compatible to GNU gettext.

  • rmsgfmt creates a mo-file from a po-file. The mo-file is compatible to GNU gettext(msgfmt).

  • textdomain’s scope is adapt to ruby class/module mechanism.

    • A class/module can have plural textdomains.

    • a message is looked up in its class/module and ancestors.

  • CGI support (gettext/cgi)

    • Locale is retrieved from client informations (HTTP_ACCEPT_LANGUAGE, HTTP_ACCEPT_CHARSET, QUERY_STRING(lang), Cookies(lang)).

  • String%() is extended to use named argument such as %{foo}" %{:foo => 1}. Notes that Ruby-1.9.x supports this format by itself.

Requirements

Install

  • gem

    #from github (edge/unstable)
    sudo gem install mutoh-gettext -s http://gems.github.com/
    
    #from rubyforge (stable)
    sudo gem install gettext
    
  • download tar-ball

    # De-Compress archive and enter its top directory.
    sudo ruby setup.rb
    

You can also install files in your favorite directory by

supplying setup.rb some options. Try ruby setup.rb --help.

Usage

Have a look at the examples folder.

License

This program is licenced under the same licence as Ruby.

(See the file ‘COPYING’.)

  • mo.rb

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

    • Copyright © 2001,2002 Masahiro Sakai <s01397ms at sfc.keio.ac.jp>

  • gettext.rb

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

    • Copyright © 2001,2002 Masahiro Sakai <s01397ms at sfc.keio.ac.jp>

  • rgettext

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

    • Copyright © 2001,2002 Yasushi Shoji <yashi at atmark-techno.com>

  • setup.rb

    • Copyright © 2000-2005 Minero Aoki <aamine at loveruby.net>

    • This file is released under LGPL. See the top of the install.rb.

  • Others

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

    • 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 <mutoh at highway.ne.jp>

  • 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>

  • Swedish(sv) - Nikolai Weibull <mailing-lists.ruby-talk at rawuncut.elitemail.org>

  • 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.0pre1 (new)

  • Catalan(ca) - 2.0.0pre1

  • Croatian(hr) - 1.90.0 (old)

  • Chinese(zh_CN) - 2.0.0pre1

  • Chinese(zh_TW) - 2.0.0pre1

  • Czech(cs) - 1.9.0 (old)

  • Dutch(nl) - 1.90.0 (old)

  • English(default) - 1.90.0 (old)

  • Esperanto(eo) - 2.0.0pre1

  • Estonian(et) - 2.0.0pre1

  • French(fr) - 2.0.0pre1

  • German(de) - 2.0.0pre1

  • Greek(el) - 2.0.0pre1

  • Hungarian(hu) - 2.0.0pre1

  • Italian(it) - 1.6.0 (old)

  • Japanese(ja) - 2.0.0pre1

  • Korean(ko) - 1.9.0 (old)

  • Latvian(lv) - 2.0.0pre1 (new)

  • Norwegian(nb) - 2.0.0pre1

  • Portuguese(Brazil)(pt_BR) - 2.0.0pre1

  • Russian(ru) - 2.0.0pre1

  • Serbian(sr) - 1.91.0 (old)

  • Spanish(es) - 2.0.0pre1

  • Swedish(sv) - 0.8.0 (too much old)

  • Ukrainian(ua) - 2.0.0pre1

  • Vietnamese(vi) - 2.0.0pre1

Maintainer

Masao Mutoh <mutoh at highway.ne.jp>