Add an alternative docker-based config

.dockerignore

@@ -0,0 +1,14 @@
+_site
+.sass-cache
+.jekyll-cache
+.jekyll-metadata
+.git
+.github
+.claude
+vendor
+node_modules
+bower_components
+*.xcf
+.DS_Store
+.idea
+.cursor

Dockerfile

@@ -0,0 +1,15 @@
+FROM ruby:3.3-alpine
+
+RUN apk add --no-cache \
+    build-base \
+    git \
+    && gem install bundler
+
+WORKDIR /site
+
+COPY Gemfile Gemfile.lock ./
+RUN bundle install --jobs 4
+
+EXPOSE 4000
+
+CMD ["bundle", "exec", "jekyll", "serve", "--host", "0.0.0.0"]

README.md

@@ -73,6 +73,20 @@ After installing Jekyll, run the following commands to preview the site:
 
 You will now be able to access the help pages locally at `http://0.0.0.0:4000`  or `localhost:4000` (default configuration). After the website is built for the first time, you should only need to save the file, wait a second or two for it to rebuild automatically (check the terminal window where you ran `jekyll serve`), then refresh the page to see any changes.
 
+#### Development with Docker
+
+As an alternative, you can use Docker instead of installing Ruby locally. The only prerequisite is [Docker](https://docs.docker.com/get-docker/). A convenience script wraps the Docker Compose setup:
+
+```
+./run serve   # start dev server at http://localhost:4000 (livereload)
+./run build   # one-shot production build
+./run dev     # watch + incremental rebuild (no server)
+./run stop    # stop running containers
+./run clean   # remove build artifacts and Docker volumes
+```
+
+`JEKYLL_PORT` and `JEKYLL_ENV` can be set as environment variables.
+
 ### Maintainer
 
 Mugdha

_config.yml

@@ -35,6 +35,12 @@ plugins:
 last-modified-at:
   date-format: '%Y-%m-%dT%H:%M:%S%:z'
 
+exclude:
+  - Dockerfile
+  - docker-compose.yml
+  - run
+  - vendor
+
 defaults:
   - scope:
       path: ''

docker-compose.yml

@@ -0,0 +1,32 @@
+services:
+  jekyll:
+    build: .
+    volumes:
+      - .:/site
+      - bundle_cache:/usr/local/bundle
+    environment:
+      - JEKYLL_ENV=${JEKYLL_ENV:-development}
+
+  serve:
+    extends:
+      service: jekyll
+    ports:
+      - "127.0.0.1:${JEKYLL_PORT:-4000}:4000"
+      - "127.0.0.1:35729:35729"
+    command: bundle exec jekyll serve --host 0.0.0.0 --livereload
+    profiles: [serve]
+
+  dev:
+    extends:
+      service: jekyll
+    command: bundle exec jekyll build --watch --incremental --force_polling
+    profiles: [dev]
+
+  build:
+    extends:
+      service: jekyll
+    command: bundle exec jekyll build
+    profiles: [build]
+
+volumes:
+  bundle_cache:

run

@@ -0,0 +1,45 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+usage() {
+  cat <<EOF
+Usage: ./run <command>
+
+Commands:
+  serve   Start dev server at http://127.0.0.1:4000 (livereload enabled)
+  dev     Watch + incremental rebuild (no server)
+  build   One-shot production build
+  stop    Stop running containers
+  clean   Remove built site, caches, and Docker volumes
+
+Environment:
+  JEKYLL_PORT   Server port (default: 4000)
+  JEKYLL_ENV    Jekyll environment (default: development)
+EOF
+  exit 1
+}
+
+cmd="${1:-}"
+shift || true
+
+case "$cmd" in
+  serve)
+    docker compose --profile serve up "$@"
+    ;;
+  dev)
+    docker compose --profile dev run --rm dev "$@"
+    ;;
+  build)
+    docker compose --profile build run --rm build "$@"
+    ;;
+  stop)
+    docker compose --profile serve down "$@"
+    ;;
+  clean)
+    docker compose --profile serve down -v "$@"
+    rm -rf _site .jekyll-cache .sass-cache
+    ;;
+  *)
+    usage
+    ;;
+esac