I18nRouting 技术文档

1. 安装指南

I18n_routing 是一个 Ruby on Rails 插件，可以让你轻松地通过 Rails 自带的 I18n API（从版本 2.2 开始包含）来翻译你的路由。

安装步骤：

1. 将 I18n_routing 添加到你的 Gemfile 中：

   gem 'i18n_routing'
   

2. 运行 bundle install 来安装 gem。

3. 在你的 Rails 应用的 config/initializers 目录中创建一个名为 i18n_routing.rb 的文件，并添加以下内容来设置默认的本地化参数：

   I18nRouting.setup do |config|
     # 这里设置你的配置参数
   end
   

4. 确保你的应用使用的是 Rails 2.3、3.0、3.1 或 3.2 版本。

2. 项目的使用说明

I18n_routing 允许你通过 Rails 的 I18n API 翻译你的路由。这意味着你可以在不同的语言环境中定义路由的名称，使你的应用支持国际化。

使用方法：

1. 在你的路由文件（通常是 config/routes.rb）中，使用 locale 方法来指定需要本地化的路径段：

   scope "(:locale)", locale: /en|fr|de/ do
     resources :articles
   end
   

2. 在你的控制器中，你可以使用 I18n.t 方法来本地化路由名称：

   def show
     @article = Article.find(params[:id])
     redirect_to i18n.t('routes.articles.show', id: @article.id)
   end
   

3. 在你的视图文件中，使用 URL 辅助方法时，可以指定语言参数来生成相应的本地化链接：

   <%= link_to 'Show', article_path(@article, locale: I18n.locale) %>
   

3. 项目API使用文档

I18n_routing 提供了一些类方法和实例方法来帮助你处理本地化路由。

类方法：

• I18nRouting.locale：获取当前的语言环境设置。

• I18nRoutinglocales：获取支持的所有语言环境。

实例方法：

• locale：在路由定义中使用，指定路径段需要本地化。

• t：在控制器或视图中使用，翻译路由名称。

4. 项目安装方式

如前所述，项目可以通过添加到 Gemfile 并运行 bundle install 来安装。确保你的 Rails 版本与 I18n_routing 支持的版本兼容。

---

本文档旨在帮助用户了解和使用 I18nRouting 插件。如有任何疑问，请参考项目 Wiki 或加入 i18n_routing Google 群组进行讨论。