Установка готовой к работе версии Jekyll занимает несколько минут. Если у вас возникли сложности, пожалуйста сообщите, описав их.

Требования

Установка Jekyll проста, но для начала в вашей системе должны быть установлены:

  • Ruby ( версия 1.9.3 и выше для Jekyll 2; версия 2 и выше для Jekyll 3; пакеты для разработчиков ruby-dev,)
  • RubyGems
  • Операционная система — Linux, Unix или Mac OS X
  • NodeJS или иное JavaScript окружение для запуска CoffeeScript
  • Python 2.7 (для Jekyll 2 и более ранних версий)
Запуск Jekyll в Windows

Несмотря на отсутствие официальной поддержки Windows, Jekyll можно запустить на этой операционной системе. Инструкции можно прочитать здесь.

Установка с помощью RubyGems

Это лучший способ установки. Просто откройте терминал и выполните команду:

$ gem install jekyll

Все зависимости Jekyll будут установлены автоматически и вам не надо будет беспокоиться об этом. Если вы столкнетесь с проблемами, ищите решения в разделе документации проблемы или сообщите о проблеме, это поможет сообществу улучшить Jekyll.

Установка инструментов командной строки Xcode

Если вы работаете на Mac OS X и столкнулись с проблемами при установке зависимостей Jekyll, вам надо установить Xcode и его инструменты командной строки. Скачать их можно через Preferences → Downloads → Components.

Пре-релизы

Если вы хотите установить пре-релиз, убедитесь, что ваше окружение соответствует его требованиям и выполните:

gem install jekyll --pre

Эта команда выполнит самую последнюю версию пре-релиза, если же вам нужна определенная версия, вы можете определить ее с помощью опции -v:

gem install jekyll -v '2.0.0.alpha.1'

Если же вы хотите установить версию Jekyll для разработчиков, то процесс немного усложнится. Но вы получите самую свежую версию из существующих, но не стабильную:

$ git clone git://github.com/jekyll/jekyll.git
$ cd jekyll
$ script/bootstrap
$ bundle exec rake build
$ ls pkg/*.gem | head -n 1 | xargs gem install -l

Опциональные дополнения

Существует много дополнительных возможностей Jekyll, которые вы можете установить, в зависимости от ваших планов. В их число входит поддержка LaTeX и альтернативных движков рендеринга. Подробности можно узнать в разделе документации дополнения.

Совет: активация подсветки синтаксиса

Если вы хотите подсвечивать синтаксис с помощью Pygments или Rouge, ознакомьтесь с документацией, прежде чем приступать к работе.