Link Search Menu Expand Document

3. 多國語系設置

3-1 配置中文語系

Rails 支持多國語系(Internationalization,簡稱I18n),預設的語系是英文,請先修改 config/application.rb 將預設改為中文:

  class Application < Rails::Application

+   config.i18n.default_locale = "zh-CN"

  end

所謂的多國語系的功能,是指網站中的句子和單字,可以根據用戶的需求進行切換。實際的作法就是準備翻譯詞匯檔,然後將樣板中本來寫死的文字,置換成調用 I18n 方法。

例如,請新增 config/locales/zh-CN.yml 這個詞匯 YAML 檔:

"zh-CN":
  event_list: 活動列表
  admin:
    event_list: 活動列表管理

修改 config/locales/en.yml

  "en":
+   event_list: Event List
+   admin:
      event_list: Admin Event List

注意 YAML 格式的縮排必須使用兩個空格,Tab 是不允許的。直接複製貼上可能會有問題,請小心檢查縮排。

修改 app/views/events/index.html

-  <h1>Event List</h1>
+  <h1><%= t("event_list") %></h1>

修改 app/views/admin/events/index.html

-  <h1>Admin Event List</h1>
+  <h1><%= t("admin.event_list") %></h1>


也可以寫成 t("event_list", :scope => "admin") 結果是一樣的

其中 t 等同於 I18n.t,是個 Helper 方法,會根據語系來做字符串的替換。

重啟伺服器,瀏覽看看就會發現這個單字被替換成中文了。

image

新增詞匯檔案需要重啟伺服器,修改詞匯不需要。

3-2 詞匯中內嵌變數

有些句子可能會需要內嵌變數,可以使用 %{variable_name} 的語法,例如:

  "zh-CN":
+   hello: "親~ %{name} 你好:"

  "en":
-   hello: "Hello world"
+   hello: "Hi %{name},"

修改 app/views/layouts/application.html.erb

-  <%= current_user.display_name %>
+ <%= t( "hello", :name => current_user.display_name) %>

image

如果我們的網站不需要支援多國語系,你可能會覺得這樣做有點辛苦,直接將中文寫在樣板上就好了。

但這個功能對於團隊協作開發網站仍然非常有幫助,因為寫程式的時候不一定會先確定文案規格,用 I18n 來處理的話,最後只需要讓 PM 統一修改翻譯詞匯檔即可。

3-3 安裝 Rails 中文翻譯詞匯檔

Rails 本身就有用到 I18n 的功能,可以安裝 rails-i18n 這個 gem 有開源社區做好的中文翻譯:

編輯 Gemfile,加上

gem "rails-i18n"

執行 bundle

重啟伺服器。會被翻譯的詞匯請參考 https://github.com/svenfuchs/rails-i18n/blob/master/rails/locale/zh-CN.yml

image

3-4 安裝 Devise 翻譯檔

Devise 也有用到 I18n,可以安裝 devise-i18n 這個 gem 有開源社區做好的中文翻譯:

請編輯 Gemfile,加上

gem "devise-i18n"

執行 bundle

重啟伺服器。會被翻譯的詞匯請參考 https://github.com/tigrish/devise-i18n/blob/master/rails/locales/zh-CN.yml

image

3-5 Model 字段翻譯

在套用上述的翻譯詞匯檔之後,你可能會註意到 Model 驗證錯誤訊息會變成如 Name 不能為空字符,如果需要進一步中文化字段名稱,你可以新增 config/locales/events.yml 內容如下:

   zh-CN:
+    activerecord:
+      attributes:
+        event:
+          name: "活動名稱"
+          description: "描述"

image

其實,翻譯檔檔名叫 events.yml、zh-TW.yml、en.yml 什麽都無所謂,重要的是 YAML 結構中第一層要對應locale的名稱,也就是 zh-CN,Rails 會加載 config/locales 下所有的YAML詞匯檔案。

3-6 如何讓使用者可以切換多語系

剛剛我們準備了中文和英文翻譯檔案,但是並沒有提供切換的機制。

接下來請編輯 app/controllers/application_controller.rb 中加入:


+ before_action :set_locale
+
+ def set_locale
+   # 可以將 ["en", "zh-CN"] 設定為 VALID_LANG 放到 config/environment.rb 中
+   if params[:locale] && I18n.available_locales.include?( params[:locale].to_sym )
+     session[:locale] = params[:locale]
+   end
+
+   I18n.locale = session[:locale] || I18n.default_locale
+ end

修改 app/views/layouts/application.html.erb

+   <%= link_to "中文版", :controller => controller_name, :action => action_name, :locale => "zh-CN" %>
+   <%= link_to "English", :controller => controller_name, :action => action_name, :locale => "en" %>

    </div>
  </body>

瀏覽並點選中文版、English 就會進行切換了。

3-7 語系樣板

除了上述一個單字一個單字的翻譯詞匯替換之外,如果樣板內大多是屬於較為靜態的內容,Rails 也提供了不同語系可以有不同樣板,你只要將樣板命名加上語系附檔名即可,例如我們來產生 FAQ 頁面:

執行 rails g controller pages

編輯 config/routes.rb

+  get "/faq" => "pages#faq"

新增 app/views/pages/faq.zh-CN.html.erb

新增 app/views/pages/faq.en.html.erb

如此在英文版的時候就會使用 faq.en.html.erb 這個樣板,中文版時使用 faq.zh-CN.html.erb 這個樣板。

最後,編輯 app/views/layouts/application.html.erb 放上 FAQ 頁面的連結:

   <%= yield %>

+  <%= link_to "FAQ", faq_path %>


Copyright © 2010-2021 Wen-Tien Chang All Rights Reserved.