krasivotokak-russian 0.2.1

data/CHANGELOG

@@ -0,0 +1,64 @@
+=== master
+
+* transliteration: Ы now transforms to Y [Alex Fortuna]
+
+* транслитерация: Ы теперь превращается в 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/LICENSE

@@ -0,0 +1,20 @@
+Copyright (c) 2008 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,288 @@
+h1. 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 to create custom backends for I18n and how to provide support of "standalone" (as defined in "Unicode CLDR":http://unicode.org/cldr/) month names with I18n and Rails, and also how to add dead simple pluralization rules into your translation tables. 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 всех функций локализации, необходимых для работы с русским языком.
+
+Russian использует библиотеку I18n (включена в поставку), несколько хаков поверх нее (собственный бекэнд с поддержкой специфичного для русского форматирования даты и времени, поддержкой плюрализации), несколько хаков поверх Rails (хаки хелперов даты-времени, хак для сообщений валидации) и файлы переводов, а также набор хелперов, упрощающий работу с русским языком (простая плюрализация, простой strftime и др.).
+
+Russian стремится быть минимально деструктивной для окружения и быть полностью совместимой с другими языками (таким образом, когда приложение использует Russian и собственный бекэнд Russian, оно остается полностью совместимым с Rails i18n). 
+
+h2. Что такое I18n
+
+Библиотека I18n входит в состав Ruby on Rails начиная с версии 2.2. В перспективе I18n -- это самое простое и недеструктивное решение для локализации и интернационализации Rails приложений, но в текущей версии отсутствовала поддержка нескольких важных возможностей, специфичных для русского языка. Таким образом, русский язык для локализации в Rails 2.2 фактически не поддерживался.
+
+Для исправления этого досадного недоразумения появилась библиотека Russian (подробнее см. _Использование_).
+
+h1. Требования
+
+* Ruby 1.8 (тестировалось на 1.8.6);
+* Для использования с Rails нужна версия не ниже 2.2;
+* Для тестирования библиотеки вам понадобится RSpec.
+
+h1. Установка
+
+Страница Russian на github -- "http://github.com/yaroslav/russian/":http://github.com/yaroslav/russian/
+
+Russian можно установить как gem с github. Для этого:
+
+1. Нужно добавить репозиторий gem'ов github в качестве источника
+
+@gem sources -a http://gems.github.com@
+
+2. Установить gem
+
+@gem install yaroslav-russian@
+
+
+_NB:_ Gem @russian@ также зеркалируется на RubyForge, поэтому его можно установить командой 
+
+@gem install russian@.
+
+h2. Ruby on Rails
+
+Существует два варианта использования Russian вместе с Rails:
+
+1. Установка gem
+
+В файле @config/environment.rb@ сделайте ссылку на gem @yaroslav-russian@ с github:
+
+<pre><code>
+Rails::Initializer.run do |config|
+  config.gem 'yaroslav-russian', :lib => 'russian', :source => 'http://gems.github.com'
+end
+</code></pre>
+
+Чтобы установить gem, используйте команду 
+
+@rake gems:install@.
+
+2. Установка плагина
+
+Для того, чтобы установить Russian как плагин к Rails, используйте команду
+
+@script/plugin install git://github.com/yaroslav/russian.git@
+
+Для Windows можно использовать версию git, расположенную по адресу: "http://code.google.com/p/msysgit/":http://code.google.com/p/msysgit/
+
+h1. Использование
+
+При загрузке Russian включает:
+
+* библиотеку I18n если она еще не используется (например, если Russian используется отдельно от Rails)
+* собственный класс для I18n бекэнда (полностью совместим со стандартным бекэндом)
+* перегрузку хелперов даты для Rails (если Rails загружен)
+* пререгрузку обработки сообщений валидации для ActiveRecord (если Rails загружен)
+
+При инициализации:
+
+* заменяется бэкэнд I18n со стандартного на собственный бекэнд Russian (@I18n::Backend::Advanced@)
+* _NB:_ локаль русского языка (@:'ru'@) становится локалью по умолчанию
+* загружаются все файлы переводов, в том числе переводы для Rails.
+
+После этого можно использовать все стандартные функции библиотеки I18n, пользоваться измененным функционалом для лучшей поддержки русского языка, или использовать хелперы модуля Russian для еще более простой работы с русским языком.
+
+h2. Отличия от стандартной библиотеки I18n
+
+1. Поддержка двух видов названий месяцев -- контекст ("сентября") и отдельностоящее ("Сентябрь").
+
+Для этого перегружена функция локализации, теперь название месяца используется в зависимости от контекста. В словарях Russian определены оба варианта.
+
+Перегрузка недеструктивная: если для какого-то другого языка не определены два варианта названий месяцев, ошибки не возникнет.
+
+Аналогично есть поддержка двух видов названий дней недели.
+
+2. Плюрализация
+
+Стандартно I18n поддерживается только плюрализация по английским правилам; бекэнд, использующийся в Russian, позволяет каждому языку определять правила плюрализации в таблице переводов, задавая их как @Proc@.
+
+Перегрузка недеструктивная: если правила в таблице нет, используется правило по умолчанию (английский язык).
+
+Правила для русского языка включены.
+
+h1. Справочник
+
+h2. Примеры и справка по переводам (I18n)
+
+Небольшую справку по переводам (I18n) и пример того, как можно переводить имена моделей, атрибутов, и многие другие вещи, определенные в Rails или I18n, можно посмотреть в директории @lib/russian/locale@. Там находятся файлы переводов, которые используются в Russian, со всеми комментариями.
+
+h2. Вспомогательные методы модуля Russian
+
+<pre><code>
+Russian.locale
+Russian::LOCALE
+</code></pre>
+
+-- возвращает локаль русского языка (@:'ru'@).
+
+<pre><code>
+Russian::i18n_backend_class
+</code></pre>
+
+-- возвращает класс собственного бекенда I18n
+
+<pre><code>
+Russian::init_i18n
+</code></pre>
+
+-- инициализация Russian. Включение бекэнда, русский язык по умолчанию, загрузка переводов. 
+
+_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, "%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>
+
+-- транслитерация русских букв в строке.
+
+
+h2. Ruby on Rails
+
+h3. Переводы
+
+При использовании с Ruby on Rails загружаются все стандартные переводы, и русский язык становится годным к использованию для локализации. В поставку включены все нужные переводы для ActionView, ActiveRecord, ActiveSupport, которые можно переопределять по необходимости стандартными средствами I18n.
+
+h3. Хелперы
+
+Хелперы даты-времени получают ключ @:use_standalone_month_names@ для форсирования отображения отдельностоящего названия месяца ("Сентябрь" а не "сентября"). Такое имя месяца используется когда включен ключ @:use_standalone_month_names@ (для отдельностоящего @select_month@ он включается по умолчанию), либо когда есть ключ @:discard_day@.
+
+В Russian включен плагин i18n_label, который подставляет в форм-хелпер @label@ перевод атрибута из таблицы переводов I18n. Например:
+
+* в файле переводов:
+
+<pre><code>
+ru:
+  activerecord:
+    attributes:
+      user:
+        name: "Имя"
+</code></pre>
+
+* во view:
+
+<pre><code>
+<% form_for @user do |f| %>
+  <%= f.label :name %>
+<% end %>
+</code></pre>
+
+Даст:
+
+<pre><code>
+<label for="user_name">Имя</label>
+</code></pre>
+
+h3. Валидация
+
+Обработка ошибок в ActiveRecord перегружается -- в Russian включен популярный плагин custom_error_message, с помощью которого можно переопределять стандартное отображение сообщений об ошибках. Так, например,
+
+@validates_acceptance_of :accepted_terms, :message => 'нужно принять соглашение'@
+
+даст сообщение
+
+@Accepted terms нужно принять соглашение@
+
+или, например
+
+@Соглашение об использовании нужно принять соглашение@
+
+если вы указали перевод для имени атрибута.
+  
+Но
+
+@validates_acceptance_of :accepted_terms, :message => '^Нужно принять соглашение'@
+
+даст сообщение
+
+@Нужно принять соглашение@
+
+_NB:_ в сообщениях валидации можно использовать такие макросы как @{{attribute}}@, @{{value}}@ -- подробнее см. документацию по I18n.
+
+h3. Параметризация строк
+
+Перегружается метод @parameterize@ инфлектора ActiveSupport (он же -- @String#parameterize@), теперь в нем идет транслитерация букв русского алфавита.
+
+Пример:
+
+<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>
+
+h1. Автор
+
+Для сообщений об ошибках, обнаруженных неточностях и предложений:
+
+Ярослав Маркин ("yaroslav@markin.net":mailto:yaroslav@markin.net)
+
+Огромное спасибо:
+
+Юлику Тарханову (me@julik.nl) за "rutils":http://rutils.rubyforge.org/

data/Rakefile

@@ -0,0 +1,55 @@
+require 'rubygems'
+require 'rake/gempackagetask'
+require 'spec/rake/spectask'
+require 'rubygems/specification'
+require 'date'
+
+GEM = "russian"
+GEM_VERSION = "0.2.0"
+AUTHOR = "Yaroslav Markin"
+EMAIL = "yaroslav@markin.net"
+HOMEPAGE = "http://github.com/yaroslav/russian/"
+SUMMARY = "Russian language support for Ruby and Rails"
+
+spec = Gem::Specification.new do |s|
+  s.name = GEM
+  s.version = GEM_VERSION
+  s.platform = Gem::Platform::RUBY
+  s.has_rdoc = true
+  s.extra_rdoc_files = ["README.textile", "LICENSE", "CHANGELOG", "TODO"]
+  s.summary = SUMMARY
+  s.description = s.summary
+  s.author = AUTHOR
+  s.email = EMAIL
+  s.homepage = HOMEPAGE
+  
+  # Uncomment this to add a dependency
+  # s.add_dependency "foo"
+  
+  s.require_path = 'lib'
+  s.autorequire = GEM
+  s.files = %w(LICENSE README.textile Rakefile CHANGELOG TODO init.rb) + Dir.glob("{lib,spec}/**/*")
+end
+
+Rake::GemPackageTask.new(spec) do |pkg|
+  pkg.gem_spec = spec
+end
+
+task :default => :spec
+desc "Run specs"
+Spec::Rake::SpecTask.new do |t|
+  t.spec_files = FileList['spec/**/*_spec.rb']
+  t.spec_opts = %w(-fs --color)
+end
+
+desc "install the gem locally"
+task :install => [:package] do
+  sh %{sudo gem install pkg/#{GEM}-#{GEM_VERSION}}
+end
+
+desc "create a gemspec file"
+task :make_spec do
+  File.open("#{GEM}.gemspec", "w") do |file|
+    file.puts spec.to_ruby
+  end
+end

data/TODO

@@ -0,0 +1,10 @@
+TODO
+====
+* RDoc
+* check Unicode CLDR to ensure all datetime formats are correct
+* refactor Advanced backend localize method (looks ugly)
+* refactor DateTimeSelector#translated_month_names
+
+Questionable
+============
+* integration specs for rails hacks

data/init.rb

@@ -0,0 +1,3 @@
+# Rails plugin init
+require 'russian'
+

data/lib/russian.rb

@@ -0,0 +1,119 @@
+# -*- encoding: utf-8 -*- 
+
+if RUBY_VERSION < "1.9"
+  $KCODE = 'u'
+end
+
+$:.push File.join(File.dirname(__FILE__), 'russian')
+require 'transliteration'
+
+# I18n require
+unless defined?(I18n)
+  $:.push File.join(File.dirname(__FILE__), 'vendor', 'i18n', 'lib')
+  require 'i18n'
+end
+# Advanced backend
+require 'backend/advanced'
+
+# Rails hacks
+require 'active_record_ext/custom_error_message' if defined?(ActiveRecord)
+if defined?(ActionView::Helpers)
+  require 'action_view_ext/helpers/date_helper' 
+  require 'vendor/i18n_label/init'
+end
+require 'active_support_ext/parameterize' if defined?(ActiveSupport::Inflector)
+
+module Russian
+  extend self
+  
+  module VERSION
+    MAJOR = 0
+    MINOR = 2
+    TINY  = 0
+
+    STRING = [MAJOR, MINOR, TINY].join('.')
+  end
+  
+  # Russian locale
+  LOCALE = :'ru'
+
+  # Russian locale
+  def locale
+    LOCALE
+  end
+  
+  # Returns custom backend class for usage with Russian library
+  # 
+  # See I18n::Backend
+  def i18n_backend_class
+    I18n::Backend::Advanced
+  end
+  
+  # Init Russian i18n: set custom backend, set default locale to Russian locale, load all translations
+  # shipped with library.
+  def init_i18n
+    I18n.backend = Russian.i18n_backend_class.new
+    I18n.default_locale = LOCALE
+    I18n.load_path.unshift(*locale_files)
+  end
+
+  # See I18n::translate
+  def translate(key, options = {})
+    I18n.translate(key, options.merge({ :locale => LOCALE }))
+  end        
+  alias :t :translate
+  
+  # See I18n::localize
+  def localize(object, options = {})
+    I18n.localize(object, options.merge({ :locale => LOCALE }))
+  end
+  alias :l :localize
+  
+  # strftime() proxy with Russian localization
+  def strftime(object, format = :default)
+    localize(object, { :format => format })
+  end
+  
+  # Simple pluralization proxy
+  #
+  # Usage: 
+  #   Russian.pluralize(1, "вещь", "вещи", "вещей")
+  #   Russian.pluralize(3.14, "вещь", "вещи", "вещей", "вещи")
+  def pluralize(n, *variants)
+    raise ArgumentError, "Must have a Numeric as a first parameter" unless n.is_a?(Numeric)
+    raise ArgumentError, "Must have at least 3 variants for pluralization" if variants.size < 3
+    raise ArgumentError, "Must have at least 4 variants for pluralization" if (variants.size < 4 && n != n.round)
+    variants_hash = pluralization_variants_to_hash(*variants)
+    I18n.backend.send(:pluralize, LOCALE, variants_hash, n)
+  end
+  alias :p :pluralize
+
+  # Transliteration for russian language
+  #
+  # Usage:
+  #  Russian.translit("рубин")
+  #  Russian.transliterate("рубин")
+  def transliterate(str)
+    Russian::Transliteration.transliterate(str)
+  end
+  alias :translit :transliterate
+  
+  protected
+    # Returns all locale files shipped with library
+    def locale_files
+      Dir[File.join(File.dirname(__FILE__), "russian", "locale", "**/*")]
+    end
+    
+    # Converts an array of pluralization variants to a Hash that can be used
+    # with I18n pluralization.
+    def pluralization_variants_to_hash(*variants)
+      {
+        :one => variants[0],
+        :few => variants[1],
+        :many => variants[2],
+        :other => variants[3]
+      }
+    end
+end
+
+Russian.init_i18n