rotuka-rutils 0.2.4

data/CHANGELOG

@@ -0,0 +1,110 @@
+* До свидания, <nobr>. Указывайте .nobr { text-wrap: nowrap } в своих стилевых таблицах.
+
+Версия 0.2.3 - 27.09.2007
+* Кошмар - в новой версии rubygems изменилась семантика s.files из-за чего мы забыли
+  все файлы в корневой директории - включая init.rb (julik)
+
+Версия 0.2.2 - 24.09.2007
+* Gilenson - обрабатываем акронимы по принципу Textile (zajats, julik)
+* Gilenson - отформатирован под 2 пробела (julik)
+* В тестах пользуйтесь assert_equal_cp (julik)
+* Welcome to subversion (julik)
+
+Версия 0.2.1 - 02.04.2007
+* Восстановлен в gemspec gilenson.rb (Сергей Барабаш)
+
+Версия 0.2.0 - 02.04.2007
+* Фикс squeeze в dirify (Сергей Барабаш)
+* Формат даты по умолчанию - %F (Сергей Барабаш)
+
+Версия 0.1.9 - 17.02.2007
+* Gilenson integration - не съедаем пробелы между тегами при прогоне текста через Textile 
+
+Версия 0.1.8 - 05.02.2007
+* Gilenson - расстановка инициалов не должна цеплять аббревиатуры (julik) 
+
+Версия 0.1.7 - 05.02.2007
+* Date helpers приведены в более веселый вид (и в соответствие с Rails 1.2.1) (julik)
+* date_helper надо поменять чтобы передавать рельсовому хелперу весь массив options в хеше (julik)
+
+Версия 0.1.6 - 18.08.2006
+* Удалили jcode, он нам не сильно нужен (julik)
+* В простом транслите Шипилов - Schipilov вместо SCHipilov (julik)
+* Тесты интеграции валятся явно и громко если зависимые модули на машине отсутствуют (julik)
+* Масса крошечных твиков чтобы сделать все немножко аккуратнее (julik)
+* Родительный падеж (RU_INFLECTED_MONTHNAMES) для месяцев после числа (%d %B == 31 декабря) в strftime (mash)
+
+Версия 0.1.5 - 08.05.2006
+* Транслитераторы вынесены в отдельные файлы (julik)
+* Починен баг с передачей часа в нужном падеже в distance_of_time (anonyomous)
+* Добавлены корректные методы публикации доков, сменены параметры их генерации (julik)
+* cp -r заменен на cp_r чтобы rutilize работал в Windows (anonymous)
+* Имена месяцев со строчной буквы (sgt - http://rubyforge.org/users/sgt)
+* Поддерживаем оба класса Locale (из ruby-locale и gettext - они немного отличаются по семантике)  (julik)
+
+
+Версия 0.1.4 - 02.12.2005
+* Поправлен импорт Rails-плагина (julik)
+* Поправлен паттерн сбора тестируемых файлов (julik)
+* Gilenson - на Oniguruma сбоит skip_code, но это надо побарывать нормальным токенизатором, пока откладывается (julik)
+* Gilenson - в тестах произведена замена <cOdE> на <code> и <TT> на <tt> (mash)
+* Gilenson - в двух регулярных выражениях (в "def process_quotes") изменен #{@mark_tag} на
+  \#{@mark_tag} чтобы предотвратить segfault ruby 1.8.2 (2004-12-25) на [i386-mswin32]  (mash)
+* Gilenson - починен дикий баг с маркером в одинарных кавычках - теперь таки последовательность байтов вместо символов (julik)
+* DateTime - RU_INFLECTED_MONTHNAMES => Авгуса --> Августа (mash)
+
+Версия 0.1.3 - 14.11.2005
+* Gilenson - замена троеточий на ellipsis (julik)
+* Gilenson - теперь пробел, идущий перед одной или двумя буквами на конце слова
+  меняется на glyph[:nbsp]. (mash)
+* Gilenson - починен баг из-за которого не типографилась закрывающая кавычка после вопросительного
+  и восклицательного знака (julik)
+* По умолчанию используется новый Gilenson (Gilenson::Formatter). Старый доступен как Gilenson::Obsolete и через
+  String#o_gilensize и грузится только в случае необходимости. Если у вас были тесты провеяющие gilensize
+  скорее всего они "полетели" (julik)
+* Gilenson - дополнительная фича, не связанная с типографикой: замена амперсанда в следующих атрибутах
+  тагов: href, src, data. Пример: <a href="?x=1&y=2&#38;z=3"> => <a href="?x=1&#38;y=2&#38;z=3"> (mash)
+* Gilenson - изменён метод process_ampersands (стало process_escape_html), меняющий &,<,> на глифы :amp,:lt,:gt
+  при запрете HTML (@settings[:html]=>false). По-умолчанию Гиленсон разрешает использование HTML.
+  В иерархии метод выставлен первым для корректной обработки случаев вида
+  %{Используйте &#38; вместо &amp;}.gilensize(:html=>false) (mash)
+* Gilenson - добавлены :skip_attr=>false и :skip_code=>true для управления обработкой типографики атрибутов тегов title, alt и содержимого <code/>, <tt/>, <![CDATA[...]]> (mash)
+* Gilenson - добавлен :raw_output=>true для вывода обычных UTF-8 chars вместо entities (julik)
+* Смена структуры модулей Gilenson (julik)
+    RuTils::Gilenson::Obsolete - старый класс форматтера
+    RuTils::Gilenson::Formatter - новый класс форматтера
+    При вызове RuTils::Gilenson.new возвращается новый Formatter
+* Gilenson - документация (julik)
+* Gilenson - основные группы настроек "по-умолчанию" выносятся в константы (julik)
+* Gilenson - фильтры выносятся в методы типа process_фильтр и их можно применять по отдельности через Formatter#apply (julik)
+* Gilenson - добавлены &para; и &numero; (последний - не стандарт, но нужен для преобразований символа "номер") (mash)
+* Gilenson - добавлен хэш @glyph_copy_paste для подмены юникодных типографских символов на entities
+  (опционально, через @settings[:copypaste]=>true) (mash)
+* Gilenson - добавлена "склейка" инициалов полукруглой шпацией (thin space)
+* Gilenson - добавлен Formatter#process чтобы обрабатывать строки поточно, и сделан удобный доступ к настройкам
+  через "хвост" метода (julik)
+* Во всех внутренних строковых подстановках Gilenson используются указатели на глифы с двоеточием в начале (julik)
+* Gilenson - введен DOUBLE PRIME (&#8243;) для знаков дюйма (julik) 
+    http://en.wikipedia.org/wiki/Prime_%28mark%29
+    Согласно изощренным правилам скошенный prime правильней чем "
+* Новый Гиленсон lib/gilenson/gilenson.rb (mash)
+    RuTils::GilensonNew::Typografica.new('какой-то текст')
+    %q{"какой-то текст"}.n_gilensize
+* Код приведён к "2 spaces - no tabs", частично полетели дифы (mash)
+* Изменены константы дат, используемые в lib/integration/rails_date_helper_override.rb:
+    Было: RuTils::DateTime::ABBR_MONTHNAMES, RuTils::DateTime::INFLECTED_MONTHNAMES
+    Стало: Date::RU_ABBR_MONTHNAMES, Date::RU_INFLECTED_MONTHNAMES (mash)
+* Добавлена функциия Numeric#rublej (julik)
+* Добавлена русская версия Time#ru_strftime и Date#ru_strftime (mash)
+
+Версия 0.1.2 - 01.11.2005
+* Добавлен BiDi-транслит c тестами (mash)
+
+Версия 0.04 - 20.10.2005
+* Чистка документации
+
+Версия 0.03 - 18.10.2005
+* Легкий рефакторинг и чистка документации, добавлена реализация BiDi-транслита
+
+Версия 0.02 - 12.07.2005
+* Заменен маркер подстановки тегов в Gilenson. Ранее без oniguruma из-за его применения "проглатывалась" буква "р"

data/README

@@ -0,0 +1,202 @@
+== Добро пожаловать в RuTils
+
+RuTils - простой обработчик русского текста на Ruby. Основная цель RuTils -
+сделать разработку русскоязычных приложений на Ruby (и Rails) максимально простой
+и приятной (в идеале - столь же простой как и разработку оных на английском)
+
+Весь функционал RuTils поддерживает только UTF-8 (настройка $KCODE / KanjiCode
+'u').
+
+Пожалуйста упоминайте версию при сообщении ошибок. Версию RUTILS всегда можно
+узнать в константе
+
+ RuTils::VERSION
+
+Удостоверьтесь, что ваш скрипт правильно обрабатывает Unicode - то есть:
+
+* Переменная $KCODE включена в режим 'u' 
+* Все строки которые вы собираетесь обрабатывать уже в кодировке UTF-8
+
+Если вы используете RuTils для сайта под mod_ruby воспользуйтесь директивой
+RubyKanjiCode в своем httpd.conf.
+
+Большое спасибо Роману Иванову aka Kukutz и Николаю Яремко aka Kuso Mendokuzee за
+реализацию большинства алгоритмов на PHP.
+
+Разработку RuTils ведут Julik[http://julik.nl] и Mash[http://imfo.ru]
+
+== Cумма прописью и выбор числительного
+
+RuTils реализует сумму прописью для целых и дробных чисел, с дополнительным
+учетом рода. Например:
+
+  4.propisju => "четыре"
+  345.propisju => "триста сорок пять"
+  231.propisju(2) => "двести тридцать одна"
+  341.propisju_items(1, "чемодан", "чемодана", "чемоданов") => "триста сорок один чемодан"
+  (212.40).propisju_items(2, "сволочь", "сволочи", "сволочей") => "двести двенадцать целых
+      четыре десятых сволочи"
+
+Также реализуется выбор варианта числительного в зависимости от числа
+
+ 15.items("кодер", "кодера", "кодеров") => "кодеров"
+
+и вывод "суммы прописью" для денежных сумм в рублях
+
+ (413.2).rublej => "четыреста тринадцать рублей двадцать копеек"
+
+== Транслит
+
+RuTils на данный момент реализует простейший транслит "в одну сторону" и
+"взаимно-однозначный транслит" (BiDi-транслит).
+
+Простейший транслит "в одну сторону".
+
+ "Вот такое вот дело".translify => "Vot takoye vot delo" "Несомненный прогресс по
+сравнению с PHP".dirify => "nesomnennyi-progress-po-sravneniu-s-php"
+
+== BiDi-транслит
+
+Порт BiDiTranslit[http://pixel-apes.com/translit/article#h256-10] от Pixel Apes.
+Реализует транслитерацию "в обе стороны", предоставляя возможность получить
+валидный URL из строки, содержащей русские и английские буквы. С некоторыми
+потерями (запятых и прочих "слабозначащих" символов) возможно восстановление
+исходной строки.
+
+Два режима работы:
+
+* Уничтожение всех слешей, которые встретятся во входной строке. В этом случае
+методы вызываются с передачей в них false. Например,
+"Web/Скрипты".bidi_translify(false) * Пропуск слэшей (используется по умолчанию).
+Например, "Web/+Skripty".bidi_detranslify
+
+ "WebРазработка/Скрипты".bidi_translify => "Web+Razrabotka+/+Skripty"
+"+Ustanovka__+mod_perl".bidi_detranslify => "Установка mod_perl"
+"WebРазработка/Мимо".bidi_translify(false) => "Web+RazrabotkaMimo"
+"+PKHP+/Scripts".bidi_detranslify(false) => "ПХПScripts"
+
+== Обработка русской типографики в HTML
+
+Gilenson - порт Typografica[http://pixel-apes.com/typografica] от Pixel Apes.
+Тыпографица - механизм автоматической расстановки подстановок в тексте перед его
+выводом в HTML, оформляющий неразрывные пробелы, типографские кавычки и тому
+подобные "украшательства".
+
+Gilenson расставит в тексте "умные" правильные кавычки (русские - для кириллицы,
+английские - для латиницы), заменит "хитрые" пунктуационные символы на entities и
+отформатирует знаки типа (c), (tm), телефоны и адреса.
+
+ %q{"И это называется языком?", -- таков был его вопрос}.gilensize => "«И
+ это называется языком?», — таков был его вопрос"
+
+Более подробная документация по Gilenson доступна в документах к
+RuTils::Gilenson::Formatter
+
+В комплекте также есть скрипт gilensize, которым можно поточно обрабатывать
+Unicode-тексты в среде UNIX пользуясь стандартным выводом
+
+ $ cat myfile.txt | gilensize > myfile.html
+
+== Даты
+
+В класс Date введены следующие константы:
+
+* RU_MONTHNAMES (Январь Февраль Март...)
+* RU_DAYNAMES (Воскресенье Понедельник...)
+* RU_ABBR_MONTHNAMES (Янв Фев Мар...)
+* RU_ABBR_DAYNAMES (Вск Пн Вт Ср...)
+* RU_INFLECTED_MONTHNAMES (Января Февраля Марта...)
+* RU_DAYNAMES_E (первое второе третье...)
+
+Пример использования:
+
+  require 'date' date = Date.new(2005, 11, 9)
+  puts "#{Date::RU_ABBR_MONTHNAMES[date.mon]}" => Ноя puts
+  puts "#{Date::RU_MONTHNAMES[date.mon]}" => Ноябрь
+  puts "#{Date::RU_ABBR_DAYNAMES[date.wday]}" => Ср
+  puts "#{Date::RU_DAYNAMES[date.wday]}" => Среда
+
+При включенной перезагрузке функций (RuTils::overrides_enabled) осуществляется
+"покрытие" стандартной функции Time#strftime ("родную" #strftime можно продолжать
+использовать через alias-метод #strftime_norutils):
+
+  Time.local(2005,"dec",31).strftime("%a, %A, %b, %B") => "Сб, Суббота, Дек, Декабрь" 
+  Time.local(2005,"dec",31).strftime_norutils("%a, %A, %b, %B") => "Sat, Saturday, Dec, December"
+
+== Интеграция с Rails, RedCloth и BlueCloth
+
+RuTils в первую очередь задумывался как максимально "прозрачный" механизм
+обработки русского текста в контексте Rails-приложения. В связи с этим RuTils
+"вторгается" в работу других Ruby-модулей и изменяет механизм их работы.
+
+Если вы используете RuTils в одном приложении с RedCloth или BlueCloth, RuTils
+автоматически будет обрабатывать типографику во всех текстах, пропускаемых через
+них. Имейте в виду, что для корректной работы этой функции RuTils надо загружать
+*после* модулей RedCloth и BlueCloth.
+
+Помимо этого RuTils заставляет следующие функции Rails говорить по-русски:
+
+* Меню выбора даты (+date_select+ и +datetime_select+) 
+  будут выводиться с русскими именами месяцев
+* +distance_of_time_in_words+ будет выводить 
+  русские описания длительности ("более 2 часов")
+
+Перегрузку всех функций других модулей можно включать и отключать в любое время с
+помощью метода RuTils::overrides=. Когда перегрузка выключена, все сторонние
+библиотеки будут работать в стандартном режиме (например, RedCloth будет
+расставлять английские типографские кавычки). Это нужно когда вам нужно
+переключиться на английский (или любой другой язык) без перезапуска приложения.
+
+Если вы хотите использовать rutils как дополнение к Rails в одном конкретном
+приложении, скопируйте директорию rutils в папку vendor/plugins вашего
+приложения. Вы можете воспользоваться командой rutilize чтобы сделать это
+автоматически. После этого вы сможете использовать RuTils без необходимости
+установки gem  на вашем сервере (не забудьте перезапустить приложение чтобы
+вгрузить в него RuTils).
+
+ $ rutilize /Sites/my_app1 /Sites/my_app2 /Sites/my_another_app
+
+Вы можете свободно распространять RuTils со своим Rails-приложением при условии
+сохранения структуры и файла README.
+
+== Требования
+
+* Ruby 1.8.2, немного прямых рук. 
+* Rake[http://rake.rubyforge.org],
+
+Rails[http://rubyonrails.org],
+RedCloth[http://www.whytheluckystiff.net/ruby/redcloth/] и
+BlueCloth[http://www.deveiate.org/projects/BlueCloth] для выполнения тестов
+
+== Как использовать
+
+Просто включите rutils в свою программу как библиотеку
+
+  require 'rutils'
+
+== Где получить помощь
+
+На странице проекта на RubyForge[http://rubyforge.org/projects/rutils]
+
+== Работает ли это с текстом в кодировке Windows-1251
+
+Нет и никогда не будет.
+
+== Как ускорить реализацию новых функций
+
+Воспользуйтесь трекером на RubyForge. Опишите нужный вам функционал и приложите
+тесты, которым этот функционал должен удовлетворять. Схему организации тестов вы
+можете скопировать из собственных тестов RuTils.
+
+Если вы пишете исходный код, который войдет в RuTils или в тестовые наборы,
+пожалуйста следуйте следующим правилам оформления кода:
+
+* Unix line breaks (LF)
+* Кодировка файлов - строго UTF-8 без BOM (Byte Order Mark)
+* Отступы в 2 пробела, без табуляций.
+* Однострочные блоки с фигурными скобками, многострочные - с +do ... end+
+* Все другие конвенции нормального написания 
+  Ruby-кода (http://www.rubygarden.org/ruby/ruby?RubyStyleGuide)
+
+Если вы хотите участвовать в разработке RuTils пользуйтесь версией из subversion
+trunk.

data/Rakefile.rb

@@ -0,0 +1,128 @@
+require 'rubygems'
+require 'rake'
+require 'rake/testtask'
+require 'rake/rdoctask'
+require 'rake/packagetask'
+require 'rake/gempackagetask'
+require 'rake/contrib/rubyforgepublisher'
+require 'fileutils'
+require 'lib/rutils'
+
+begin
+  require 'xforge'
+rescue LoadError
+end
+
+PKG_BUILD     = ENV['PKG_BUILD'] ? '.' + ENV['PKG_BUILD'] : ''
+PKG_NAME      = 'rutils'
+PKG_VERSION   = RuTils::VERSION
+PKG_FILE_NAME   = "#{PKG_NAME}-#{PKG_VERSION}"
+PKG_DESTINATION = "../#{PKG_NAME}"
+PKG_SUMMARY	= %q{ Simple processing of russian strings }
+PKG_DESCRIPTION = %q{ Allows simple processing of russian strings - transliteration, numerals as text and HTML beautification }
+PKG_HOMEPAGE = 'http://rubyforge.org/projects/rutils'
+PKG_EMAIL = 'me@julik.nl'
+PKG_MAINTAINER = 'Julian "Julik" Tarkhanov'
+
+RELEASE_NAME  = "rutils-#{PKG_VERSION}"
+
+RUBY_FORGE_PROJECT = "rutils"
+RUBY_FORGE_USER    = ENV['RUBY_FORGE_USER'] ? ENV['RUBY_FORGE_USER'] : "julik"
+
+# нам нужна документация в Юникоде. А вы думали?
+PKG_RDOC_OPTS = ['--main=README',
+                 '--line-numbers',
+                 '--webcvs=http://rubyforge.org/cgi-bin/viewcvs.cgi/rutils/%s?cvsroot=rutils',
+                 '--charset=utf-8',
+                 '--promiscuous']
+
+task :default => [ :test ]
+
+desc "Run all tests (requires BlueCloth, RedCloth and Rails for integration tests)"
+Rake::TestTask.new("test") { |t|
+  t.libs << "test"
+  t.pattern = 'test/t_*.rb'
+  t.verbose = true
+}
+
+desc "Report KLOCs"
+task :stats  do
+  require 'code_statistics'
+  CodeStatistics.new(
+    ["Libraries", "lib"], 
+    ["Units", "test"]
+  ).to_s
+end
+
+desc "Generate RDoc documentation"
+Rake::RDocTask.new("doc") do |rdoc|
+  rdoc.rdoc_dir = 'doc'
+  rdoc.title  = PKG_SUMMARY
+  rdoc.rdoc_files.include('README')
+  rdoc.rdoc_files.include('CHANGELOG')
+  rdoc.rdoc_files.include('TODO')
+  rdoc.options = PKG_RDOC_OPTS
+  rdoc.rdoc_files.include FileList['lib/*.rb', 'lib/**/*.rb']
+end
+
+spec = Gem::Specification.new do |s|
+  s.platform = Gem::Platform::RUBY
+  s.name = PKG_NAME
+  s.summary = PKG_SUMMARY
+  s.description = PKG_DESCRIPTION
+  s.version = PKG_VERSION
+
+  s.author = PKG_MAINTAINER
+  s.email = PKG_EMAIL
+  s.rubyforge_project = RUBY_FORGE_PROJECT
+  s.homepage = PKG_HOMEPAGE
+
+  s.has_rdoc = true
+  s.files  = FileList["{bin,test,lib}/**/*"].exclude("rdoc").exclude(".svn").exclude(".CVS").exclude(".DS_Store").to_a +
+	  %w(CHANGELOG init.rb Rakefile.rb README TODO)
+	s.require_path = "lib"
+	s.autorequire = "rutils"
+	s.test_file = "test/run_tests.rb"
+	s.has_rdoc = true
+	s.extra_rdoc_files = ["README", "TODO", "CHANGELOG"]
+	s.rdoc_options = PKG_RDOC_OPTS
+	s.executables << 'gilensize'
+	s.executables << 'rutilize'
+end
+
+Rake::GemPackageTask.new(spec) do |p|
+  p.gem_spec = spec
+  p.need_tar = true
+  p.need_zip = true
+end
+
+
+desc "Remove packaging products (doc and pkg) - they are not source-managed"
+task :clobber do
+	`rm -rf ./doc`
+	`rm -rf ./pkg`
+end
+
+desc "Publish the new docs"
+task :publish_docs => [:clobber, :doc] do
+  push_docs
+end
+
+desc "Push docs to servers"
+task :push_docs do
+  user = "#{ENV['USER']}@rubyforge.org" 
+  project = '/var/www/gforge-projects/rutils'
+  local_dir = 'doc'
+  [ 
+    Rake::SshDirPublisher.new( user, project, local_dir),
+    Rake::SshDirPublisher.new('julik', '~/www/code/rutils', local_dir),
+  
+  ].each { |p| p.upload }
+end
+
+
+desc "Publish the release files to RubyForge."
+task :release => [:clobber, :package] do
+    cvs_aware_revision = 'r_' + PKG_VERSION.gsub(/-|\./, '_')
+    `cvs tag #{cvs_aware_revision} .`
+end

data/TODO

@@ -0,0 +1,11 @@
+=TODO
+
+==Даты
+
+==Gilenson
+
+==Pluralization
+
+* Истинная плюрализация без передачи рода и вариантов (как в Rails)
+
+==Rails