kramdown

kramdown є безкоштовна бібліотека Рубі, яка може бути використана для аналізу розширений набір NBSP уцінки і ,. Він повністю написаний на Ruby, підтримує стандарт Markdown (з деякими незначними змінами) і різні розширення, які були зроблені популярним в PHP Markdown додатковий пакет і Maruku.
Це, ймовірно, найшвидший чистого Рубін Markdown перетворювача (листопад 2009), будучи в 5 разів швидше, ніж Maruku і приблизно в 10 разів швидше, ніж BlueFeather.
Синтаксис kramdown заснований на Markdown, дуже легко писати, легко читати розмітки для написання HTML документів в текстовому форматі. З основною синтаксис Markdown має деякі недоліки, реалізації (особливо додатковий пакет PHP Markdown) намагалися подолати це недоліки з додатковою синтаксису. kramdown підтримує всі можливості оригінального синтаксису Markdown (хоча і з деякими незначними поправками), а також нові можливості, реалізовані в додатковий пакет PHP Markdown і Maruku.
Застосування:
Пакет kramdown надає два способи для його використання:
* У бібліотеці
І NBSP; kramdown використовує в основному ті ж API, як RedCloth, BlueCloth і Maruku:
І NBSP; вимагають "kramdown"
І NBSP; Kramdown :: Document.new (текст) .to_html
І NBSP; Другий параметр новий виклик хеш опцій для (де) активізації деяких можливостей. Для отримання додаткової інформації Ви подивіться документацію по API.
* В якості додатку
І NBSP; разом з файлами бібліотек виконуваного файлу kramdown поставляється який може бути використаний для перетворення тексту в kramdown синтаксису HTML. Це або читає з файлів, вказаних в якості аргументів командного рядка або зі стандартного вводу. Що наприклад:
І NBSP; kramdown шлях / до / kramdown / DOC / syntax.page

Що нового У цьому випуску:

