Article version: Enterprise Server 2.14

This version of GitHub Enterprise will be discontinued on This version of GitHub Enterprise was discontinued on 2019-07-12. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Using Jekyll as a static site generator with GitHub Pages

GitHub Pages is available in public repositories with GitHub Free, and in public and private repositories with GitHub Pro, GitHub Team, GitHub Enterprise Cloud, and GitHub Enterprise Server.

If you use Jekyll as a static site generator with GitHub Pages, you benefit from more support with setting up, updating, and troubleshooting your site.

About GitHub Pages and Jekyll

In addition to supporting regular HTML content, GitHub Pages supports Jekyll, a popular static site generator.

About Jekyll themes on GitHub

You can install a Jekyll theme to customize the design of your GitHub Pages site without having to edit or copy CSS files. Jekyll themes package the files you need to change your site design, including any files that are stored in your assets folder, like SCSS, SASS, images, and CoffeeScript.

Adding a Jekyll theme to your GitHub Pages site

You can add a Jekyll theme to your GitHub Pages site by editing your site's _config.yml file.

Customizing CSS and HTML in your Jekyll theme

You can personalize your GitHub Pages site by adding custom styles to your Jekyll theme and changing your theme's layout.

Setting up your GitHub Pages site locally with Jekyll

You can set up a local version of your Jekyll GitHub Pages site to test changes to your site locally. We highly recommend installing Jekyll to preview your site and help troubleshoot failed Jekyll builds.

Configuring Jekyll

You can configure most Jekyll settings by editing your _config.yml file.

Ask a human

Can't find what you're looking for?

Contact us