Ruby 101

Jekyll написан на Ruby. Если вы новичок в Ruby, эта страница поможет вам познакомиться с некоторыми терминами.

Gems

Gems — это код, который можно включить в проекты Ruby. Gems упаковывают определённую функциональность. Вы можете использовать gems в нескольких проектах или поделиться ими с другими людьми. Gems могут выполнять такие действия:

• Преобразование объекта Ruby в JSON
• Пейджинг
• Взаимодействие с API, такими как GitHub

Jekyll — это gem. Многие плагины Jekyll, включая плагины, такие как jekyll-feed, jekyll-seo-tag и jekyll-archives, также являются gems.

Gemfile

A Gemfile — это список gems, используемых вашим сайтом. Каждый сайт Jekyll имеет Gemfile в основной папке.

Для простого сайта Jekyll он может выглядеть примерно так:

source "https://rubygems.org"

gem "jekyll"

group :jekyll_plugins do
  gem "jekyll-feed"
  gem "jekyll-seo-tag"
end

Bundler

Bundler — это gem, который устанавливает все gems в вашем Gemfile.

Хотя вы не обязаны использовать Gemfile и bundler, это настоятельно рекомендуется, так как это гарантирует, что вы используете одну и ту же версию Jekyll и его плагинов в разных средах.

Установите Bundler, используя gem install bundler. Устанавливать его нужно только один раз, а не каждый раз, когда вы создаёте новый проект Jekyll.

Чтобы установить gems из вашего Gemfile с помощью Bundler, выполните следующую команду в каталоге, содержащем Gemfile:

bundle install
bundle exec jekyll serve

Чтобы обойти Bundler, если вы не используете Gemfile, выполните jekyll serve.

См. Использование Jekyll с Bundler для получения дополнительной информации о Bundler в Jekyll и инструкций по быстрому запуску.