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)
    * ActiveRecord(.rb)
    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)


Requirements
------------

  * Ruby 1.8.3 or later <http://www.ruby-lang.org/ja/>

  (options)
  * GNU gettext 0.10.35 or later 
    <http://www.gnu.org/software/gettext/gettext.html>
    (for Development only)
  * 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-2006 Masao Mutoh <mutoh at highwhay.ne.jp>
  Copyright (C) 2001,2002 Masahiro Sakai <s01397ms at sfc.keio.ac.jp>

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

* rgettext 
  Copyright (C) 2001-2006 Masao Mutoh <mutoh at highwhay.ne.jp>
  Copyright (C) 2001,2002 Yasushi Shoji <yashi at yashi.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-2006 Masao Mutoh <mutoh at highwhay.ne.jp>


Translators
-----------
Chinese(Simplified)(zh_CN) - Yingfeng <blogyingfeng at gmail.com>
Czech(cs)                  - Karel Miarka <kajism at yahoo.com>
Dutch(nl)                  - Menno Jonkers <ruby-gettext at jonkers.com>
French(fr)                 - Laurent Sansonetti <laurent.sansonetti at gmail.com>
German(de)                 - Detlef Reichl <detlef.reichl at gmx.org>
                             Sven Herzberg <herzi at abi02.de>
                             Sascha Ebach <se at digitale-wertschoepfung.de>
Greek(el)                  - Damphyr <damphyr at gmx.net>
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>
Portuguese(Brazil)(pt_BR)  - Joao Pedrosa <joaopedrosa at gmail.com>
Russian(ru)                - Yuri Kozlov <kozlov.y 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>

Status of translations
----------------------
Chinese(zh)               - 1.7.0
Czech(cs)                 - 1.7.0
Dutch(nl)                 - 1.7.0
English(default)          - 1.7.0
French(fr)                - 1.7.0
German(de)                - 1.6.0
Greek(el)                 - 1.6.0
Spanish(es)               - 1.7.0
Italian(it)               - 1.6.0
Japanese(ja)              - 1.7.0
Korean(ko)                - 1.7.0
Portuguese(Brazil)(pt_BR) - 1.6.0
Russian(ru)               - 1.7.0
Swedish(sv)               - 0.8.0 (old)

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