在開發 ROR 應用程式的時候，不免會考慮到 i18n 或 l10n 的問題。翻查了網路上的許多解決方案，最基本的當然就是 ruby-gettext。但這個 gettext 很麻煩的就是得要利用 updatepo 編譯 po 字詞翻譯檔，對於一邊開發一邊增修網頁來說實在煩不甚煩。後來找到這個 I18n 模組， 作者小影 依照 th0fu 在 他的 blog mir.aculo.us 中發表的 L10n 模組 的做法，稍作修改以 YAML 檔案來定義翻譯檔。這個比較符合我的需求，於是很開心地依照說明嘗試在我的環境安裝測試，結果不明原因地失敗，正要放棄，突然湧起一股天無絕人之路的勇氣，試著解讀小影的 I18n 的開放源碼，發現其實也沒有這麼難理解。只是小影可能將 I18n 考慮得比較完整，反倒有些地方複雜了。

我的需求其實很簡單，按照 GetText 的標準語法，在字串前面加上底線 _()，就能夠依照網頁存取瀏覽器的 HTTP_ACCEPT_LANGUAGE 來顯示最喜愛的語系，譬如這樣：

_'Hell world'

習慣英文的讀者可以看到顯示 "Hell world"，而正體中文的讀者就能夠依照翻譯結果看到 "見鬼了這世界" 的語句。

於是花了兩天的咖啡店時光（已經連續兩個禮拜白天泡在咖啡店裡研究新程式語言），寫出了以下這個 MultiLingual 模組。很興奮地寄給 hoja 分享，他果然比我厲害，稍作研究後修正了一些地方，使得語法更精練，並且讓模組的調用更簡單，甚至不需要變動到 Object 基本物件的定義，就能夠讓 controller 物件增加 _() 這個 method。

因為這個 MultiLingual 內容不太長，我就直接先 post 出來，有需要的人還是建議下載完整的檔案，裡面我寫了安裝說明，請自行參考。 由此下載 download

require 'yaml'
module MultiLingual

  def _(string_to_localize, *args)
    @lingual ||= lingual_load('default')
    translated = 
      @lingual_map[string_to_localize] || string_to_localize
    return translated.call(*args).to_s if translated.is_a? Proc
    translated = 
      translated[args[0]>1 ? 1 : 0] if translated.is_a?(Array)
    sprintf translated, *args
  end
  def lingual_load(ln=nil)
    @lingual = ln.to_s.downcase
    path = File.join(RAILS_ROOT, 'config', 'lang')
    [File.join(path, "#{@lingual}.yml"), File.join(path, 'default.yml')].each do |file|
      if File.exist? file
        @lingual_map = YAML.load_file(file)
        break
      end
    end
  end
end
class LingualFilter
  def self.filter(controller)
    controller.lingual_load(controller.request.env['HTTP_ACCEPT_LANGUAGE'].to_s.scan(/\w*\-\w*/).first)
  end
end

安裝方法也很簡單：
1.
編輯 "config/environment.rb"，在檔案最後面加上以下兩行敘述

require 'multi_lingual'
include MultiLingual

將 MultiLingual 模組內的方法 mixin 至 controller 當中，當作 self method 來叫用。

2.
編輯 "app/controller/application.rb"，在 class ApplicationController 定義裡面加入以下這行

before_filter LingualFilter

把我們自行定義的一個 filter 類別丟給系統，這樣就可以在 controller 處理 request 之前，依據瀏覽器的 HTTP_ACCEPT_LANGUAGE 來載入語系檔。

3. 在 config 目錄下新增一 lang 子目錄，裡面放置 .yml 語系翻譯檔，主檔名請依照小寫的語系編碼，例如 "zh-tw.yml", "zh-cn.yml", "en-us.yml"。檔案內容格式可依照 YAML 的方式，以下列方式來撰寫：

hello: 嗨
hell world: 見鬼了這世界
takol lose the job: 塔客贏得全世界

接下來就可以在 rhtml 檔案裡面這樣叫用：

<%=_ 'takol lose the job' %>

很簡單的模組，供有需要的朋友參考。當然也歡迎針對這模組的效能多加討論，日後也可以參照小影的思考方式，加上字典檔 (dictionary) 。我和 hoja 都不太能預測這種做法對於應用程式的整體效能影響如何，原來的做法是否可以將載入的翻譯 hash 雜湊表通用到 app 整體變數中，以避免每個 request 都載入一次語系檔，都有待大家給予我們意見。

最後，最重要的作者資訊：
Takol Liu [takol.liu@gmail.com]
Hoja Liang [hoja.tw@gmail.com]