[翻译]Play框架1.2.7版本教程(12) - 国际化和本地化

摘要：国际化和本地化完成了博客引擎后，我们来考虑额外的一件事应用的国际化和语言的本地化。国际化和本地化我们将分两步讨论，先是国际化，再是本地化。实际上，两者是同步进行的你在国际化的同时，往往也是在本地化。

完成了博客引擎后，我们来考虑额外的一件事：Web应用的国际化和语言的本地化。虽然我们可以一开始就做这件事，但是最好还是先完成该应用的单一语言版本，然后再添加其他语言的支持。

我们将分两步讨论，先是国际化，再是本地化。这两样都会被重点提及。

国际化，在编程领域中，指的是移除本地特定的代码。在Web应用中，基本上是修改模板中特定于语言的交互文本。它还包括修改非文本的数据类型：日期，货币和其他数字。

本地化，是打造应用的本地版本。如果应用已经国际化了，就意味着存在一个或多个可选的本地版本。在Web应用中，本地化主要是把交互文本翻译成特定的语言。这里的“特定语言”，取决于浏览器和应用自己的设置。

实际上，两者是同步进行的：你在国际化的同时，往往也是在本地化。

  
我们此次的起点，是在Play安装包的samples-and-tests/yabe中的已完成版本。目标是彻底国际化应用，然后添加简体中文的本地版本。（我擅自修改了教程的内容 ：D ）

现在开始吧。首先打开conf/application.conf，去除注释或添加一行来支持两种语言：

# 为英文，简体中文本地化
application.langs=en,zh_CN

如果你现在启动应用，Play命令行会显示两个Warning，因为你还没准备好本地信息文件：

16:19:04,728 WARN ~ Messages file missing for locale en 
16:19:04,729 WARN ~ Messages file missing for locale zh_CN

前面的警告提醒我们需要把现有的conf/messages文件替换成每个语言对应一个信息文件：

messages.en
messages.zh_CN

在这里，我们遇到跟一般在Java中的做法不一样的地方。这些文件用的语法跟Java properties文件一样，但它们不是properties文件，因为它们需要使用UTF-8编码。而Java properties文件使用的是Latin-1编码。

使用UTF-8进行编码能够给本地化带来很多的好处。这使得你可以用纯文本记录下本地化信息。比如，这意味着对于希腊本地化文本，原本需要：

hello.morning = u0152u222bu0152u00b1u0152u00aau0152u2211u0152u00bau0152u2260u0153u00c5u0152u00b1
hello.informal = u0152u2265u0152u00b5u0152u03c0u0152u00b1 u0153u00c9u0152u00f8u0153u00d6

现在只需直接使用希腊字母：

hello.morning = καλημέρα 
hello.informal = γεια σου

在本教程剩余部分，我们会在上述文件中定义信息，或在HTML模板中使用国际化标记。

最简单的情况是HTML模板中被包含起来的一条文本字符串。举个例子，在yabe/app/views/main.html模板内的tools列表中：

 
 
Log in to write something 
 

仅需使用&{"key"}语法，把该文本替换成待查找的信息，就能实现国际化：

 
 
&{"views.main.tools.login"} 
 

添加对应的行到每个信息文件，就能实现本地化。在conf/messages.en：

views.main.tools.login = Log in to write something

在conf/messages.zh_CN：

views.main.tools.login = 写点什么

具体的内容由你来定；在这个例子中，我使用了一个键来标记位置views/main.html#tools

一旦保存了更改，刷新一下，应该可以看到原本的英文文本变成中文了。这是因为请求中设定了Accept-Language为zh-CN的缘故。

如果登录进博客的"admin"页面，你就能看到文章，标签，评论和用户的列表。这些页面是CRUD模块的功劳。对于每个页面，标题和列表头是与应用的模型，比如JavaBean类和属性名，联系在一起的。

我们可以使用这些模型的名字作为信息键，来国际化CRUD模块。就跟前面做的一样：

在conf/messages.zh_CN

post = 文章  
Post = 文章
posts = 文章列表
Posts = 文章列表  
comment = 评论
Comment = 评论
comments = 评论列表
Comments = 评论列表
user = 用户
User = 用户
users = 用户列表
Users = 用户列表

