Ember-CLI-I18n 使用指南

Ember-CLI-I18n 使用指南

项目介绍

Ember-CLI-I18n 是一个专为 Ember CLI 应用设计的简单国际化支持库。虽然这个库已被标记为废弃，并推荐使用更新版本的 ember-i18n（>=4.0.0），但它在早期被广泛用于实现多语言功能。它允许开发者轻松地管理应用程序中的翻译文本，确保应用能够适配不同的地区和语言需求。

项目快速启动

要快速开始使用 Ember-CLI-I18n，首先确认你的环境中安装了 Ember CLI。然后，通过以下步骤添加此库到你的项目：

1. 在终端中，导航到你的 Ember 应用目录。

2. 使用以下命令来安装已废弃版本的 ember-cli-i18n（请注意，在实际开发中可能需要考虑使用最新的 ember-i18n）：

   npm install --save-dev ember-cli-i18n
   

3. 安装完成后，你需要在你的 Ember 应用中配置国际化文件，通常这涉及到在 config/environment.js 中添加设置：

   if (environment === 'development') {
     // ...
   }
   
   if (environment === 'test') {
     // ...
   }
   
   if (environment === 'production') {
     // ...
   }
   
   // 添加国际化配置（示例）
   ENV.i18n = {
     defaultLocale: 'en'
   };
   

4. 创建你的翻译文件。在 app/locales 目录下创建如 en.json 的文件，定义你的翻译键值对。

   en.json

   {
     "greeting": "Hello, world!"
   }
   

5. 在模板或组件中使用翻译：

   {{t "greeting"}}
   

以上是快速启动的简要概述，但请记得检查官方文档或迁移到 ember-i18n 以获得更全面的特性和最新实践。

应用案例和最佳实践

• 变量插值：在模板中，可以将变量传递给翻译字符串。

  假设我们有一个用户的名字在变量中，我们可以这样做：

  {{t "hello-user" username=user.name}}
  

  在对应的 JSON 文件中：

  {
    "hello-user": "Hello, {{username}}!"
  }
  

• 条件性翻译：尽管直接在模板进行复杂的逻辑处理不是最佳实践，可以通过服务调用来间接实现基于条件的翻译。

典型生态项目

由于 ember-cli-i18n 已被废弃，推荐关注 ember-intl 或更新版本的 ember-i18n 作为替代方案，这些库通常有更好的生态支持和持续维护。它们在 Ember 生态系统中扮演着重要角色，提供了丰富的特性，如时间、日期和数字的本地化处理，以及更灵活的动态翻译和上下文敏感的翻译。

为了获取最佳实践和生态项目的详细指导，建议直接访问相应库的官方文档和GitHub仓库，以了解最新功能和社区推荐的方法。例如，ember-intl 提供了大量的示例和详尽的文档，非常适合希望深入了解国际化实现细节的开发者。

---

请注意，由于原项目已被废弃，实际开发工作应遵循最新的技术栈和推荐的库。本文档旨在提供关于如何过去使用 ember-cli-i18n 的一般信息，并鼓励转向现代解决方案。