Jekyll, Vagrant и все-все-все

В эти выходные сайт сменил не только дизайн, но и движок. Теперь это Jekyll — генератор статических страниц.

Так же как вариант рассматривался Ghost, но для него нужен nodejs, а у меня нет возможности его установить.

Сайт на Jekyll имеет несколько преимуществ по сравнению с Wordpress.

Во-первых, страницы загружаются мгновенно, потому что нет никаких запросов к базе данных, как и самой базы данных — в отличие от большого неповоротливого движка Wordpress.

Wordpress мощный и с огромными возможностями кастомизации, но для небольшого блога он несколько тяжеловесен.

Во-вторых, сайт с Jekyll можно держать на GitHub Pages, а все изменения делать просто коммитами в специально названый репозиторий. GitHub сгенерит статические страницы, и сайт будет доступен доменом третьего уровня на github.io. Например, мой на гитхабе находится вот по такому адресу: yoksel.github.io.

Для начала работы с Jekyll могут быть полезны исходники сайтов, которые уже его используют, их можно найти здесь: github.com/mojombo/jekyll/wiki/Sites.

Есть возможность миграции блога с нескольких популярных движков, но результат потом всё равно придется доводить напильником.

Так же в создании блога активное участие принимали Grunt и SASS.

Если кому интересно, кровь-кишки лежат в публичном репозитории github.com/yoksel/yoksel.github.io.

Мне нравится, что посты можно писать там же, где я обычно пишу код, а потом просто коммитить их на гитхаб.

Так же возникла необходимость познакомиться поближе с Vagrant. Он создает виртуальное окружение, куда можно установить Apache, нужные языки и базы данных и потом, редактируя локально файлы, видеть их в браузере, как будто они отдаются с сервера. С базовыми возможностями проблем не возникло, а вот с созданием нужной мне конфигурации очень помог сайт puphpet.com.

Ещё попробовала grunt-styleguide — это задача для гранта, которая генерит документацию на основе комментариев в коде. Не до конца разобралсь, но выглядит многообещающе.

Принцип такой: в sass-файлах размещаются комментарии к коду, размеченные с помощью Markdown. На основе этих файлов создаются страницы документации (один файл — одна страница), с навигацией через выпадающее меню. Комментарий может содержать, в том числе, примеры HTML-кода, которые на странице отображаются в виде элементов с примененным стилями.

Действующие примеры можно увидеть тут: jacobrask.github.io/styledocco/.