[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(待定)

posted @ 2014-10-08 23:32  Kassadin  阅读(2928)  评论(4编辑  收藏  举报