Railorz

  <div class="code">
    <strong class="header">Erb Code</strong>
    <table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1</pre></div></td><td class="code"><div class="highlight" style="background: #f8f8f8"><pre style="line-height: 125%"><span style="color: #008800">&lt;%=</span> <span style="color: #BB4444">&quot;Hello World&quot;</span><span style="color: #666666">[</span><span style="color: #B8860B">:hello_world</span><span style="color: #666666">]</span> <span style="color: #008800">%&gt;</span>

  </div>

По дефолту будет выводиться строка как она указана в кавычках. Однако, стоит нам сменить текущую локализацию, как вместо значения в кавычках будет подставлено значение из файла локализации, соответствующее ключу в квадратных скобках.

Файл локализации

Локализованные строки хранятся в YAML-файлах в папке RAILS_ROOT/lang. Названия файлов соответствуют названиям локализаций. Например, ru.yml:

  <div class="code">
    <strong class="header">Yaml Code</strong>
    <table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1

2 3

hello_world: Привет, мир
welcome: Добро пожаловать, {user}
good_bye: Всего доброго

  </div>

В development-режиме файлы локализации заново загружаются при каждом запросе.

Переключение языков

Текущий язык переключить очень просто:

  <div class="code">
    <strong class="header">Ruby Code</strong>
    <table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1</pre></div></td><td class="code"><div class="highlight" style="background: #f8f8f8"><pre style="line-height: 125%"><span style="color: #880000">Gibberish</span><span style="color: #666666">.</span>current_language <span style="color: #666666">=</span> <span style="color: #B8860B">:ru</span>

  </div>

В этом случае будут использоваться строки локализации из файла RAILS_ROOT/lang/ru.yml. Кроме того, язык можно переключить только для выполнения конкретного блока, например, в составе фильтра:

  <div class="code">
    <strong class="header">Ruby Code</strong>
    <table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1

2 3 4 5 6 7 8

class ApplicationController < ActionController::Base
  around_filter :set_language


private
  def set_language

<span style="color: #880000">Gibberish</span><span style="color: #666666">.</span>use_language(session<span style="color: #666666">[</span><span style="color: #B8860B">:language</span><span style="color: #666666">]</span>) { <span style="color: #AA22FF; font-weight: bold">yield</span> }


  end
end

  </div>

По умолчанию используется локализация :en.

Вставка текста

Gibberish поддерживает замечательную возможность - поздняя вставка текста в строки локализации. Например, нам нужно локализовать приветственное сообщение. В русском языке оно должно выглядеть как "DEkart, добро пожаловать", а в английском как "Welcome, DEkart". В этом случае мы задем строку локализации следующим образом:

  <div class="code">
    <strong class="header">Yaml Code</strong>
    <table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1

2 3 4 5

# ru.yml
welcome: {user}, добро пожаловать


# en.yml
welcome: Welcome, {user}

  </div>



  <div class="code">
    <strong class="header">Erb Code</strong>
    <table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1

2

# шаблон
<%= ""[:welcome, current_user.login] %>

  </div>

Подстрока {user} будет автоматически заменена на current_user.login. Если после ключа в квадратных скобках передается массив, то подстроки в фигурных скобках будут заменяться последовательно. Если же передан Hash, то замена произойдет в соответствии с ключами:

  <div class="code">
    <strong class="header">Yaml Code</strong>
    <table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1

2

# ru.yml
welcome: {user}, добро пожаловать! У вас {message_count} сообщений.

  </div>



  <div class="code">
    <strong class="header">Erb Code</strong>
    <table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1

2 3

# шаблон
<%= ""[:welcome, {:message_count => @message_count, :user => current_user.login}] %>
=> DEkart, добро пожаловать! У вас 10 сообщений.

  </div>

Установка

  <div class="code">
    <strong class="header">Bash Code</strong>
    <table class="highlighttable"><tr><td class="linenos"><div class="linenodiv"><pre>1</pre></div></td><td class="code"><div class="highlight" style="background: #f8f8f8"><pre style="line-height: 125%">ruby script/plugin install svn://errtheblog.com/svn/plugins/gibberish

  </div>

README на английском: http://require.errtheblog.com/plugins/browser/gibberish

Резюме

Плагин очень прост и понятен. Я использую его для локализации всех строковых значений в шаблонах, моделях, контроллерах: текстов ссылок, flash-сообщений, сообщений об ошибках валидации, даже форматов дат. Конечно, с помощью gibberish не реализовать перевод данных в моделях, но этого и не требуется. Перевод моделей - это совсем другая история.