Использование Maruku (часть №2)

В прошлой части я рассказал про то, что же из-себя представляет Maruku и что интересного в нём есть. Поэтому сейчас я расскажу как его устанавливать (думаю кто-то уже справился без меня т.к. процесс довольно стандартный)

Всё самое вкусное Rails разработчики обычно получают устанавливая gem-ы, не является исключением и Maruku. На сегодняшний день доступна версия 0.5.9, которую я и поставлю:

sudo gem install maruku

Собственно на этом установка Maruku закончена.

Пример использования:

require 'rubygems'
require 'maruku'

m = Maruku.new("**Привет**")
puts m.to_html

После выполнения этот код вернёт вам строку:

<p><strong>Привет</strong></p>

Помимо метода to_html можно ещё вызывать to_html_document, который выдаёт готовый XHTML документ, а не его часть. Но сейчас этот документ создаётся с довольно специфическим DOCTYPE-ом (хотя судя по коду в следующих версиях возможно это будет как-то настраиваться)

Из интересных вещей ещё осталось отметить то что, Maruku имеет список глобальных настроек доступных в хеше MaRuKu::Globals, например с его помощью можно немного облегчить создание разметки. Например, установив:

MaRuKu::Globals[:html_use_syntax] = true

вы можете использовать более короткую версию IAL для описания языка используемого в блоке кода:

	require 'maruku'
{:lang=ruby}

заместо

	require 'maruku'
{:lang=ruby html_use_syntax=true}

Кстати возможность подсветки блоков кода Maruku реализует за счёт того что задействует gem под названием Syntax, правда количество поддерживаемых языков в нём пока маловато (есть ruby, xml и yaml)

На этом пока всё, в следующей части я расскажу о том как можно расширить язык разметки Markdown вашими собственными тегами(коммандами)