This site is a work-in-progress. Some of the information is incomplete and may not work as described. See the homepage for details.

Using GitHub to Build Jekyll

The best place to learn about building a Jekyll site using GitHub pages, is the official docs: https://docs.github.com/en/pages. I can’t really add much, so I won’t.

One thing to note about using GitHub’s servers to build your Jekyll site is gem versions and plugins. GitHub does not allow custom plugins and keeps a list of which plugins (and their versions) can be used: https://pages.github.com/versions/. Anything not listed there will cause your build to fail.

There are two options for getting around this. One is to build your site locally and push the compiled files. The other is to use GitHub Actions.

Usage Limits

GitHub Pages sites have a bandwidth limit of 100GB per month and published sites may be no larger than 1 GB.

For more details see the docs: <https://docs.github.com/en/pages/getting-started-with-github-pages/about-github-pages#usage-limits?