国际化（Internationalization）

概述

如果你的应用程序会触及从世界各地而来的人或系统，国际化（i18n）和本地化（l10n）会是你国际化策略重要的一部分。Sails 提供内建支持，用于侦测用户语言偏好设置和翻译静态单字／句子，这要归功于 i18n-node（npm）。

用法

在检视内：

 <%= __('Hello')="" %=""> 
 <%= __('Hello="" %s,="" how="" are="" you="" today?',="" 'Mike')="" %=""> 
 <%= i18n('That\'s="" right--="" you="" can="" use="" either="" i18n()="" or="" __()')="" %=""> 

在控制器或政策内：

req.__('Hello'); // => Hola
req.__('Hello %s', 'Marcus'); // => Hola Marcus
req.__('Hello {{name}}', { name: 'Marcus' }); // => Hola Marcus

或者，你已经知道语系 ID，你可以在应用程序内的任何地方使用 sails.__ 翻译：

sails.__({
  phrase: 'Hello',
  locale: 'es'
});
// => 'Hola!'

语系

i18n 挂勾（hook）会从工程的「locales」目录（默认是 config/locales）读取 JSON 格式翻译文档。每个文档对应一个 Sails 后端所支持的语系（通常是语言）。

这些文档包含特定的语系字串（为 JSON 键值对），你可以使用在检视、控制器等地方。

这里有一个语系例子文档（config/locales/es.json）：

{
    "Hello!": "Hola!",
    "Hello %s, how are you today?": "¿Hola %s, como estas?",
}

请注意，语系档内的键（例如 "Hello %s, how are you today?"）有区分大小写且需要精准匹配。这里有几个不同思想流派的最佳翻译，要选择哪个翻译取决于未来最常会由谁编辑语系档与 HTML。特别是如果你会手动编辑，将键的名称全部小写会最提供最佳的可维护性。

例如，这里有另一个翻译在 config/locales/es.json：

{
    "hello": "Hola!",
    "hello-how-are-you-today": "Hola %s, ¿cómo estás?",
}

以及这里 config/locales/en.json：

{
    "hello": "Hello!",
    "hello-how-are-you-today": "Hello, how are you today?",
}

侦测和／或覆写请求的所需语系

使用新的语系代码呼叫 req.setLocale() 来覆写请求的自动侦测语言／本地化偏好设置：

// 强制让请求使用德文：
req.setLocale('de');
//（这会使用在 `config/locales/de.json` 的字串来翻译）

默认情况下，node-i18n 会通过检查请求的 Language 标头来侦测所需的语言。Language 标头是设置在用户的浏览器，且它们大多是正确的，你可能需要灵活覆写所侦测到的语系并提供翻译。

例如，如果你的应用程序允许使用者选择偏好语言，你可能会建立一个政策用来检查使用者会话（Session）内的自定义语言，如果存在的话，设置相应语系以便在后续的政策、控制器动作和检视使用：

// api/policies/localize.js
module.exports = function(req, res, next) {
  req.setLocale(req.session.languagePreference);
  next();
};

<!--

Alternatively, here's another extended example: (todo: at the very least pull this into a sep