File: README

Ruby-Locale

Ruby-Locale is the pure ruby library which provides basic and general purpose APIs for localization.

  • Manage Locale ID(Language Tag)
    • Each thread has a Locale ID.
    • POSIX, CLDR, IETF(RFC4646, 3066(BCP47)), Win32 and Java language tags and convert the tag string to each other.
    • Auto detect Locale ID. POSIX(Unix/Linux/*BSD), Win32, JRuby, CGI.
  • Resources
    • ISO 639-3 languages
    • ISO 3166 region(countries).
  • Support Ruby 1.8.7, Ruby 1.9.1, JRuby 1.1.4. Tested on Win32 and Linux.

Website

Requirements

Install

  • gem: ($ su)
     # gem install locale
    
  • tar-ball: Download tar-ball from rubyforge.org/projects/locale/ De-Compress archive and enter its top directory. Then type: ($ su) # ruby setup.rb

The simplest usage

 require 'rubygems'
 require 'locale'

 p Locale.current

License

This program is licenced under the same licence as Ruby. (See the file ‘COPYING’.)

  • locale/language.rb, locale/region.rb, locale/data/language.tab.gz, locale/data/region.tab.gz:
    • Copyright (C) 2006 Antonio Terceiro
    • Copyright (C) 2008 Masao Mutoh <mutoh at highway.ne.jp>
  • setup.rb version 3.4.1
    • Copyright (C) 2000-2005 Minero Aoki <aamine at loveruby.net>
    • This file is released under LGPL. See the top of the setup.rb.
  • Others(Some files are separated from Ruby-GetText-Package-1.92.0)
    • Copyright (C) 2008 Masao Mutoh <mutoh at highwhay.ne.jp>

References

Other libraries

  • langtag-0.1.0
      by Martin Dürst <http://rubyforge.org/projects/langtag/>
    
  • memoizable.rb
      from ActiveSupport-2.2.0 <http://rubyforge.org/projects/activesupport/>
    
  • Ruby-GetText-Package-1.92.0
      by Masao Mutoh <http://www.yotabanana.com/hiki/ruby-gettext.html>
    

Documents

Maintainer

Masao Mutoh <mutoh at highway.ne.jp>