File: README — Documentation for gettext (1.5.0)

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

* 2 kind of textdomain's scope
  * A file base (default: recommanded)
  * A Class/Module base 
    (GetText::Container, GetText::ErbContainer, GetText::Rails)

* CGI support (gettext/cgi)

* 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.0.0 or later (if you use this package with Ruby on Rails)
  <http://www.rubyonrails.org/>

Install

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 © 2001-2004 Masao Mutoh <[email protected]> Copyright © 2001,2002 Masahiro Sakai <[email protected]>
gettext.rb Copyright © 2001-2005 Masao Mutoh <[email protected]> Copyright © 2001,2002 Masahiro Sakai <[email protected]>
rgettext Copyright © 2001-2005 Masao Mutoh <[email protected]> Copyright © 2001,2002 Yasushi Shoji <[email protected]>
setup.rb Copyright © 2000-2005 Minero Aoki <[email protected]> This file is released under LGPL. See the top of the install.rb.
Others Copyright © 2001-2006 Masao Mutoh <[email protected]>

Translators

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

Czech(cs) - 1.5.0 Dutch(nl) - 1.5.0 English(default) - 1.5.0 French(fr) - 1.5.0 German(de) - 1.5.0 Greek(el) - 1.5.0 Spanish(es) - 1.5.0 Italian(it) - 1.0.0 (old) Japanese(ja) - 1.5.0 Korean(ko) - 1.5.0 Portuguese(Brazil)(pt_BR) - 1.5.0 Russian(ru) - 1.5.0 Swedish(sv) - 0.8.0 (old)

Maintainer

Masao Mutoh <[email protected]>