Плагины

У вас есть 3 варианта установки плагинов:

1. В корневом каталоге вашего сайта создайте директорию _plugins. Поместите сюда ваши плагины. Любой файл, заканчивающийся на *.rb, внутри этой директории будет загружен перед тем, как Jekyll сгенерирует ваш сайт.

2. В вашем файле _config.yml, добавьте новый массив с ключом plugins (или gems для Jekyll < 3.5.0) и значениями имён gem-плагинов, которые вы хотите использовать. Пример:

   # This will require each of these plugins automatically.
   plugins:
     - jekyll-gist
     - jekyll-coffeescript
     - jekyll-assets
     - another-jekyll-plugin
   

   Затем установите ваши плагины, используя gem install jekyll-gist jekyll-coffeescript jekyll-assets another-jekyll-plugin

3. Добавьте соответствующие плагины в группу Bundler в вашем Gemfile. Пример:

   group :jekyll_plugins do
     gem "jekyll-gist"
     gem "jekyll-coffeescript"
     gem "jekyll-assets"
     gem "another-jekyll-plugin"
   end
   

   Теперь вам нужно установить все плагины из вашей группы Bundler, выполнив одну команду bundle install.

Плагины на GitHub Pages

GitHub Pages работает на базе Jekyll. Все сайты Pages генерируются с использованием опции --safe для отключения плагинов (за исключением некоторых разрешённых плагинов) по соображениям безопасности. К сожалению, это означает, что ваши плагины не будут работать, если вы развертываете сайт на GitHub Pages.
Вы по-прежнему можете использовать GitHub Pages для публикации своего сайта, но вам потребуется преобразовать сайт локально и опубликовать сгенерированные статические файлы в свой репозиторий GitHub вместо файлов исходного кода Jekyll.

_plugins, _config.yml и Gemfile могут использоваться одновременно

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

Группа jekyll_plugins

Jekyll применяет особую обработку к этой группе gems в вашем Gemfile. Любой gem, включённый в эту группу, загружается перед началом обработки Jekyll остальной части вашей директории исходных файлов.

Gem, включенный здесь, будет активирован, даже если он не указан явно в ключе plugins: в файле конфигурации вашего сайта.

Gems, включенные в группу :jekyll-plugins, активируются независимо от настроек режима --safe. Будьте внимательны к тому, какие gems включены в эту группу!