i18n_generators 技术文档

本文档将详细介绍如何安装、使用以及API调用的方法，帮助用户更好地理解和运用 i18n_generators 项目。

1. 安装指南

1.1 安装要求

i18n_generators 支持以下版本的 Ruby 和 Ruby on Rails：

• Ruby 3.1, 3.0.x, 2.7.x, 2.6.x, 2.5.x, 2.4.x, 2.3.x, 2.2.x, 2.1.x, 2.0.0, 1.9.x, 1.8.7
• Ruby on Rails 7.0, 6.1, 6.0, 5.2, 5.1, 5.0, 4.2, 4.1, 4.0, 3.2, 3.1, 3.0
• Ruby on Rails 2.3, 2.2 (支持 i18n_generators 版本小于 1.2)

1.2 安装步骤

对于 Rails 3 或更高版本（使用 Bundler）：

1. 将 i18n_generators 添加到 Gemfile 中。
2. 运行 bundle 命令。
3. 建议将 Gemfile 中的 group 限制为 :development，因为生成器很可能仅在开发模式下使用。

对于 Rails 2：

使用 i18n_generators 版本 < 1.2。

2. 项目的使用说明

i18n_generators 提供以下三个生成器命令：

2.1 生成 ActiveRecord/ActiveSupport/ActionPack/ActionView 的本地化文件

运行以下命令生成指定语言的本地化文件：

rails g i18n_locale ja (de-AT, pt-BR, 等.)

此命令将从官方 rails-i18n 存储库下载 .yml 文件，并设置应用程序的默认本地化设置。生成的本地化文件将保存在 config/locales/ja.yml。

2.2 生成所有模型/属性的翻译 YAML 文件

运行以下命令生成包含所有 AR 模型和属性的 YAML 文件：

rails g i18n_translation ja (de-AT, pt-BR, 等.)

此命令将扫描 app/models 目录，并生成一个包含所有 AR 模型和属性的 YAML 文件，以便您无需手动编写 YAML 框架。此外，生成器会尝试将每个模型和属性翻译成指定的语言。生成器不会覆盖现有的值，因此您可以多次运行生成器。

生成 YAML 文件中的 #g 标记表示该行是由生成器生成的。

2.3 一次性生成所有文件

运行以下命令同时执行上述两个生成器：

rails g i18n ja (de-AT, pt-BR, 等.)

3. 项目 API 使用文档

i18n_generators 项目提供的 API 文档暂不提供，请参考项目源码和官方文档进行开发和使用。

4. 项目安装方式

请遵循上述安装指南进行项目的安装。

以上就是关于 i18n_generators 项目的技术文档，希望对您有所帮助。