= 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
* http://www.yotabanana.com/hiki/ruby-locale.html
* http://locale.rubyforge.org/
== Requirements
* Ruby-1.8.7 or later
* JRuby-1.1.4 or later
== Install
* gem:
($ su)
# gem install locale
* tar-ball:
Download tar-ball from http://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
* setup.rb version 3.4.1
* Copyright (C) 2000-2005 Minero Aoki
* 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
== References
=== Other libraries
* langtag-0.1.0
by Martin Dürst
* memoizable.rb
from ActiveSupport-2.2.0
* Ruby-GetText-Package-1.92.0
by Masao Mutoh
=== Documents
* The Open Group Base Specifications Issue 6 IEEE Std 1003.1, 2004 Edition
Internationalization Variables
* GNU `gettext' utilities - Setting the Locale through Environment Variables
* BCP47 / RFC4646, RFC3066 - Tags for Identifying Languages (Keep RFC3066 compatibility)
* Unicode Locale Data Markup Language (LDML) 1.6.1
Unicode Language and Locale Identifiers
* JDK 6 Documentation - Java Supported Locales
* Microsoft Developer Network - Locales and Languages
* ISO 639
* ISO 3166
== Maintainer
Masao Mutoh