- Jekyll is a Static Site Generator (SSG) which is great for content that doesn't need to change for each user. Once deployed, it's dead-simple fast and secure.
- Jekyll has built-in support for GitHub Pages. They host your content for free!
- GitHub can host custom domains. Did I mention free?
- Jekyll can be run locally in a Docker container—which saves a lot of Ruby setup and configuration time. See below for details.
- Contributing is okay for geeks, but may be too much for the uninitiated.
- Content needs to be created and edited in Markdown.
- Editing can be done at github.com or via IDE or text editor.
- Jekyll is written in Ruby—which may be an issue if it's not your native language.
- Git
- Docker Desktop
-
Clone this repo to a local directory.
git clone https://github.com/stedman/docker-jekyll my-jekyll-app cd my-jekyll-app
-
OPTIONAL: In the
.env
file, changeJEKYLL_VERSION
to suit your needs. -
Run Docker Compose.
docker-compose -f docker-compose-jekyll-new.yml up
-
If you don't already have the
.env
anddocker-compose.yml
files in your Jekyll app directory, please cut and paste the contents of those files from this repo. -
Start Jekyll server (from the app directory).
docker-compose up -d
-
Stop Jekyll server.
docker-compose down
- Jekyll documentation
- Jekyll Docker repo
- GitHub Pages versions (GitHub's environment and dependencies)
- Running Jekyll in Docker (tutorial)