kramdown

kramdown е безплатна Ruby библиотека, която може да се използва за разбор надмножество на Markdown & Nbsp;. Той е изцяло написан на Ruby, поддържа стандарта Markdown (с някои малки изменения) и различни разширения, които са били популярна от PHP-евтино Екстра пакет и Maruku.
Това е може би най-бързият чист-Ruby Markdown конвертор на разположение (ноември 2009 г.), е 5 пъти по-бързо от Maruku и около 10 пъти по-бързо от BlueFeather.
Синтаксис kramdown се основава на Markdown, много лесно да се напише, да се чете лесно маркиране за писане на HTML документи в обикновен текст. Тъй като основният Markdown синтаксис има някои недостатъци, реализации (особено Екстра пакет PHP Markdown) са опитвали да се преодолее този недостатъци с допълнителна синтаксис. kramdown поддържа всички функции на оригиналния синтаксис Markdown (макар и с някои малки корекции), както и по-новите функции, изпълнявани в Extra пакет PHP Markdown и Maruku.
<Силен> Usage:
Пакетът kramdown предвижда два начина за да го използвате:
* Като библиотека
& Nbsp; kramdown използва едни и същи API като RedCloth, BlueCloth и Maruku:
& Nbsp; изисква "kramdown"
& Nbsp; Kramdown :: Document.new (текст) .to_html
& Nbsp; Вторият параметър на новото повикване е опции за сегментиране за (де) активиране на някои функции. За повече информация погледнете документацията на API.
* По заявка
& Nbsp; Заедно с библиотеката файлове двоичен нарича kramdown се прави е за който може да се използва за конвертиране на текст в kramdown синтаксиса на HTML. Той или чете от файловете, като аргументите на командния ред или от стандартния вход. Например:
& Nbsp; kramdown път / до / kramdown / док / syntax.page

Какво ново в тази версия:

