russian

by yaroslav

yaroslav / russian

Russian language support for Ruby and Rails | Поддержка русского языка для Ruby и Rails

454 Stars 102 Forks Last release: Not found MIT License 125 Commits 19 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

h1. Russian "!https://secure.travis-ci.org/yaroslav/russian.png!":http://travis-ci.org/yaroslav/russian

Поддержка русского языка для Ruby и Rails при помощи библиотеки I18n.

Russian language support for Ruby and Rails, using I18n library.

h3. If you don't speak Russian

This code may still be useful for you and Ruby I18n community. You can learn how how to provide support of "standalone" (as defined in "Unicode CLDR":http://unicode.org/cldr/) month names with I18n and Rails without any custom backends or hacks, and how to use custom pluralization and transliteration locale settings. This library also includes a module (@[email protected]) with a set of helpers to provide simplistic pluralization and @[email protected] for Russian language -- in a way that is easier than using I18n methods.

Feel free to shoot an email to Yaroslav Markin ("[email protected]":mailto:[email protected])

h1. Что это

Russian -- это библиотека для полноценной поддержки русского языка (форматирование даты и времени, плюрализация, транслит, локализация в целом) для Ruby и Ruby on Rails.

Цель проекта -- построить полноценную среду для русской локализации Ruby и Rails проектов, при этом используя минимально возможное количество хаков, сохраняя при этом поддержку локализации приложения на другие языки, а также форсировать включение в основную ветку I18n и Rails всех функций локализации, необходимых для работы с русским языком. Поскольку сделать в Rails поддержку довольно сложного языка для локализации (каким и является русский) сразу же было проблематично, вместе с командой @gem [email protected] решено было обкатывать решение для русского языка на отдельном gem/плагине, и по мере возможности переносить наиболее общий функционал в "родительскую" библиотеку I18n. Таким образом, общей целью @gem [email protected] стала поддержка русского языка до тех пор, пока она не появится в самом I18n.

Russian использует библиотеку I18n (включена в поставку), несколько хаков поверх Rails (хаки хелперов даты-времени, хак для сообщений валидации) и файлы переводов, а также набор хелперов, упрощающий работу с русским языком (простая плюрализация, простой strftime и др.).

Russian стремится быть минимально деструктивной для окружения и быть полностью совместимой с другими языками (таким образом, когда приложение использует Russian, оно остается полностью совместимым с Rails i18n).

h2. Что такое I18n. История

Библиотека I18n входит в состав Ruby on Rails начиная с версии 2.2. I18n -- это самое простое и недеструктивное решение для локализации и интернационализации Rails приложений. К сожалению, в первых версиях отсутствовала поддержка нескольких важных возможностей, специфичных для русского языка. Таким образом, русский язык для локализации в Rails 2.2 фактически не поддерживался.

Для исправления этого досадного недоразумения появилась библиотека Russian. Ранее Russian включал в себя собственный бекенд для перегрузки форматирования даты-времени (использование названия месяца или дня недели в зависимости от контекста) и плюрализации (стандартный бекенд поддерживал только плюрализацию для английского языка), несколько хаков для Rails 2.2/2.3 (ActionView, ActiveRecord, ActiveSupport), полную локализацию даты-времени и таблицы переводов Rails на русский язык, и вспомогательные модули (плюрализация и транслитерация). Gem отлично работал на Rails 2, устраняя недостатки @gem [email protected] "из коробки".

В версии 0.2 @gem [email protected] наконец появились первые средства для поддержки русского языка: в соавторстве с вашим покорным "была добавлена поддержка lambda-переводов":http://svenfuchs.com/2009/7/12/ruby-i18n-gem-hits-0-2-0, благодаря которой стало возможным вынести логику перевода названия месяца/дня недели в таблицу переводов. Далее в @gem [email protected] появилась поддержка хранения правил плюрализации в таблице переводов (опять же, с помощью lambda-переводов) и правил транслитерации. По сути, после этого цель @gem [email protected] была практически достигнута: опытные разработчики могли работать с русским языком, используя лишь собственные таблицы переводов в своем приложении и несколько хаков к Rails (по необходимости). Rails 3.0 вышел с последней версией @gem [email protected], где была уже практически полная поддержка механизмов для русского языка.

Однако, документация по плюрализации и транслитерации в I18n была неочевидной, а поддержка lambda-переводов для локализации даты-времени была практически "спрятана" в исходном коде, поэтому большинство разработчиков в основном использовали самые базовые таблицы переводов: локализацию Rails и, иногда, — плюрализацию. Возникла мысль выпустить @gem [email protected] для последней версии @gem [email protected] и Ruby on Rails с поддержкой всех необходимых функций, но, на этот раз, грамотно сделанных через интерфейсы I18n. К сожалению, "хаки" для Ruby on Rails (хелперы даты-времени) вряд ли когда-либо будут включены в дистрибутив Rails, поэтому использовать их придется отдельно.

h1. Требования

  • Ruby 1.8.7 или 1.9.2 (поддерживается совместимость с JRuby и Rubinius); "!https://secure.travis-ci.org/yaroslav/russian.png!":http://travis-ci.org/yaroslav/russian

  • Для использования с Rails нужна версия не ниже 3.0 (для более старых версий Rails используйте версии gem russian ветки 0.2);

  • Для разработки и тестирования библиотеки вам понадобятся Bundler и RSpec.

h1. Установка

Страница Russian на GitHub -- "http://github.com/yaroslav/russian/":http://github.com/yaroslav/russian/

Для установки:

@gem install [email protected]

Чтобы задать локаль по умолчанию в вашем приложении, используйте


I18n.default_locale = :ru

Чтобы установить локаль для текущего треда, используйте


I18n.locale = :ru

h2. Ruby on Rails 3.0 и выше

В вашем @[email protected] сделайте ссылку на gem @[email protected]:


gem 'russian', '~> 0.6.0'

И установите gem в проект с помощью bundler:

@bundle [email protected] или @bundle [email protected]

Далее, укажите


config.i18n.default_locale = :ru

в @config/[email protected] Если по умолчанию нужна другая локаль, или же нужно переключать локали "на ходу", используйте методы модуля I18n (см. выше). Также ознакомьтесь с "документацией к I18n":http://rdoc.info/github/svenfuchs/i18n/master и "гидом по интернационализации Ruby on Rails":http://guides.rubyonrails.org/i18n.html.

h2. Ruby on Rails 2.2 и 2.3

Используйте старые версии gem (@[email protected]). Получить код и почитать инструкцию по установке можно "здесь":https://github.com/yaroslav/russian/tree/eae28e3098797d06ff0574fb1bf99238eec124fe.

h1. Использование

@gem [email protected] можно использовать как с Ruby on Rails, так и отдельно: с любым другим веб-фреймворком, или в любом другом приложении, не имеющим никакого отношения к вебу. Дело в том, что @gem [email protected], который Ruby on Rails использует для интернационализации, включен в @gem [email protected] как зависимость.

При загрузке Russian подключает библиотеку I18n (либо использует уже подключенную, например, в Rails), добавляет файлы русских переводов из поставки в самое начало пути поиска переводов I18n (это значит, что любой перевод из Russian вы сможете легко переопределить в вашем приложении), добавляет в используемый по умолчанию бекенд I18n поддержку плюрализации и транслитерации, и, наконец, перегружает бекенд.

Предыдущие версии Russian форсированно выставляли локаль I18n по умолчанию в @:[email protected] (Русский язык), от этого решено было отказаться: в Rails стало неудобно работать с мультиязычными приложениями, так как конструкция вида @config.i18n.default_locale = :[email protected] не работала. Теперь для использования русского языка в Rails по умолчанию нужно использовать строку


config.i18n.default_locale = :ru

в @config/[email protected] Для использования Russian отдельно от Rails можно выставить локаль I18n в русскую по умолчанию или для текущего треда, соответственно:


I18n.default_locale = :ru

I18n.locale = :ru

Также предыдущие версии Russian заменяли используемый I18n бекенд на собственный: другого способа получить качественную локализацию для даты-времени и поддержку плюрализации не было. Новые версии I18n включают в себя поддержку @lambda {}@ в таблицах переводов ("ссылка":http://svenfuchs.com/2009/7/12/ruby-i18n-gem-hits-0-2-0), поэтому собственный бекенд больше не нужен. Обратите внимание: если вы используете бекенд, отличный от стандартного, вам потребуется включить в него поддержку плюрализации (модуль @I18n::Backend::[email protected]) и транслитерации (@I18n::Backend::[email protected]).

Если во время загрузки Russian уже загружены библиотеки Rails, происходит загрузка хаков для Rails 3.0 и выше:

  1. Хелперы даты получают ключ @:usestandalone[email protected] (для форсирования использования "отдельностоящего" названия месяца). Если ключ не указан, хелпер самостоятельно будет пытаться определить форму названия месяца: так, например, хелпер для выбора числа, месяца и года будет использовать "контекстную" форму названия месяца.

  2. Включается перегрузка валидации для ActiveModel: если сообщение валидации указать с "птичкой" в начале, при выводе сообщений об ошибках (@full[email protected]) для этого конкретного сообщения не будет указано название атрибута, к которому он относится. Этот фукнционал нужен, скорее, для тех, кто привык использовать подобные "хаки": в Rails 3 эта задача решается с помощью ключа @full[email protected] в таблице переводов.

Наконец, становится доступен модуль Russian (инструкция ниже), который нужен для быстрого доступа к некоторым основным и вспомогательным функциям локализации (плюрализация без таблицы переводов, транслитерация) и для методов интернационализации с форсированной локалью русского языка (перевод в русской локали, перевод даты-времени в русской локали).

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

"Документация I18n":http://rdoc.info/github/svenfuchs/i18n/master

"Гид по интернационализации Ruby on Rails":http://guides.rubyonrails.org/i18n.html.

h2. Ключевые отличия от стандартной библиотеки I18n

  1. Поддержка двух видов названий месяцев -- контекст ("сентября") и отдельностоящее ("Сентябрь") и дней недели.

В словарях Russian определены оба варианта названий месяцев. В таблице переводов для русского языка (@locale/[email protected]) указаны правила для перевода: в зависимости от формата строки @[email protected], используется контекстное или отдельностоящее название.

По аналогии есть поддержка двух видов названий дней недели.

NB: обратите внимание на нестандартные названия ключей при перечислении месяцев и дней недели в @locale/[email protected] NB: на необычных форматах @[email protected]строк контекст может не распознаваться; просто "дробите" в таком случае строку @[email protected] на части.

  1. Плюрализация

Включены правила плюрализации для русского языка (согласно CLDR). Их можно использовать как через интерфейс I18n, так и с помощью метода @Russian::[email protected]

  1. Транслитерация

Включен модуль для транслитерации русского алфавита: им можно пользоваться как через собственный интерфейс (@Russian::[email protected]), так и через интерфейс I18n.

h2. Ruby on Rails

h3. Переводы

При использовании с Ruby on Rails загружаются все стандартные переводы, и русский язык становится годным к использованию для локализации. В поставку включены все нужные переводы для ActionView, ActiveRecord, ActiveSupport, ActiveModel, которые можно переопределять по необходимости стандартными средствами I18n из вашего приложения.

h3. Хелперы

Хелперы даты-времени получают ключ @:usestandalonemonth[email protected] для форсирования отображения отдельностоящего названия месяца ("Сентябрь" а не "сентября"). Такое имя месяца используется когда включен ключ @:usestandalonemonth[email protected] (для отдельностоящего @select[email protected] он включается по умолчанию), либо когда есть ключ @:discard[email protected]

h3. Валидация

На тот случай, если по каким-то причинам нельзя воспользоваться ключом @[email protected] в таблице переводов, Russian перегружает вывод "полных сообщений" об ошибках в ActiveModel.

Так, например,

@validatesacceptanceof :accepted_terms, :message => 'нужно принять соглашение'@

при валидации выдаст сообщение

@Accepted terms нужно принять соглашение@

или, например

@Соглашение об использовании нужно принять соглашение@

если вы указали перевод для имени атрибута.

Но

@validatesacceptanceof :accepted_terms, :message => '^Нужно принять соглашение'@

даст сообщение

@Нужно принять соглашение@

h3. Параметризация строк

Метод @[email protected] инфлектора ActiveSupport использует механизмы транслитерации I18n. Если русская локаль является текущей, он сможет поддерживать транслитерацию букв русского алфавита.

Пример:


class Person
  def to_param
    "#{id}-#{name.parameterize}"
  end
end

@person = Person.find(1)
# => #


# => Дональд Кнут

NB: Для простоты иногда проще воспользоваться методом @Russian::[email protected] напрямую (чтобы не зависеть от текущей локали).

h1. Справочник

h2. Примеры и справка по переводам (I18n)

Небольшую справку по переводам (I18n) и пример того, как можно переводить имена моделей, атрибутов, и многие другие вещи, определенные в Rails или I18n, можно посмотреть в директории @lib/russian/[email protected] Там находятся файлы переводов, которые используются в Russian, со всеми комментариями.

h2. Вспомогательные методы модуля Russian


Russian.locale
Russian::LOCALE

-- возвращает локаль русского языка (@:'ru'@).


Russian::init_i18n

-- инициализация Russian. Добавление русских переводов в путь загрузки, включение модулей для плюрализации и транслитерации и перегрузка I18n.

NB: Выполняется автоматически при загрузке.


Russian::translate
Russian::t

-- прокси для метода @[email protected] I18n, форсирует использование русской локали.


Russian::localize
Russian::l

-- прокси для метода @[email protected] I18n, форсирует использование русской локали.


Russian::strftime

Russian::strftime(Time.now)
=> "Пн, 01 сент. 2008, 11:12:43 +0300"
Russian::strftime(Time.now, "%d %B")
>> "01 сентября"
Russian::strftime(Time.now, "%B")
=> "Сентябрь"

-- @[email protected] с форсированием русской локали (упрощенный вариант @[email protected])


Russian::pluralize
Russian::p

Russian.p(1, "вещь", "вещи", "вещей")
=> "вещь"
Russian.p(2, "вещь", "вещи", "вещей")
=> "вещи"
Russian.p(10, "вещь", "вещи", "вещей")
=> "вещей"
Russian.p(3.14, "вещь", "вещи", "вещей", "вещи") # последний вариант используется для дробных величин
=> "вещи"

-- упрощенная (без использования хешей I18n) плюрализация для русского языка


Russian::transliterate
Russian::translit

Russian.translit("рубин")
=> "rubin"
Russian.translit("Hallo Юлику Тарханову")
=> "Hallo Yuliku Tarhanovu"

-- транслитерация русских букв в строке.

h1. Авторы

Для сообщений об ошибках, обнаруженных неточностях и предложений:

При участии:

  • "Юлика Тарханова":http://julik.nl
  • "Евгения Пименова":http://libc.st/
  • "Дмитрия Смалько":http://github.com/dsmalko
  • "Алексея Фортуны":http://github.com/dadooda
  • "Антона Агеева":http://blog.antage.name/
  • "Александра Семенова":http://rotuka.com/
  • "valodzka":http://github.com/valodzka
  • "Николая Немшилова":http://github.com/MadRabbit

Огромное спасибо:

"Юлику Тарханову":http://julik.nl за "rutils":http://rutils.rubyforge.org/

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.