gilenson 1.0.5

data/.autotest

@@ -0,0 +1,23 @@
+# -*- ruby -*-
+
+require 'autotest/restart'
+
+# Autotest.add_hook :initialize do |at|
+#   at.extra_files << "../some/external/dependency.rb"
+#
+#   at.libs << ":../some/external"
+#
+#   at.add_exception 'vendor'
+#
+#   at.add_mapping(/dependency.rb/) do |f, _|
+#     at.files_matching(/test_.*rb$/)
+#   end
+#
+#   %w(TestA TestB).each do |klass|
+#     at.extra_class_map[klass] = "test/test_misc.rb"
+#   end
+# end
+
+# Autotest.add_hook :run_command do |at|
+#   system "rake build"
+# end

data/History.txt

@@ -0,0 +1,80 @@
+=== 1.0.5 / 2010-08-15
+
+* Гиленсон теперь сервируется отдельным блюдом. История изменений ниже по тексту взята из rutils.
+
+=== 1.0.1 - 08.02.2009
+
+* Протестировано на JRuby 1.1.6 (julik)
+* Основные шестеренки совместимы с Ruby 1.9.1 (julik)
+
+=== 0.2.4 - 10.07.2008
+
+* В Gilenson закрывающая латинская кавычка не принимается за знак дюйма
+* В Gilenson корректно обрабатываются неразрывные пробелы если в сегменте присутствуют пунктуация из глифов
+* В Gilenson добавлены настройки force_en_quotes и force_ru_quotes (если нужно свести все кавычки к одной форме)
+* До свидания, Gilenson::Obsolete (julik)
+* До свидания, <nobr>. Указывайте .nobr { text-wrap: nowrap } в своих стилевых таблицах.
+
+=== 0.2.2 - 24.09.2007
+
+* Gilenson - обрабатываем акронимы по принципу Textile (zajats, julik)
+* Gilenson - отформатирован под 2 пробела (julik)
+
+=== 0.2.1 - 02.04.2007
+
+* Восстановлен в gemspec gilenson.rb (Сергей Барабаш)
+
+=== 0.1.9 - 17.02.2007
+
+* Gilenson integration - не съедаем пробелы между тегами при прогоне текста через Textile 
+
+=== 0.1.8 - 05.02.2007
+
+* Gilenson - расстановка инициалов не должна цеплять аббревиатуры (julik) 
+
+=== 0.1.4 - 02.12.2005
+
+* 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)
+
+=== 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

data/Manifest.txt

@@ -0,0 +1,8 @@
+.autotest
+History.txt
+Manifest.txt
+README.txt
+Rakefile
+bin/gilensize
+lib/gilenson.rb
+test/test_gilenson.rb

data/README.txt

