grosser-gettext

= 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

• homepage[http://www.yotabanana.com/hiki/ruby-gettext.html]
• on rubyforge[http://gettext/rubyforge.org/]
• on github[http://github.com/gettext/]

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

• {Ruby 1.8.3 or later}[http://www.ruby-lang.org]
• {Rubygems}[http://www.rubygems.org/]
• locale gem
• (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)

== 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 (C) 2001-2009 Masao Mutoh
  • Copyright (C) 2001,2002 Masahiro Sakai

• gettext.rb

  • Copyright (C) 2001-2009 Masao Mutoh
  • Copyright (C) 2001,2002 Masahiro Sakai

• rgettext

  • Copyright (C) 2001-2009 Masao Mutoh
  • Copyright (C) 2001,2002 Yasushi Shoji

• setup.rb

  • Copyright (C) 2000-2005 Minero Aoki
  • This file is released under LGPL. See the top of the install.rb.

• Others

  • Copyright (C) 2001-2009 Masao Mutoh

== Translators

• Bosnian(bs) - Sanjin Sehic
• Bulgarian(bg) - Sava Chankov <sava.chankov at gmail.com>
• Catalan(ca) - Ramon Salvadó
• Chinese(Simplified)(zh_CN)
  • Yang Bob <bob.yang.dev at gmail.com> (current)
  • Yingfeng
• Chinese(Traditional)(zh_TW)
  • Yang Bob <bob.yang.dev at gmail.com> (current)
  • LIN CHUNG-YI
• Croatian(hr) - Sanjin Sehic
• Czech(cs) - Karel Miarka
• Dutch(nl) - Menno Jonkers
• Esperanto(eo) - Malte Milatz
• Estonian(et) - Erkki Eilonen
• French(fr)
  • Vincent Isambart <vincent.isambart at gmail.com> (current)
  • David Sulc
  • Laurent Sansonetti <laurent.sansonetti at gmail.com>
• German(de)
  • Patrick Lenz (current)
  • Detlef Reichl <detlef.reichl at gmx.org>
  • Sven Herzberg
  • Sascha Ebach
• Greek(el) - Vassilis Rizopoulos
• Hungarian(hu) - Tamás Tompa
• Italian(it)
  • Marco Lazzeri <marco.lazzeri at gmail.com>
  • Gabriele Renzi <surrender_it at yahoo.it>
• Japanese(ja) - Masao Mutoh
• Korean(ko) - Gyoung-Yoon Noh
• Latvian(lv) - Aivars Akots <aivars.akots at gmail.com>
• Norwegian(nb) - Runar Ingebrigtsen
• Portuguese(Brazil)(pt_BR)
  • Antonio S. de A. Terceiro (current)
  • Joao Pedrosa
• Russian(ru) - Yuri Kozlov <kozlov.y at gmail.com>
• Serbian(sr) - Slobodan Paunović" <slobodan.paunovic at gmail.com>
• Spanish(es)
  • David Espada (current)
  • David Moreno Garza
• Swedish(sv) - Nikolai Weibull <mailing-lists.ruby-talk at rawuncut.elitemail.org>
• Ukrainian(ua) - Alex Rootoff
• Vietnamese(vi) - Ngoc Dao Thanh

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