• 2 непълнолетен промени:
• Добавена на анализатор за Github ароматизиран Markdown (решава GH # 68 от Арне Brasseur който осигури първоначалното прилагане)
• HTML атрибути сега се извеждат за хоризонтални линии
• 5 корекции на грешки:
• правилното кодиране на низ резултатът е вече избран, дори когато се използва опцията за шаблон
• Фиксирана GH # 72, # 74 GH: Всички начини за настройка ID глава за сега следват същата схема, която е в съответствие с HTML документи за самоличност (с изключение на тези точки не се допуска) (съобщено и първоначалната пластир от Matti Schneider)
• Фиксирана GH # 73: шаблона по подразбиране HTML сега има DOCTYPE и определя кодирането правилно (първоначално пластир от Simon Lydell)
• Фиксирана GH # 67: URLs на линия за предаване на елементи вече са избягали в конвертора LaTeX да се избегнат проблеми (пластир от Henning Perl)
• Фиксирана GH # 70: Всяка версия на stringex библиотеката вече се поддържа (отчетени от Simon Lydell)

Какво ново във версия 1.1.0:

• 2 малки промени:
• Бележка под линия маркери може сега да се повтори (решава GH # 62 и # 63 GH от Теодор Pak, които ако първоначалното пластира)
• акроним пакет LaTeX сега се използва за съкращения (решава GH # 55 от Тим ​​Besard които ако първоначалното пластира)
• 3 корекции на грешки:
• Фиксирана GH # 60: Numbers сега се признават в допълнение към словните знаци при конвертиране долни черти (пластир от Trevor Wennblom)
• Фиксирана GH # 66: HTML елементи, и сега са превърнати правилно от LaTeX конвертор (пластир от Henning Perl)
• Фиксирана GH # 57: по-добро управление интелигентен цитат когато долни са непосредствено след или преди кавички (отчетени от Bill Tozier)

Какво ново във версия 1.0.2:

• страницата на тестовете е актуализиран, за да включва относителните времена в бенчмарка, така че да е възможно по-добре да се прецени ефективността на kramdown (поискано от постмодерна).
• The kramdown Wiki сега съдържа списък на библиотеките, които се простират kramdown (идея от постмодерното).

Какво ново във версия 1.0.0:

• 4 малки промени:
• нова опция transliterated_header_ids за превежда текст с глава в ASCII преди да генерира ID глава за което е полезно за език като виетнамски (фиксирана GH # 35, поискана от Кентъки Anh)
• предприятието & quot The кавички; сега получава превръща в неговия характер еквивалент когато entity_output = as_char.
• предупредително сега е изход за IALS / ALDs, че не съдържат приписват defintion.
• HTML бележка под линия изход се променя, за да използвате клас вместо отн да се постигне (X) HTML4 / 5 съвместимост
• 3 корекции на грешки:
• Фиксирана GH # 38: Encoding проблем на 1.9 / 2.0 поради несъвместими кодировки - низа източник сега се превръща в UTF-8 преди разбор и се превръща отново след конвертиране (отчетени от Simon Lydell)
• Фиксирана RF # 29647: Съкращения с нестопанска дума първия герой в началото на текст, водят до изключения (отчетени от Stephan Dale)
• Фиксирана RF # 29704: ID е посочено върху заглавията ATX стил не винаги са правилно открити (отчетени от Kyle Barbour)

Какво ново във версия 0.14.2:

• 1 незначителна промяна:
• нова опция link_defs за предварително определяне на определения връзката
• 1 бъг:
• Фиксирани повдигнати грешки на ATX хедъри без текст

Какво ново във версия 0.14.1:

• Само HTML елементи, които не трябва да съдържат тяло ( като) се извеждат в тази форма, всички други елементи вече използват изрично затварящ етикет (решава всички други въпроси, неща с)
• Задаване на блок IAL преди списък определение сега работи правилно
• Фиксирана бъг GH # 30: Empty орган за определяне на списък определение може да доведе до по изключение (отчетени от Mark Johnson)

Какво ново във версия 0.14.0:

• 2 основни промени:
• Code език сега е определен чрез .language-CODELANG вместо Lang = "CODELANG"
• Изпълнено подкрепа за създаването на езика на ограден код блок стартовата линия (начално пластир от Бран)
• 1 незначителна промяна:
• хедъри с ID може да бъде да се показва в ТОС чрез присвояване на клас на .no_toc да ги (пластир от Тим ​​Bates)
• 1 бъг:
• Цифров вместо символични HTML лица вече са резервен по подразбиране (пластир от Gioele Barabucci)

Какво ново във версия 0.13.5:

• 2 малки промени:
• HTML атрибути, без стойности вече се поддържат (корекции на грешки RF # 29490 докладвано от Nat Welch)
• HTML атрибути имена са сега винаги преобразувани към малки букви от последователност
• 5 корекции на грешки:
• Фиксирана Документ # method_missing да приеме името snake_cased клас (пластир от tomykaira)
• Фиксирана проблем с липсващи REXML постоянно по-възрастен Ruby 1.8.6 версия (отчетени от Dave Everitt)
• Фиксирана бъг RF # 29520: Валиден инлайн изявление математика не задейства математика блок вече (отчетени от Gioele Barabucci)
• Фиксирана бъг RF # 29521: HTML математика изход сега е винаги XHTML съвместим (отчетени от Gioele Barabucci)
• Празни лични качества са вече обработени по-добри от HTML и kramdown преобразуватели (отчетени от Йорг Sommer)
• 1 документация Fix:
• Фиксирана невалидни опции изявление в пример за бърза справка страница (отчетени от Йорг Sommer)

Какво ново във версия 0.13.4:

• Добавена конвертор, който извлича ТОС на документ (поискано от Brendan Hay). Имайте предвид, че това е само от полза, ако използвате kramdown като библиотека!
• Фиксирана правописна грешка: Трябва да се --output и не --ouput (пластир от постмодерна)
• Фиксирана HTML конвертор за правилно изходните празни многочленни тагове (кръпка от Джон Croisant)
• Фиксирана бъг RF # 29350: разбор на HTML тагове с несъответстващи случай сега работи
• Фиксирана бъг RF # 29426: Съдържание на тагове в стил се третира като суров текст сега
• HTML конвертор сега използва отн вместо REV да бъде HTML5 съвместим (пластир от Джо Fiorini)
• Фиксирана Ruby 1.9.3 свързани предупреждения
• Фиксирана HTML анализатор, за да се справите с промяна на изпълнение от Array # delete_if в Ruby 1.9.3

<силни> Изисквания :

• Ruby