@@ -0,0 +1,114 @@
+= gilenson
+
+* http://github.com/julik/gilenson
+
+== DESCRIPTION:
+
+Обработчик типографских символов в HTML согласно общепринятым правилам.
+Посвящается П.Г.Гиленсону[http://www.rudtp.ru/lib.php?book=172], благодаря которому русские правила тех.
+редактуры еще как минимум 20 лет останутся бессмысленно старомодными.
+
+== ФУНКЦИИ
+
+Gilenson расставит в тексте "умные" правильные кавычки (русские - для кириллицы, английские - для латиницы),
+заменит "хитрые" пунктуационные символы на entities и отформатирует знаки типа (c), (tm), телефоны и адреса.
+
+Gilenson базируется на коде Typografica[http://pixel-apes.com/typografica] от PixelApes,
+который был приведен к положенному в Ruby стандарту. Основные отличия Gilenson от Typografica на PHP:
+
+* работа только и полностью в UTF-8 (включая entities, применимые в XML)
+* поддержка "raw"-вывода (символов вместо entities) - текст выводимый Gilenson можно верстать на бумаге
+
+== ИСПОЛЬЗОВАНИЕ:
+
+Программой gilensize поставляющейся в комплекте
+  cat файл_с_текстом_в_utf8.txt | gilensize > красивый_документ.txt
+
+Из кода - как фильтр
+
+  formatter = Gilenson.new
+  formatter.configure(:dash=>true)
+  for string in strings
+    puts formatter.process(string)
+  end
+
+или через метод ++gilensize++ для любой строковой переменной
+
+  %{ И вот они таки "приехали"}.gilensize => 'И вот они таки «приехали»'
+
+Все дополнительные настройки в таком случае передаются форматтеру
+
+  %{ И вот они таки "приехали"}.gilensize(:laquo=>false) => 'И вот они таки "приехали"'
+
+Настройки регулируются через методы
+  formatter.dashglue = true
+или ассоциированным хешем
+  formatter.configure!(:dash=>true, :quotes=>false)
+
+Хеш также можно передавать как последний аргумент методам process и to_html,
+в таком случае настройки будут применены только при этом вызове
+
+  beautified = formatter.process(my_text, :dash=>true)
+
+В параметры можно подставить также ключ :all чтобы временно включить или выключить все фильтры
+
+  beautified = formatter.process(my_text, :all=>true)
+
+Помимо этого можно пользоваться каждым фильтром по отдельности используя метод +apply+
+
+Можно менять глифы, которые форматтер использует для подстановок. К примеру,
+  formatter.glyph[:nbsp] = ' '
+заставит форматтер расставлять "традиционные" неразрывные пробелы.
+Именно это - большая глупость, но другие глифы заменить может быть нужно.
+
+=== Настройки форматтера
+
+* "inches" - преобразовывать дюймы в знак дюйма;
+* "laquo" - кавычки-ёлочки
+* "quotes" - кавычки-английские лапки
+* "dash" -  проставлять короткое тире (150)
+* "emdash" - длинное тире двумя минусами (151)
+* "initials" - проставлять тонкие шпации в инициалах
+* "copypaste" - замена непечатных и "специальных" юникодных символов на entities
+* "(c)" - обрабатывать знак копирайта
+* "(r)", "(tm)", "(p)", "+-" - спецсимволы, какие - понятно
+* "acronyms" - сворачивание пояснений к аббревиатурам (пояснение - в скобках после аббревиатуры без пробела). Пояснение будет "приклеено" к аббревиатуре полукруглой шпацией.
+* "degrees" - знак градуса
+* "dashglue", "wordglue" - приклеивание предлогов и дефисов
+* "spacing" - запятые и пробелы, перестановка
+* "phones" - обработка телефонов
+* "html" - при false - запрет использования тагов html
+* "de_nobr" - при true все <nobr/> заменяются на <span class="nobr"/>
+* "raw_output" - (по умолчанию false) - при true вместо entities выводятся UTF-символы.
+  Это нужно чтобы обработанный текст верстать на бумаге.
+* "skip_attr" - (по умолчанию false) - при true не отрабатывать типографику в атрибутах тегов (title, alt)
+* "skip_code" - (по умолчанию true) - при true не отрабатывать типографику внутри <code/>, <tt/>, CDATA
+
+== УСТАНОВКА:
+
+* sudo gem install gilenson
+
+== ЛИЦЕНЗИЯ:
+
+(The MIT License)
+
+Copyright (c) 2003-2004 Julik Tarkhanov, Danil Ivanov and contributors
+
+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/Rakefile

@@ -0,0 +1,15 @@
+# -*- ruby -*-
+
+require 'rubygems'
+require 'hoe'
+require File.dirname(__FILE__) + "/lib/gilenson"
+
+DOCOPTS = %w(--charset utf-8 --promiscuous)
+
+r = Hoe.spec 'gilenson' do | p |
+  p.developer('Julik Tarkhanov', 'me@julik.nl')
+  p.version =  Gilenson::VERSION
+end
+r.spec.rdoc_options += DOCOPTS
+
+# vim: syntax=ruby

data/bin/gilensize

@@ -0,0 +1,22 @@
+#!/usr/bin/env ruby
+# == Synopsis
+# 
+# Processes text on standard input with Gilenson. Please feed it UTF-8!
+# 
+# == Usage
+# 
+#   cat myfile.txt | gilensize > output.txt
+#   
+# == Author
+#   Julik <me@julik.nl>
+
+$KCODE = 'u'
+require File.dirname(__FILE__) + '/../lib/rutils'
+require 'optparse'
+OptionParser.new do | p |
+ p.on(" -h", "--help") { require 'rdoc/usage'; RDoc::usage }
+end.parse!
+
+while st = gets do
+  puts Gilenson.new(st).to_html
+end