= Ruby-Gettext-Package

Ruby-GetText-Package is a Localization(L10n) library and tools 
which modeled after GNU gettext package.

This library provides to translate original messages to localized 
messages properly using client-side locale information(environment
variable or CGI variable).

And the tools for developers support to create, use, and modify 
localized message files(message catalogs) easily.

== Features
* Simple APIs(similar GNU gettext)

* rgettext creates po-files from 
  * ruby scripts 
  * glade-2 XML file(.glade)
  * ERB file(.rhtml, .erb)
  * ActiveRecord(.rb)
  * Others(with your own parsers)
  * The po-file is 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.

* Locale is retrieved from System variables (ENV['LANG'], POSIX, Win32)

* CGI support (gettext/cgi)
  * Locale is retrieved from client informations
    (HTTP_ACCEPT_LANGUAGE, HTTP_ACCEPT_CHARSET, QUERY_STRING(lang), Cookies(lang)).

* ERB support (gettext/erb)

* Ruby on Rails support (gettext/rails)
  * before_init_gettext, init_gettext, after_init_gettext for initializing
    GetText.
  * ActionController, ActionView, ActionMailer and ActiveRecord are 
    localized in a textdomain.
  * Validation messages in ActiveRecord are localized.
  * The table/field names of ActiveRecord are extracted by rgettext 
    and translated in the application.
  * plugins can have their own textdomains.
  * ActionMailer supports ISO-2022-JP message in ja locale.

* String%() is extended to use named argument such as "%{foo}" %{:foo => 1}

== Requirements
* Ruby 1.8.3 or later <http://www.ruby-lang.org/ja/>
* (for development only)
  * GNU gettext 0.10.35 or later 
    <http://www.gnu.org/software/gettext/gettext.html>
  * Racc-1.4.3 or later
    <http://www.ruby-lang.org/raa/list.rhtml?name=racc>
* (for compiling src/rmsgfmt.ry only)
  * Ruby on Rails 1.1.2 or later (if you use this package with Ruby on Rails)
    <http://www.rubyonrails.org/>

== Install
* gem:
    ($ su)
     # gem install gettext

* tar-ball:
    De-Compress archive and enter its top directory.
    Then type:
    ($ su)
     # ruby setup.rb

You can also install files in your favor directory by
supplying setup.rb some options. Try "ruby setup.rb --help".

== Usage
If you are end-user of an application which depends on this library, 
you don't need do nothing (See applications documents).

If you are developer of the application which depends on this library,

see: http://gettext.rubyforge.org/

== License
This program is licenced under the same licence as Ruby.
(See the file 'COPYING'.)

* mo.rb
  * Copyright (C) 2001-2007 Masao Mutoh <mutoh at highwhay.ne.jp>
  * Copyright (C) 2001,2002 Masahiro Sakai <s01397ms at sfc.keio.ac.jp>

* gettext.rb
  * Copyright (C) 2001-2008 Masao Mutoh <mutoh at highwhay.ne.jp>
  * Copyright (C) 2001,2002 Masahiro Sakai <s01397ms at sfc.keio.ac.jp>

* rgettext 
  * Copyright (C) 2001-2007 Masao Mutoh <mutoh at highwhay.ne.jp>
  * Copyright (C) 2001,2002 Yasushi Shoji <yashi at atmark-techno.com>

* setup.rb
  * Copyright (C) 2000-2005 Minero Aoki <aamine at loveruby.net>
  * This file is released under LGPL. See the top of the install.rb.

* Others
  * Copyright (C) 2001-2008 Masao Mutoh <mutoh at highwhay.ne.jp>


== Translators
* Bosnian(bs)                - Sanjin Sehic <saserr 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)                 - David Sulc <davidsulc at gmail.com> (current)
                               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>
* Norwegian(nb)              - Runar Ingebrigtsen <runar at mopo.no>
* Portuguese(Brazil)(pt_BR)  - Antonio S. de A. Terceiro <terceiro at softwarelivre.org>
                               Joao Pedrosa <joaopedrosa at gmail.com> (current)
* 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 <ngocdaothanh at gmail.com>

== Status of translations
* Bosnian(bs)               - 1.90.0 
* Catalan(ca)               - 1.90.0
* Croatian(hr)              - 1.90.0 
* Chinese(zh_CN)            - 1.90.0
* Chinese(zh_TW)            - 1.90.0
* Czech(cs)                 - 1.9.0 (old)
* Dutch(nl)                 - 1.90.0
* English(default)          - 1.90.0
* Esperanto(eo)             - 1.90.0
* Estonian(et)              - 1.9.0 (old, rails.po only)
* French(fr)                - 1.90.0
* German(de)                - 1.90.0
* Greek(el)                 - 1.9.0 (old)
* Hungarian(hu)             - 1.90.0
* Italian(it)               - 1.6.0 (old)
* Japanese(ja)              - 1.91.0
* Korean(ko)                - 1.9.0 (old)
* Norwegian(nb)             - 1.9.0 (old)
* Portuguese(Brazil)(pt_BR) - 1.90.0
* Russian(ru)               - 1.90.0
* Serbian(sr)               - 1.91.0 (new)
* Spanish(es)               - 1.9.0 (old)
* Swedish(sv)               - 0.8.0 (too much old)
* Ukrainian(ua)             - 1.90.0
* Vietnamese(vi)            - 1.90.0

== Maintainer
Masao Mutoh <mutoh at highway.ne.jp>