rs_russian 0.7.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: ced7cff13d74526729a7b1e76b1b5a36e3b06c61
+  data.tar.gz: a43fae19bdb61d11dc275a2ae04cf74b4fe73509
+SHA512:
+  metadata.gz: 00c344e742ff2ff6974d5ef4ee5c0e5312a8d2c4b050423360d7eda0e8b38fd055c48e9baa992940ac02af99561a1b93dd709c75cfde32aaaf54b5e9de754e5f
+  data.tar.gz: eb159120fe0e1d424a6dd5d6137a8c83ccd58c2851ce600523b2cd9a9116619bf9b258b12a6aac68c12dda31fa9c41f031cf46da22cfa61758861b46f121d9c1

data/.gitignore

@@ -0,0 +1,5 @@
+.DS_Store
+*.swp
+pkg
+.bundle
+.rvmrc

data/.ruby-gemset

@@ -0,0 +1 @@
+russian

data/.ruby-version

@@ -0,0 +1 @@
+2.0.0

data/.travis.yml

@@ -0,0 +1,9 @@
+notifications:
+  email: false
+
+language: ruby
+rvm:
+  - 1.9.3
+  - 2.0.0
+  - jruby-19mode
+  - rbx-19mode

data/CHANGELOG

@@ -0,0 +1,132 @@
+=== 0.6.0 "Haters Gonna Hate" - 22.10.2011
+
+* i18n gem is now a dependency (not using vendored gem anymore)
+* I18n::Backend::Advanced custom backend is no longer used. Russian Ruby i18n files are portable for the first time; using Russian language with i18n does not require a custom backend with language-specific hacks anymore. It became possible thanks to lambda translations support in i18n gem (http://svenfuchs.com/2009/7/12/ruby-i18n-gem-hits-0-2-0) and inclusion of Pluralization backend. Notice: ff you are using a custom backend, don't forget to include I18n::Backend::Pluralization and I18n::Backend::Transliterator modules
+* Pluralization is now delegated to I18n backend
+* Transliteration is now delegated to I18n backend (using Russian::Transliteration, of course)
+* Minor gem russian version is now bumped to be in sync with minor version of required i18n gem
+* UPGRADING: Rails 2 is no longer supported, use older versions of the gem
+* UPGRADING: gem russian does not force Russian locale anymore, use I18n::locale/default_locale methods or config.i18n.default_locale = :ru in your Rails environment. Methods with forced encoding still can be used as Russian::translate, Russian::localize
+* Locale files and hacks (date helper, custom ActiveModel error message) updated to support Rails 3.0 and 3.1
+* README updated
+* Remove i18n_label plugin (labels i18n is supported in latest Rails releases)
+
+* gem i18n теперь является зависимостью для gem russian, а не включается в vendor, как раньше
+* Собственный бекенд I18n::Backend::Advanced больше не используется. Русские файлы локали i18n для Ruby наконец-то стали переносимыми и не требуют собственного бекенда и хаков для поддержки языка. Это стало возможным благодаря поддержке lambda-переводов в i18n (http://svenfuchs.com/2009/7/12/ruby-i18n-gem-hits-0-2-0) и включению Pluralization бекенда в gem i18n. Обратите внимание: если вы используете собственный бекенд (отличный от стандартного), не забудьте включить модули I18n::Backend::Pluralization и I18n::Backend::Transliterator
+* Механизм плюрализации теперь обеспечивает стандартный бекенд I18n
+* Механизм транслитерации теперь обеспечивает стандартный бекенд I18n (с помощью Russian::Transliteration, конечно)
+* Минорная версия gem russian повышена до текущей минорной версии i18n
+* UPGRADING: Rails 2 больше не поддерживается, используйте старые версии gem'а
+* UPGRADING: gem russian больше не форсирует использование русской локали, используйте методы I18n::locale/default_locale или config.i18n.default_locale = :ru в настройках окружения Rails. Если нужно форсировать русскую локаль, можно по-прежнему пользоваться методами Russian::translate, Russian::localize
+* Обновлены файлы переводов и хаки (выбор месяца в date helper, кастомные сообщения об ошибках ActiveModel) для поддержки Rails 3.0 и 3.1
+* Обновлен и переписан README
+* Удален плагин i18n_label (перевод label уже поддерживается в последних версиях Rails)
+
+=== 0.2.7 - 5.05.2010
+
+* Fix using of standalone/non-standalone month names with %d/%e surroundings.
+* Улучшено распознавание формы названия месяца с strftime макросами %d/%e.
+
+=== 0.2.6 - 25.03.2010
+
+* Minimum Rails 3.0b support: Added fourth parameter (options) defaulting to nil to Advanced backend localize method for compliance with i18n-0.3 [Nikolay V. Nemshilov]
+* Минимальная поддержка Rails 3.0b: В метод localize бекенда Advanced добавлен четвертый параметр, для совместимости с i18n-0.3. По умолчанию равен nil. [Николай Немшилов]
+
+=== 0.2.5 - 23.12.2009
+
+* Added support for multi-char substrings in Russian.transliterate [Alex Fortuna]
+* Rails 2.3.5 error messages overloading compatibility (error messages overloading) (thanks Alex Eagle for bugreport)
+
+* Russian.transliterate: Теперь можно добавлять правила матчинга подстрок из нескольких символов ("Воробьёв", "Алябьев"). [Alex Fortuna]
+* Rails 2.3.5: совместимость для перегрузки сообщений об ошибках (багрепорт -- Александр Орел)
+
+=== 0.2.4 - 12.11.2009
+
+* Revert nested validation errors patch
+
+* Убран патч для вложенных сообщений валидации (не работал с Rails 2.3.3 и ниже)
+
+=== 0.2.3 - 9.11.2009
+
+* Improve ActiveRecord translations [Dmitri Koulikoff]
+* Fix nested validation errors with custom error message hack for Rails < 2.3.4 [valodzka]
+* Added almost_x_years datetime translation
+
+* Улучшен перевод ActiveRecord [Dmitri Koulikoff]
+* Исправлена ошибка, возникающая при вложенных сообщениях валидации при использовании хака для Rails < 2.3.4 [valodzka]
+* Добавлен перевод для ключа даты/времени almost_x_years
+
+=== 0.2.2 - 17.09.2009
+
+* Fix ^-prefixed error messages handling on Rails 2.3.4
+
+* Для Rails 2.3.4 исправлена работа сообщений валидаций, начинающихся с "^"
+
+=== 0.2.1 - 5.09.2009
+
+* Rails 2.3.4 compat (ActiveRecord::Error) and deprecation warning (use errors.full_messages.format from now on) [Alexander Semyonov/Yaroslav Markin]
+* Added a couple of missing translations from Rails 2.3.4
+* transliteration: Ы now transforms to Y [Alex Fortuna]
+
+* Совместимость с Rails 2.3.4 (ActiveRecord::Error) и устаревшее форматирование через "^" (теперь надо использовать errors.full_messages.format) [Alexander Semyonov/Yaroslav Markin]
+* Добавлена пара недостающих переводов из Rails 2.3.4
+* транслитерация: Ы теперь превращается в Y [Alex Fortuna]
+
+=== 0.2.0 - 16.03.2009
+
+* number_to_human_size() translations: using edge format (Rails 2.3)
+* i18n gem updated (0.1.3)
+* Rails 2.3 compat
+
+* Перевод для number_to_human_size(): испольуется форматирование из edge (Rails 2.3)
+* Обновлен gem i18n до версии 0.1.3
+* Совместимость с Rails 2.3
+
+=== 0.1.3 - 27.12.2008
+
+* Add support.array.words_connector/two_words_connector/last_word_connector (Array#to_sentence) (Rails Edge)
+* Add datetime.prompts translations (Rails Edge)
+
+* Добавлены переводы для Array#to_sentence (Rails Edge)
+* Добавлены переводы для datetime.prompts (Rails Edge)
+
+=== 0.1.2 - 4.11.2008
+
+Fixed I18n.load_path ordering, translations shipped with russian gem will no longer overwrite your own translations (thanks Dmitrij Smalko for bugreport).
+
+Поправлено добавление переводов russian в I18n.load_path, теперь переводы из russian не будут замещать ваши собственные переводы (спасибо Dmitrij Smalko за обнаружение ошибки).
+
+=== 0.1.1 - 24.11.2008
+
+Added number.human.storage_units translation key (Rails Edge).
+
+Добавлен ключ number.human.storage_units (появился в Rails Edge).
+
+=== 0.1.0 - 22.11.2008
+
+No changes, Rails 2.2 released
+
+=== 0.0.9 - 21.11.2008
+
+* Updated I18n gem due to locale changes (0.1.1)
+* NB! I18n changed default locale from :'en-US' to :'en', same recommended for other locales by default
+* NB!! Russian locale is now :'ru' NOT :'ru-RU', update your locale files.
+
+* I18n gem обновился до 0.1.1 в связи с изменениями в названиях локалей
+* ВНИМАНИЕ: локаль по умолчанию I18n теперь называется не :'en-US' а :'en', такой же способ именования рекомендуется и для других локалей
+* ВНИМАНИЕ! Локаль русского языка теперь называется :'ru' а не :'ru-RU'. Не забудьте обновить ваши файлы переводов.
+
+=== 0.0.8 - 20.11.2008
+
+* Introduce transliteration (Russian.translit, Russian.transliterate)
+* Add an ActiveSupport hack for #parameterize
+
+* Добавилась поддержка транслитерации (Russian.translit, Russian.transliterate)
+* Добавился хак для #parameterize ActiveSupport (генерация "красивых" URL)
+
+=== 0.0.7 - 09.11.2008
+
+* Updated I18n gem
+
+* Новая версия gem I18n
+

data/Gemfile

@@ -0,0 +1,3 @@
+source "https://rubygems.org"
+
+gemspec

data/Gemfile.lock

@@ -0,0 +1,48 @@
+PATH
+  remote: .
+  specs:
+    rs_russian (0.7.0)
+      i18n (~> 0.6.0)
+      unicode (~> 0.4.4)
+
+GEM
+  remote: https://rubygems.org/
+  specs:
+    activesupport (4.0.0)
+      i18n (~> 0.6, >= 0.6.4)
+      minitest (~> 4.2)
+      multi_json (~> 1.3)
+      thread_safe (~> 0.1)
+      tzinfo (~> 0.3.37)
+    atomic (1.1.14)
+    atomic (1.1.14-java)
+    diff-lcs (1.2.4)
+    i18n (0.6.5)
+    minitest (4.7.5)
+    multi_json (1.8.2)
+    rake (10.1.0)
+    rspec (2.14.1)
+      rspec-core (~> 2.14.0)
+      rspec-expectations (~> 2.14.0)
+      rspec-mocks (~> 2.14.0)
+    rspec-core (2.14.6)
+    rspec-expectations (2.14.3)
+      diff-lcs (>= 1.1.3, < 2.0)
+    rspec-mocks (2.14.4)
+    thread_safe (0.1.3)
+      atomic
+    thread_safe (0.1.3-java)
+      atomic
+    tzinfo (0.3.38)
+    unicode (0.4.4)
+
+PLATFORMS
+  java
+  ruby
+
+DEPENDENCIES
+  activesupport (>= 3.0.0)
+  bundler (~> 1.3)
+  rake
+  rs_russian!
+  rspec

data/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008-2011 Yaroslav Markin
+
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of this software and associated documentation files (the
+"Software"), to deal in the Software without restriction, including
+without limitation the rights to use, copy, modify, merge, publish,
+distribute, sublicense, and/or sell copies of the Software, and to
+permit persons to whom the Software is furnished to do so, subject to
+the following conditions:
+
+The above copyright notice and this permission notice shall be
+included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
+NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
+LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
+OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
+WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

data/README.textile

@@ -0,0 +1,268 @@
+h1. rs_russian
+"!https://secure.travis-ci.org/rs-pro/russian.png!":http://travis-ci.org/rs-pro/russian
+
+h3. Это форк с вытянутыми pull-реквестами, которые мы хотели использовать.
+
+Нравится -- пользуйтесь, не нравится -- идите на страницу оригинала: "http://github.com/yaroslav/russian/":http://github.com/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 (@Russian@) with a set of helpers to provide simplistic pluralization and @strftime@ for Russian language -- in a way that is easier than using I18n methods.
+
+Feel free to shoot an email to Yaroslav Markin ("yaroslav@markin.net":mailto:yaroslav@markin.net)
+
+h1. Что это
+
+Russian -- это библиотека для полноценной поддержки русского языка (форматирование даты и времени, плюрализация, транслит, локализация в целом) для Ruby и Ruby on Rails.
+
+Цель проекта -- построить полноценную среду для русской локализации Ruby и Rails проектов, при этом используя минимально возможное количество хаков, сохраняя при этом поддержку локализации приложения на другие языки, а также форсировать включение в основную ветку I18n и Rails всех функций локализации, необходимых для работы с русским языком. Поскольку сделать в Rails поддержку довольно сложного языка для локализации (каким и является русский) сразу же было проблематично, вместе с командой @gem i18n@ решено было обкатывать решение для русского языка на отдельном gem/плагине, и по мере возможности переносить наиболее общий функционал в "родительскую" библиотеку I18n. Таким образом, общей целью @gem russian@ стала поддержка русского языка до тех пор, пока она не появится в самом 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 i18n@ "из коробки".
+
+В версии 0.2 @gem i18n@ наконец появились первые средства для поддержки русского языка: в соавторстве с вашим покорным "была добавлена поддержка lambda-переводов":http://svenfuchs.com/2009/7/12/ruby-i18n-gem-hits-0-2-0, благодаря которой стало возможным вынести логику перевода названия месяца/дня недели в таблицу переводов. Далее в @gem i18n@ появилась поддержка хранения правил плюрализации в таблице переводов (опять же, с помощью lambda-переводов) и правил транслитерации. По сути, после этого цель @gem russian@ была практически достигнута: опытные разработчики могли работать с русским языком, используя лишь собственные таблицы переводов в своем приложении и несколько хаков к Rails (по необходимости). Rails 3.0 вышел с последней версией @gem i18n@, где была уже практически полная поддержка механизмов для русского языка.
+
+Однако, документация по плюрализации и транслитерации в I18n была неочевидной, а поддержка lambda-переводов для локализации даты-времени была практически "спрятана" в исходном коде, поэтому большинство разработчиков в основном использовали самые базовые таблицы переводов: локализацию Rails и, иногда, — плюрализацию. Возникла мысль выпустить @gem russian@ для последней версии @gem i18n@ и Ruby on Rails с поддержкой всех необходимых функций, но, на этот раз, грамотно сделанных через интерфейсы I18n. К сожалению, "хаки" для Ruby on Rails (хелперы даты-времени) вряд ли когда-либо будут включены в дистрибутив Rails, поэтому использовать их придется отдельно.
+
+h1. Установка
+
+В вашем @Gemfile@ сделайте ссылку на gem @russian@:
+
+<pre><code>gem 'rs_russian', '~> 0.7.0'</code></pre>
+
+И установите gem в проект с помощью bundler:
+
+@bundle install@ или @bundle update@.
+
+Далее, укажите
+
+<pre><code>config.i18n.default_locale = :ru</code></pre>
+
+в @config/application.rb@. Если по умолчанию нужна другая локаль, или же нужно переключать локали "на ходу", используйте методы модуля 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 (@0.2.x@). Получить код и почитать инструкцию по установке можно "здесь":https://github.com/yaroslav/russian/tree/eae28e3098797d06ff0574fb1bf99238eec124fe.
+
+h1. Использование
+
+@gem russian@ можно использовать как с Ruby on Rails, так и отдельно: с любым другим веб-фреймворком, или в любом другом приложении, не имеющим никакого отношения к вебу. Дело в том, что @gem i18n@, который Ruby on Rails использует для интернационализации, включен в @gem russian@ как зависимость.
+
+При загрузке Russian подключает библиотеку I18n (либо использует уже подключенную, например, в Rails), добавляет файлы русских переводов из поставки в самое начало пути поиска переводов I18n (это значит, что любой перевод из Russian вы сможете легко переопределить в вашем приложении), добавляет в используемый по умолчанию бекенд I18n поддержку плюрализации и транслитерации, и, наконец, перегружает бекенд.
+
+Предыдущие версии Russian форсированно выставляли локаль I18n по умолчанию в @:ru@ (Русский язык), от этого решено было отказаться: в Rails стало неудобно работать с мультиязычными приложениями, так как конструкция вида @config.i18n.default_locale = :en@ не работала. Теперь для использования русского языка в Rails по умолчанию нужно использовать строку
+
+<pre><code>
+config.i18n.default_locale = :ru
+</code></pre>
+
+в @config/application.rb@. Для использования Russian отдельно от Rails можно выставить локаль I18n в русскую по умолчанию или для текущего треда, соответственно:
+
+<pre><code>
+I18n.default_locale = :ru
+
+I18n.locale = :ru
+</code></pre>
+
+Также предыдущие версии Russian заменяли используемый I18n бекенд на собственный: другого способа получить качественную локализацию для даты-времени и поддержку плюрализации не было. Новые версии I18n включают в себя поддержку @lambda {}@ в таблицах переводов ("ссылка":http://svenfuchs.com/2009/7/12/ruby-i18n-gem-hits-0-2-0), поэтому собственный бекенд больше не нужен. Обратите внимание: если вы используете бекенд, отличный от стандартного, вам потребуется включить в него поддержку плюрализации (модуль @I18n::Backend::Pluralization@) и транслитерации (@I18n::Backend::Transliterator@).
+
+Если во время загрузки Russian уже загружены библиотеки Rails, происходит загрузка хаков для Rails 3.0 и выше:
+
+1. Хелперы даты получают ключ @:use_standalone_month_names@ (для форсирования использования "отдельностоящего" названия месяца). Если ключ не указан, хелпер самостоятельно будет пытаться определить форму названия месяца: так, например, хелпер для выбора числа, месяца и года будет использовать "контекстную" форму названия месяца.
+
+2. Включается перегрузка валидации для ActiveModel: если сообщение валидации указать с "птичкой" в начале, при выводе сообщений об ошибках (@full_messages@) для этого конкретного сообщения не будет указано название атрибута, к которому он относится. Этот фукнционал нужен, скорее, для тех, кто привык использовать подобные "хаки": в Rails 3 эта задача решается с помощью ключа @full_messages.format@ в таблице переводов.
+
+Наконец, становится доступен модуль 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/datetime.rb@) указаны правила для перевода: в зависимости от формата строки @strftime@, используется контекстное или отдельностоящее название.
+
+По аналогии есть поддержка двух видов названий дней недели.
+
+_NB:_ обратите внимание на нестандартные названия ключей при перечислении месяцев и дней недели в @locale/datetime.yml@.
+_NB:_ на необычных форматах @strftime@-строк контекст может не распознаваться; просто "дробите" в таком случае строку @strftime@ на части.
+
+2. Плюрализация
+
+Включены правила плюрализации для русского языка (согласно CLDR). Их можно использовать как через интерфейс I18n, так и с помощью метода @Russian::pluralize@.
+
+3. Транслитерация
+
+Включен модуль для транслитерации русского алфавита: им можно пользоваться как через собственный интерфейс (@Russian::transliterate@), так и через интерфейс I18n.
+
+h2. Ruby on Rails
+
+h3. Переводы
+
+При использовании с Ruby on Rails загружаются все стандартные переводы, и русский язык становится годным к использованию для локализации. В поставку включены все нужные переводы для ActionView, ActiveRecord, ActiveSupport, ActiveModel, которые можно переопределять по необходимости стандартными средствами I18n из вашего приложения.
+
+h3. Хелперы
+
+Хелперы даты-времени получают ключ @:use_standalone_month_names@ для форсирования отображения отдельностоящего названия месяца ("Сентябрь" а не "сентября"). Такое имя месяца используется когда включен ключ @:use_standalone_month_names@ (для отдельностоящего @select_month@ он включается по умолчанию), либо когда есть ключ @:discard_day@.
+
+h3. Валидация
+
+На тот случай, если по каким-то причинам нельзя воспользоваться ключом @full_messages.format@ в таблице переводов, Russian перегружает вывод "полных сообщений" об ошибках в ActiveModel.
+
+Так, например,
+
+@validates_acceptance_of :accepted_terms, :message => 'нужно принять соглашение'@
+
+при валидации выдаст сообщение
+
+@Accepted terms нужно принять соглашение@
+
+или, например
+
+@Соглашение об использовании нужно принять соглашение@
+
+если вы указали перевод для имени атрибута.
+  
+Но
+
+@validates_acceptance_of :accepted_terms, :message => '^Нужно принять соглашение'@
+
+даст сообщение
+
+@Нужно принять соглашение@
+
+h3. Параметризация строк
+
+Метод @parameterize@ инфлектора ActiveSupport использует механизмы транслитерации I18n. Если русская локаль является текущей, он сможет поддерживать транслитерацию букв русского алфавита.
+
+Пример:
+
+<pre><code>
+class Person
+  def to_param
+    "#{id}-#{name.parameterize}"
+  end
+end
+
+@person = Person.find(1)
+# => #<Person id: 1, name: "Дональд Кнут">
+
+<%= link_to(@person.name, person_path(@person)) %>
+# => <a href="/person/1-donald-knut">Дональд Кнут</a>
+</code></pre>
+
+_NB:_ Для простоты иногда проще воспользоваться методом @Russian::transliterate@ напрямую (чтобы не зависеть от текущей локали).
+
+h1. Справочник
+
+h2. Примеры и справка по переводам (I18n)
+
+Небольшую справку по переводам (I18n) и пример того, как можно переводить имена моделей, атрибутов, и многие другие вещи, определенные в Rails или I18n, можно посмотреть в директории @lib/russian/locale@. Там находятся файлы переводов, которые используются в Russian, со всеми комментариями.
+
+h2. Вспомогательные методы модуля Russian
+
+<pre><code>
+Russian.locale
+Russian::LOCALE
+</code></pre>
+
+-- возвращает локаль русского языка (@:'ru'@).
+
+<pre><code>
+Russian::init_i18n
+</code></pre>
+
+-- инициализация Russian. Добавление русских переводов в путь загрузки, включение модулей для плюрализации и транслитерации и перегрузка I18n.
+
+_NB:_ Выполняется автоматически при загрузке.
+
+<pre><code>
+Russian::translate
+Russian::t
+</code></pre>
+
+-- прокси для метода @translate@ I18n, форсирует использование русской локали.
+
+<pre><code>
+Russian::localize
+Russian::l
+</code></pre>
+
+-- прокси для метода @localize@ I18n, форсирует использование русской локали.
+
+<pre><code>
+Russian::strftime
+
+Russian::strftime(Time.now)
+=> "Пн, 01 сент. 2008, 11:12:43 +0300"
+Russian::strftime(Time.now, "%d %B")
+>> "01 сентября"
+Russian::strftime(Time.now, "%B")
+=> "Сентябрь"
+</code></pre>
+
+-- @strftime@ с форсированием русской локали (упрощенный вариант @localize@)
+
+<pre><code>
+Russian::pluralize
+Russian::p
+
+Russian.p(1, "вещь", "вещи", "вещей")
+=> "вещь"
+Russian.p(2, "вещь", "вещи", "вещей")
+=> "вещи"
+Russian.p(10, "вещь", "вещи", "вещей")
+=> "вещей"
+Russian.p(3.14, "вещь", "вещи", "вещей", "вещи") # последний вариант используется для дробных величин
+=> "вещи"
+</code></pre>
+
+-- упрощенная (без использования хешей I18n) плюрализация для русского языка
+
+<pre><code>
+Russian::transliterate
+Russian::translit
+
+Russian.translit("рубин")
+=> "rubin"
+Russian.translit("Hallo Юлику Тарханову")
+=> "Hallo Yuliku Tarhanovu"
+</code></pre>
+
+-- транслитерация русских букв в строке.
+
+h1. Авторы
+
+Для сообщений об ошибках, обнаруженных неточностях и предложений:
+
+* "Ярослав Маркин":http://yaroslav.markin.net ("yaroslav@markin.net":mailto:yaroslav@markin.net)
+
+При участии:
+
+* "Юлика Тарханова":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/

data/Rakefile

@@ -0,0 +1,12 @@
+require 'bundler/setup'
+Bundler::GemHelper.install_tasks
+
+require 'rspec/core/rake_task'
+
+desc "Run all examples"
+RSpec::Core::RakeTask.new(:spec) do |t|
+  #t.rspec_path = 'bin/rspec'
+  t.rspec_opts = %w[--color]
+end
+
+task :default => :spec

data/TODO

@@ -0,0 +1,4 @@
+TODO
+====
+* RDoc
+

data/lib/rs_russian.rb

@@ -0,0 +1 @@
+require 'russian'