Handle specific hugo version instead of the local one

Signed-off-by: Alban Dericbourg <alban@dericbourg.dev>

Author: adericbourg

.github/workflows/hugo.yaml

@@ -31,20 +31,23 @@ jobs:
   # Build job
   build:
     runs-on: ubuntu-latest
-    env:
-      HUGO_VERSION: 0.148.2
     steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          submodules: recursive
+          fetch-depth: 0
+      - name: Read Hugo version
+        id: hugo-version
+        run: echo "version=$(cat .hugo-version)" >> $GITHUB_OUTPUT
       - name: Install Hugo CLI
+        env:
+          HUGO_VERSION: ${{ steps.hugo-version.outputs.version }}
         run: |
           wget -O ${{ runner.temp }}/hugo.deb https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.deb \
           && sudo dpkg -i ${{ runner.temp }}/hugo.deb
       - name: Install Dart Sass
         run: sudo snap install dart-sass
-      - name: Checkout
-        uses: actions/checkout@v4
-        with:
-          submodules: recursive
-          fetch-depth: 0
       - name: Setup Pages
         id: pages
         uses: actions/configure-pages@v5

.gitignore

@@ -4,3 +4,6 @@
 .hugo_build.lock
 /node_modules
 public/
+
+# Generated env file for docker-compose
+.env

.go-version

@@ -0,0 +1 @@
+1.24.4

.hugo-version

@@ -0,0 +1 @@
+0.148.2

Dockerfile

@@ -0,0 +1,28 @@
+FROM debian:bookworm-slim
+
+ARG HUGO_VERSION
+ARG GO_VERSION
+ARG TARGETARCH
+
+RUN apt-get update && apt-get install -y --no-install-recommends \
+    ca-certificates \
+    wget \
+    git \
+    && rm -rf /var/lib/apt/lists/*
+
+RUN ARCH=$(echo ${TARGETARCH} | sed 's/amd64/amd64/;s/arm64/arm64/') && \
+    wget -O /tmp/go.tar.gz "https://go.dev/dl/go${GO_VERSION}.linux-${ARCH}.tar.gz" && \
+    tar -C /usr/local -xzf /tmp/go.tar.gz && \
+    rm /tmp/go.tar.gz
+
+ENV PATH="/usr/local/go/bin:${PATH}"
+
+RUN ARCH=$(echo ${TARGETARCH} | sed 's/amd64/amd64/;s/arm64/arm64/') && \
+    wget -O /tmp/hugo.deb "https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-${ARCH}.deb" && \
+    dpkg -i /tmp/hugo.deb && \
+    rm /tmp/hugo.deb
+
+WORKDIR /site
+EXPOSE 1313
+
+CMD ["hugo", "server", "--bind", "0.0.0.0"]

Makefile

@@ -0,0 +1,21 @@
+HUGO_VERSION := $(shell cat .hugo-version)
+GO_VERSION := $(shell cat .go-version)
+export HUGO_VERSION GO_VERSION
+
+.PHONY: build serve shell clean env
+
+env:
+	@echo "HUGO_VERSION=$(HUGO_VERSION)" > .env
+	@echo "GO_VERSION=$(GO_VERSION)" >> .env
+
+build: env
+	docker compose build
+
+serve: build
+	docker compose up hugo
+
+shell: build
+	docker compose run --rm shell
+
+clean:
+	docker compose down --rmi local

README.md

@@ -0,0 +1,101 @@
+# dericbourg.dev
+
+Professional website, built with [Hugo](https://gohugo.io/).
+
+## Prerequisites
+
+- [Docker](https://docs.docker.com/get-docker/) and Docker Compose
+- Make (optional, but recommended)
+
+## Local development
+
+### With Make (recommended)
+
+```bash
+# Start the development server (http://localhost:1313)
+make serve
+
+# Get an interactive shell with Hugo
+make shell
+
+# Rebuild the Docker image
+make build
+
+# Clean up Docker images
+make clean
+```
+
+### Without Make
+
+```bash
+# Generate the .env file (needed once)
+echo "HUGO_VERSION=$(cat .hugo-version)" > .env
+echo "GO_VERSION=$(cat .go-version)" >> .env
+
+# Start the development server
+docker compose up hugo
+
+# Get an interactive shell
+docker compose run --rm shell
+```
+
+### Useful Hugo commands
+
+Once in the shell (`make shell`), you can use Hugo directly:
+
+```bash
+# Create new content
+hugo new content/posts/my-article.md
+
+# Build the site (generates in /public)
+hugo
+
+# Build with minification
+hugo --minify
+```
+
+## Version management
+
+The Hugo and Go versions are centralized in dedicated files:
+
+| File | Description |
+|------|-------------|
+| `.hugo-version` | Hugo version (used by Makefile and GitHub Actions) |
+| `.go-version` | Go version (required for Hugo Modules) |
+
+To update versions:
+
+```bash
+echo "0.150.0" > .hugo-version
+echo "1.24.5" > .go-version
+make build  # Rebuild the Docker image
+```
+
+## Deployment
+
+The site is automatically deployed to GitHub Pages on push to the `main` branch.
+
+### GitHub Actions workflow
+
+The `.github/workflows/hugo.yaml` file defines the deployment pipeline:
+
+1. **Checkout**: Retrieves the source code with submodules (theme)
+2. **Read Hugo version**: Reads `.hugo-version` to ensure consistency with local development
+3. **Install Hugo**: Downloads and installs Hugo Extended
+4. **Build**: Generates the static site with `hugo --gc --minify`
+5. **Deploy**: Publishes to GitHub Pages
+
+## Project structure
+
+```
+.
+├── .hugo-version        # Hugo version (single source of truth)
+├── .go-version          # Go version (for Hugo Modules)
+├── hugo.toml            # Hugo configuration
+├── go.mod               # Hugo Modules dependencies
+├── content/             # Site content (Markdown)
+├── static/              # Static files (images, etc.)
+├── Dockerfile           # Docker image for Hugo + Go
+├── docker-compose.yaml  # Docker services (hugo, shell)
+└── Makefile             # Development commands
+```

docker-compose.yaml

@@ -0,0 +1,24 @@
+services:
+  hugo:
+    build:
+      context: .
+      args:
+        HUGO_VERSION: ${HUGO_VERSION}
+        GO_VERSION: ${GO_VERSION}
+    volumes:
+      - .:/site
+    ports:
+      - "1313:1313"
+    command: hugo server --bind 0.0.0.0 --disableFastRender
+
+  shell:
+    build:
+      context: .
+      args:
+        HUGO_VERSION: ${HUGO_VERSION}
+        GO_VERSION: ${GO_VERSION}
+    volumes:
+      - .:/site
+    stdin_open: true
+    tty: true
+    command: /bin/bash