Jekyll

Jekyll⁠ - Transform your plain text into static websites and blogs.

• Simple - No more databases, comment moderation, or pesky updates to install—just your content.
• Static - Markdown, Liquid, HTML & CSS go in. Static sites come out ready for deployment.
• Blog-aware - Permalinks, categories, pages, posts, and custom layouts are all first-class citizens here.
• Free hosting with GitHub Pages

Image reason

1. The image embedding fixed version of Jekyll to prevent breaking changes in Jekyll and it's dependencies.
2. Official images do not support ARM64 arch such a Apple M1

Spec

Expose ports

• tcp/4000 - Jekyll development server listening endpoint
• tcp/4001 - Jekyll live reloading

Volumes

• /data - Sources root (bind/mount here your work directory)

Inside

• Jekyll⁠ v4.3.4
• Bundler gem⁠
• Additional Gems:
  • jemoji⁠ v0.13.0
  • just-the-docs⁠ v0.10.1
  • minitest⁠ v5.25.4
  • racc⁠ v1.8.1
  • rexml⁠ v3.4.0
• Git⁠ v2.45.3
• Git LFS⁠ v3.5.1
• NodeJS⁠ v20.15.1
• NPM⁠ v10.9.1
  • Pug⁠ v3.0.3

Launch

1. Start development server in site root directory (where jekyll's _config.yml located)

docker run --interactive --rm \
  --volume ${PWD}:/data \
  --publish 4000:4000 \
  theanurin/jekyll

1. Open browser http://127.0.0.1:4000/⁠
2. Edit content and look for hot-reloaded changes in the browser

Support

• Maintained by: Max Anurin⁠
• Where to get help: Telegram⁠

Development

Build and debug

docker build --tag theanurin/jekyll --file docker/Dockerfile . && \
  docker run --interactive --tty --rm --entrypoint /bin/sh theanurin/jekyll