Jekyll and Siteleaf support a variety of plugins to extend core functionality, from CoffeeScript conversion to embeddable GitHub Gists. Depending on your site’s plan, you can take advantage of whitelisted or third-party plugins.
Third-party or custom plugins are supported for sites our new Team, Business, and Enterprise plans. For all other plans, including legacy or the free developer plan, your site can use whitelisted plugins. These whitelisted plugins are also supported by GitHub Pages, so your site will render as expected whether compiled by Siteleaf or GitHub.
Using the GitHub Pages gem
You can install Jekyll and all whitelisted plugins by using the
If you run into the following error, you will need to add a
repository: username/repo-name key to your
Liquid Exception: No repo name found. Specify using PAGES_REPO_NWO environment variables, ‘repository’ in your configuration, or set up an ‘origin’ git remote pointing to your github.com repository.
Siteleaf will look for an optional
Gemfile and install any custom plugins prior to building.
If you’re writing your own plugins, you can also include custom Ruby code in the
_plugins directory as outlined in the Jekyll docs.
Installation may vary depending on the plugin, but typically involves two steps.
1) Add to or create a
Gemfile for your site, and reference any plugins you wish to use within the
:jekyll_plugins group. For example, we’ve added the plugin
source 'https://rubygems.org' gem 'jekyll' group :jekyll_plugins do gem 'jekyll-feed' end
2) Next, enable your plugins within the
gems array in your site’s
gems: - jekyll-feed
You may need to follow additional instructions, so make sure to review the plugin’s documentation.
To test your site locally, install and build your site using
$ bundle install $ bundle exec jekyll serve
When previewing or publishing your site within Siteleaf, plugins defined in your
Gemfile will be automatically installed.
Gemfile.lock is ignored to avoid unintentional version locking. If you require a specific version of Jekyll or a plugin, specify it in your
Gemfile instead (in most cases you shouldn’t need to do this):
source 'https://rubygems.org' gem 'jekyll', '~>3.2.1' group :jekyll_plugins do gem 'jekyll-feed', '>=0.7.0' end
Gems can also be installed from public Git or GitHub repositories:
gem 'minima', github: 'jekyll/jekyll-feed', tag: 'v0.7.0'
Using third-party plugins with GitHub Pages
To use non-whitelisted plugins with GitHub Pages, make sure to choose the “Compiled by Siteleaf” format in your hosting settings. With this option, Siteleaf will pre-compile your site before pushing it to GitHub.