• 2 малих Зміни:
• Додана парсер для Github ароматний Markdown (вирішує GH # 68 Арне Брассер, який надав початкове впровадження)
• атрибути HTML тепер вихід для горизонтальних ліній

Виправлення
• 5 помилок:
• правильне кодування на результуючу рядок тепер встановити навіть при опція використовується шаблон
• Виправлена ​​GH # 72, GH # 74: Все способу установки заголовка ID тепер за тією ж схемою, сумісний з ідентифікаторами HTML (крім того, що точки не допускаються) (звіт та початкова латочка Матті Шнайдер)
• Виправлена ​​GH # 73: шаблон за замовчуванням HTML тепер має DOCTYPE і встановлює кодування правильно (початкова латочка Саймон Lydell)
• Виправлена ​​GH # 67: URL-адреси елементів компоновки тепер втік в перетворювачі LaTeX, щоб уникнути проблем (патч Хеннінг Perl)
• Виправлена ​​GH # 70: Будь-яка версія stringex бібліотеки тепер підтримується (за повідомленням Симона Lydell)

Що нового у версії 1.1.0:

• 2 незначні зміни:
• Виноска маркери тепер можна повторити (вирішує GH # 62 і GH # 63 Теодора Пак, який надав первісний патч)
• акронім пакет LaTeX в даний час використовується для скорочення (вирішує GH # 55 Тім Besard, який надав первісний патч)

Виправлення
• 3 помилка:
• Виправлена ​​GH # 60: Числа в даний час визнається в додаток до символів слова при перетворенні підкреслення (патч Тревор Wennblom)
• Виправлена ​​GH # 66: HTML елементи, і в даний час перетворений правильно латексу перетворювача (патч Хеннінг Perl)
• Виправлена ​​GH # 57: Покращена обробка смарт цитатою коли підкреслення прямо до або після лапок (за повідомленням Білла Tozier)

Що нового у версії 1.0.2:

• сторінка випробування був оновлений, щоб включити відносні раз в тесті так, що можна краще оцінити продуктивність kramdown (просив постмодерну).
• kramdown Wiki тепер містить список бібліотек, які розширюють kramdown (ідея постмодерну).

Що нового у версії 1.0.0:

• 4 незначні зміни:
• Нові transliterated_header_ids варіант для транслітерації текст заголовка в ASCII перед генерацією заголовка ID, яка корисна для мови, як в'єтнамці (фіксований GH # 35, запитаний Кентуккі Ань)
• лапка обличчя і Quot; Тепер конвертується в свого характеру еквівалента, коли entity_output = as_char.
• попередження тепер вихід для IALS / НОП, які містять не приписують дефініція.
• Вихід HTML виноска змінена для використання клас замість отн досягти (X) HTML4 / 5 сумісність

Виправлення
• 3 помилка:
• Виправлена ​​GH # 38: Кодування проблему на 1,9 / 2,0 за несумісних кодувань - вихідна рядок тепер перетворена в кодуванні UTF-8 перед розбором і перетворяться назад після перетворення (за повідомленням Симона Lydell)
• Виправлена ​​РФ # 29647: Скорочення з не-слова першого символу на початку тексту призводять до виключення (повідомлялося Стефан Дейл)
• Виправлена ​​РФ # 29704: ID вказано на заголовків ATX стилі не завжди правильно визначені (за повідомленням Кайл Barbour)

Що нового у версії 0.14.2:

• 1 незначні зміни:
• Нові link_defs опції для пре-визначальних посиланням Визначення
• 1 Виправлена ​​помилка:
• Виправлені підняті помилки на ATX заголовків без тексту

Що нового у версії 0.14.1:

• тільки HTML елементи, які не повинні містити тіло ( т.п.) виводяться в такому вигляді, всі інші елементи тепер використовувати явне закриває тег (вирішує серед інших питань речі з)
• Вказівка ​​блок IAL до списку визначень тепер працює правильно
• Виправлена ​​помилка GH # 30: пусте тіло для визначення в списку визначень призводить до виключення (звітний Марк Джонсон)

Що нового у версії 0.14.0:

• 2 основні зміни:
• код мови, тепер вказується за допомогою .Language-CODELANG замість LANG = "CODELANG
• Реалізована підтримка для установки мови на обгородженій блок коду стартової лінії (початкова латочка на Бран)
• 1 незначна зміна:
• Заголовки з ID може бути припинено, показуючи в змісті шляхом присвоєння класу .no_toc до них (патч Тім Бейтс)
• 1 Виправлена ​​помилка:
• Цифрова замість символічних HTML сутності в даний час резервний замовчуванням (патч від Gioele Barabucci)

Що нового у версії 0.13.5:

• 2 незначні зміни:
• HTML атрибути без значень тепер підтримуються (виправляє помилку РФ # 29490 повідомили Nat Уелч)
• HTML атрибути імена тепер завжди перетворюються в нижній регістр для послідовності

Виправлення
• 5 помилок:
• Виправлена ​​Документ № method_missing прийняти snake_cased ім'я класу (пластиру tomykaira)
• Виправлена ​​помилка з відсутністю постійної REXML на старому Ruby 1.8.6 версії (за повідомленням Dave Еверітт)
• Виправлена ​​помилка РФ # 29520: математика заяву Дійсно рядний не викликає математики блок більше (за повідомленням Gioele Barabucci)
• Виправлена ​​помилка РФ # 29521: HTML математика вихід тепер завжди XHTML сумісні (за повідомленням Gioele Barabucci)
• Порожні атрибути ID тепер краще обробляються в HTML і kramdown перетворювачів (за відомостями Йорг Зоммер)
• 1 документація виправити:
• Виправлена ​​неприпустимі опції заяву в прикладі на короткій довідкової сторінці (доп Йорг Зоммер)

Що нового у версії 0.13.4:

• Додана конвертер, який витягує ТОС документа (просив Брендан Hay). Зверніть увагу, що це тільки корисно, якщо ви використовуєте kramdown як бібліотека!
• Виправлена ​​помилка: Слід --output і не --ouput (патч від постмодерну)
• Виправлена ​​HTML Converter правильно вихідних порожні SPAN теги (патч Джон Croisant)
• Виправлена ​​помилка РФ # 29350: Розбір HTML-теги з незбіжними разі тепер працює
• Виправлена ​​помилка РФ # 29426: Зміст тегів в стилі трактується як сирий текст зараз
• HTML Converter тепер використовує отн замість оборот, щоб бути HTML5 сумісні (патч Джо Фіоріні)
• Виправлена ​​Рубін 1.9.3, пов'язані попередження
• Виправлена ​​HTML-парсер, щоб працювати навколо зміни реалізації Масив # delete_if в Рубі 1.9.3

Вимоги

• Рубін