[Ruby on Rails系列]4、专题：Rails应用的国际化［i18n］

1. 什么是internationalization（i18n）？

国际化，英文简称i18n，按照维基百科的定义：国际化是指在设计软件，将软件与特定语言及地区脱钩的过程。当软件被移植到不同的语言及地区时，软件本身不用做内部工程上的改变或修正。

当然，官方的定义总是十分高大上。实际上，今天我们要做的并没有那么复杂。任务是为上次的系列3里的Web站点提供多语言支持。比如上次是英语网站，这次我们可以根据用户地点自动提供中文网站或其他语言网站。

 

2.如何实现i18n？

2.1 Step1: 登录Cloud9，进入上次的开发环境

cd firstDemo

2.2 Step2:准备多语言字典（locale material）

进入该网站：https://github.com/svenfuchs/rails-i18n/tree/master/rails/locale

该网站提供了各种语言的locale模版，这里我们需要以下2个文件（当然如果你需要支持其他国家语言，还需要准备其他文件）：

［1］en.yml  （英语版本）

［2］zh-CN.yml  （简体中文版本）

2.3 Step3:编辑config／locales文件夹(1)

如上图，在该文件夹下我们看到只有一个文件：en.yml，将其打开发现只有2行代码如下：

en:
  hello: "Hello world"

这是一个yml文件模版，现在我们需要讲其换成上面的en.yml

点击进入：en.yml 打开文件，然后复制粘贴网页内容，将原来的en.yml文件内容覆盖

［注意点：正确的复制方法与错误的复制方法］

YML文件是通过key－value格式定义数据的文件，它是Ruby on Rails里的数据定义文件，特点是空格敏感！错误的复制方法会忽略空格进而导致语法错误。因此这里的操作非常重要。

［正确的复制方法］

如上图，点击红色区域的按钮，进入新的页面，然后再进行复制，即可保留空格。如果直接在该页面复制，会忽略空格导致语法错误！

2.4 Step3:编辑config／locales文件夹(2)

en.yml搞定以后，在config／locales文件夹下新建文件：zh.yml,再将zh-CN.yml下的内容同样复制过去

注意，zh.yml文件第一行应将zh-CN改成zh（去掉－CN）

 

接下来：我们需要对以上2个文件（en.yml和zh.yml）进行编辑，以适应我们的Web应用。

对于en.yml，我们需要在en：下一行，date：上一行区域输入以下代码（注意空格）：

en:
  memo_title: My Memopad
  show: Show
  edit: Edit
  destroy: Destroy
  list_memo: Listing memos
  new_memo: New Memo
  date:

对于zh.yml，插入如下代码：

zh:
  memo_title: 我的记录
  show: 展示
  edit: 编辑
  destroy: 删除
  list_memo: 列表
  new_memo: 新建
  date:

2.5 Step4:修改views页面文件

[1]app/views/memos/index.html.erb文件第17~19行

将该3行代码改为如下代码：

<td><%= link_to (t 'show'), memo %></td>
<td><%= link_to (t 'edit'), edit_memo_path(memo) %></td>
<td><%= link_to (t 'destroy'), memo, method: :delete, data: { confirm: 'Are you sure?' } %></td>

<% (ruby表达式) %> 该符号表明可在标记中间插入ruby语句

<% =(ruby输出) %> 该符号可将ruby表达式的值转换成html输出结果

(t 'xxxx') t代表翻译函数，是translate的简写形式。该函数将输出引号所对应的值（参考前面的yml文件键值对理解）

[2]app/views/layouts/application.html.erb文件第4行

将改行改为下列代码：

<title><%= t 'memo_title' %></title>

[3]app/views/memos/index.html.erb文件第3行

将改行改为下列代码：

<h1><%=t 'memo_title' %></h1>

[4]app/views/memos/index.html.erb文件第27行

将改行改为下列代码：

<%= link_to (t 'new_memo'), new_memo_path %>

2.6 修改config/application.rb文件

取消第20行，第21行注释；并将'my'改为'config',将:de改为:zh，并添加一行代码config.encoding = 'utf-8'，代码如下:

config.i18n.load_path += Dir[Rails.root.join('config', 'locales', '*.{rb,yml}').to_s]
config.i18n.default_locale = :zh

config.encoding = 'utf-8'

这样，页面的默认显示语言就变为中文。

2.7 修改app/controllers/application_controller.rb文件

将文件代码改为以下代码：

class ApplicationController < ActionController::Base 
    protect_from_forgery 
    
    before_filter :set_locale 
    
    def set_locale 
      I18n.locale = params[:locale] || I18n.default_locale 
    end 
end 

至此，i18n配置完毕，现在已经实现了中英双语支持！

 

3 测试网页

3.1 启动服务器

$ rails server -b $IP -p $PORT 

3.2 测试默认网页

https://rails-tutorial-c9-lichcnpul.c9.io/memos，注意默认网页会自动转为中文页

3.3 测试英文网页

https://rails-tutorial-c9-lichcnpul.c9.io/memos?locale=en

3.4 测试中文网页

https://rails-tutorial-c9-lichcnpul.c9.io/memos?locale=zh

 

测试成功，至此本次国际化专题也就告一段落。敬请期待[Ruby on Rails系列]5（待定）