Ruby-GetText-Package は GNU gettextによく似たライブラリです。このライブラリを使うことであなたのRubyスクリプト中の文字列を簡単にローカライズでき、国際化されたアプリケーションを作ることができます。 基本的な考え方はGNU gettextと同じです。インターネット上に解説されたものが多々ありますのでそちらをご覧になってください(← 手抜き)。

• 開発者向けのドキュメント
  • 開発手順
  • CGI開発
  • Ruby on Railsで使う
  • poファイルにメッセージを抽出するためのパーサを独自に追加する(2.1.0以降)
  • poファイルにメッセージを抽出するためのパーサを独自に追加する(old)
  • po/moファイルのメンテナンス方法(英語)
  • APIリファレンス(RDoc版)
  • Ruby-GetText-Packageが提供するツールについて
• 翻訳者向けドキュメント（英語）
• FAQ（英語）
• スクリーンショット
• 動画 by Ozawa Sakuro
• Rubyforge - ダウンロード、バグレポートなど

• Ruby 1.8.4以降<URL:http://www.ruby-lang.org/ja/>
• JRuby 1.1 RC 1以降<URL:http://jruby.codehaus.org/>

以下オプション

Iconv(Rubyのiconvモジュールおよびiconv本体)

Ruby 1.7.x以降ではRuby本体に標準添付されますが、MS Win32版のOne click ruby installerには含まれないものがありました（最近は含まれているみたいです）。その場合、Ruby-GNOME2のMS Win32バイナリパッケージをインストールすれば代替機能としてIconvがインストールされている場合と同等の機能を提供することが出来ます。なお、poファイル、外部からの入力・出力がともにUTF-8であれば不要です。

• <URL:http://www.ruby-lang.org/raa/list.rhtml?name=iconv>

GNU gettext 0.10.35以降

実行時は不要です。開発時も必須ではありませんが、msgmergeなどの開発補助ツールはとても便利ですし、一部Ruby-GetText-PackageからもGNU gettextが提供するツールを呼び出しているものもありますので、開発環境にはインストールしておくことをお奨めします。

• <URL:http://www.gnu.org/software/gettext/gettext.html>

なお、MS Windowsの場合は、Ruby-GNOME2のRuby-GNOME2 Win32 GUI Installerを使ってください。

Racc-1.4.3

src/ディレクトリのファイルをコンパイルするのに使いますが、配布物にはコンパイル済みのファイルが含まれるため不要です。

• <URL:http://www.ruby-lang.org/raa/list.rhtml?name=racc>

Cコンパイラ(GCC/cl) (1.10.0まで)

ソースコードからインストールする場合は必要です。

以下のサイトからダウンロードしてください：<URL:http://rubyforge.org/frs/?group_id=855>

ruby-gettext-package-x.x.x.tar.gz

オリジナルのソースコードのパッケージです。mswin32以外の方は(Cygwinも)こちらを使ってください。

gettext-x.x.x.gem

General Gem package. Used for *nix system (requires gcc(C compiler)).

gettext-x.x.x-mswin32.gem

mswin32(One-Click Ruby Installer for Win32)向けのgemパッケージです。

*nix

コマンドラインで以下のようにうちこんでください。おそらくroot権限が必要になります。

(# su)
 # ruby setup.rb

インストール先を変更したりすることもできます。その場合は ruby setup.rb --help を実行してみてください。

*nix gemパッケージ（または、1.90.0以降共通）

MS Win32以外でgemパッケージを使う場合は以下のようにします。

# gem install gettext
Attempting local installation of 'gettext'
Local gem file not found: gettext*.gem
Attempting remote installation of 'gettext'
Updating Gem source index for: http://gems.rubyforge.org
Select which gem to install for your platform (i386-mswin32)
 1. gettext x.x.x (ruby)
 2. gettext x.x.x (mswin32)
 3. Cancel installation
> 1
Successfully installed gettext-x.x.x

MS Windows (One-Click Ruby Installer For Windows) with rubygems.（1.10.0まで）

1.10.0までは、MS Win32は別パッケージでした。古いバージョンを使う場合は、以下のようにします。最新バージョンでは"ruby"を選択してください。

C:\>gem install gettext
Attempting local installation of 'gettext'
Local gem file not found: gettext*.gem
Attempting remote installation of 'gettext'
Updating Gem source index for: http://gems.rubyforge.org
Select which gem to install for your platform (i386-mswin32)
 1. gettext x.x.x (ruby)
 2. gettext x.x.x (mswin32)
 3. Cancel installation
> 2
Successfully installed gettext-x.x.x-mswin32

本ライブラリを用いて開発したツールを使用する場合は、事前に以下の情報を設定する必要があります。

LC_ALL, LC_MESSAGES, LANG

ロケールを指定します。日本語の場合、ja_JP.eucJP, ja_JP.UTF-8, ja_JP.SJIS, ja_JP等です。*NIX系の場合は通常設定されているでしょう。

MS Windowsの場合は指定されていない場合はシステムのロケールが使用されます。

OUTPUT_CHARSET

出力する文字コードを指定します。UTF-8, euc-jp, Shift_JIS等。ほとんど全ての環境で設定不要なはずです。文字化けが発生する場合に、このオプションを指定すると文字化けが直る場合があります。

このライブラリはRubyと同じライセンスに基づいて配布されるフリーソフトウェアです。詳しくはCOPYING.jaを参照してください。

Copyright (C) 2001-2005 Masao Mutoh <mutoh at highwhay.ne.jp>

本ライブラリについてのご意見・バグレポートはむとうまで。

Masao Mutoh <mutomasa at gmail.com>

• 2010-01-02 「poファイルにメッセージを抽出するためのパーサを独自に追加する」をアップデートした - Masao
• 2006-05-11 オプションの部分を書き直した。 - Masao
• 2006-01-31 オプションの部分を書き直した。 - Masao
• 2005-12-29 Updated for 1.1.0 - Masao