Установка
Установка готовой к работе версии 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, ознакомьтесь с документацией, прежде чем приступать к работе.