theanurin/jekyll repository overview

⁠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