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

• www.yotabanana.com/hiki/ruby-locale.html

• locale.rubyforge.org/

Requirements

• Ruby-1.8.7 or later <www.ruby-lang.org/ja/>

• JRuby-1.1.4 or later <jruby.codehaus.org/>

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 © 2006 Antonio Terceiro

  • Copyright © 2008 Masao Mutoh <mutoh at highway.ne.jp>

• setup.rb version 3.4.1

  • Copyright © 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 © 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

• The Open Group Base Specifications Issue 6 IEEE Std 1003.1, 2004 Edition Internationalization Variables <www.opengroup.org/onlinepubs/009695399/basedefs/xbd_chap08.html>

• GNU ‘gettext’ utilities - Setting the Locale through Environment Variables <www.gnu.org/software/gettext/manual/gettext.html#Setting-the-POSIX-Locale>

• BCP47 / RFC4646, RFC3066 - Tags for Identifying Languages (Keep RFC3066 compatibility) <www.ietf.org/rfc/rfc4646.txt> <www.ietf.org/rfc/rfc3066.txt>

• Unicode Locale Data Markup Language (LDML) 1.6.1 Unicode Language and Locale Identifiers <www.unicode.org/reports/tr35/tr35-11.html#Unicode_Language_and_Locale_Identifiers>

• JDK 6 Documentation - Java Supported Locales <java.sun.com/javase/6/docs/technotes/guides/intl/locale.doc.html>

• Microsoft Developer Network - Locales and Languages <msdn.microsoft.com/en-us/library/ms776264(VS.85).aspx>

• ISO 639

• ISO 3166

Maintainer

Masao Mutoh <mutoh at highway.ne.jp>