你将注意到那些圆角的紫色导航链接没有改变：

它们是在views/admin.html中定义的，通过用&{"..."}把文本包围起来，你就能把它们国际化：

&{"Posts"} 
… 
&{"Tags"} 
… 
&{"Comments"} 
… 
&{"Users"}

除了字面量字符串，我们的应用还包括带有变量的信息，比如posts tagged with Play。

对于带单个参数的字符串，用Java格式化字符串来插入参数：

views.Application.listTagged.title = Posts tagged with %s

接着在模板中，添加这样的参数：

&{"views.Application.listTagged.title", tag}

当一个信息包括多个参数时，在格式化字符串中添加索引来指定参数顺序：

views.Admin.index.welcome = Welcome %1$s, you have written %2$s posts so far

……然后就是这样：

&{"views.Admin.index.welcome", user, posts.size()}

在这个例子中，我们想要使用“post”的正确的复数形式，所以也把这个词当做一个参数：

views.Admin.index.welcome = Welcome %1$s, you have written %2$s %3$s so far

然后在模板中使用pluralize拓展：

&{"views.Admin.index.welcome", user, posts.size(), posts.pluralize(messages.get("post"), messages.get("posts"))} 

注意我们需要使用messages.get来查找对应的单数和复数形式。

对Play模型的本地化就跟对其他地方的本地化一样。这个应用使用到了CRUD和Secure模块，意味着我们需要本地化play/modules/crud/conf/messages和play/modules/secure/conf/messages中的用到的信息。

在conf/messages.zh_CN:

# play/modules/crud (administration) 
crud.title = 管理面板
crud.home = 主页
crud.blank = 新增功能 
crud.index.title = 选择编辑对象
crud.index.objectType = 输入对象
crud.index.action = 
crud.index.add = 添加
crud.add = &{%s} 添加 
crud.list.title = &{%s} 
crud.list.size = %d &{%s} 
crud.list.totalSize = %d 总计 
crud.pagination.previous = « 上一页 
crud.pagination.next = 下一页 » 
crud.pagination.last = 末页 »» 
crud.pagination.first = «« 首页 
crud.show.title = &{%s} 编辑 
crud.save = 保存 
crud.saveAndContinue = 保存并继续编辑
crud.cancel = 取消 
crud.hasErrors = 请更正错误 
crud.blank.title = &{%s} 添加
crud.saveAndAddAnother = 保存并新增
crud.delete = &{%s} 删除 
crud.created = &{%s} 已创建
crud.saved = &{%s} 已保存
crud.deleted = &{%s} 已删除 
crud.delete.error = 此对象无法删除 
crud.search = 搜索 
crud.none = (无) 
crud.help.required = 必填
crud.help.minlength = 至少要有 %d. 
crud.help.maxlength = 最多只能是 %d. 
crud.help.email = 需要有效邮箱
crud.help.dateformat =  时间格式 YYYY-MM-DD
crud.help.numeric = 需要数值类型 
crud.help.min =  至少需要 %d 
crud.help.future = 在将来 
crud.help.past = 在之前 
crud.help.after = 之上 %s. 
crud.help.before = 之下 %s. 
crud.help.range = 从 %d 到 %d 

# play/modules/secure 
secure.username = 您的邮箱: 
secure.password = 您的密码: 
secure.signin =  马上登录

当你在本地化一个Web应用时，假如你正在使用一个基于组件的Web应用框架，比如JavaServer Faces，难免会遇到一些难以下手的地方：

在属性的值中用到了参数信息

格式化字符串中的信息

用作信息的链接

在Play里，这三点都不是问题。

第一种情况，你在模板的属性的值里用到了参数信息，比如：

&{"views.tags.display.author", _post.author.fullname, comment.postedAt.format("yyyy-MM-dd")}"} 

&{"views.tags.display.author", _post.author.fullname, comment.postedAt.format(messages.get("views.dateFormat"))}"}

logIn = Log in to write something

&{"logIn", "/admin"} 

我们应用就曾用这样的语法会让框架生成基于路由文件的URL。要想在本地化的过程中处理它，使用：

&{"logIn"}, actionBridge.Admin.index()}