Switch to readthedocs

Author: manics

.github/workflows/hugo.yaml

@@ -0,0 +1,16 @@
+# https://docs.readthedocs.com/platform/stable/build-customization.html
+
+version: 2
+
+build:
+  os: ubuntu-24.04
+  tools:
+    python: "3"
+    nodejs: "22"
+
+  jobs:
+    install:
+      - ./ci/download-hugo.sh
+    build:
+      html:
+        - ./ci/readthedocs-build.sh

.readthedocs.yaml

@@ -0,0 +1,5 @@
+#!/bin/bash
+set -eu
+
+HUGO_VERSION=0.124.1
+curl -sfL https://github.com/gohugoio/hugo/releases/download/v${HUGO_VERSION}/hugo_extended_${HUGO_VERSION}_linux-amd64.tar.gz | tar -zxvf - hugo

ci/download-hugo.sh

@@ -0,0 +1,15 @@
+#!/bin/bash
+set -eu
+
+npm ci
+
+BASE_URL=/$(echo $READTHEDOCS_CANONICAL_URL | cut -d/ -f4-)
+
+# For maximum backward compatibility with Hugo modules
+export HUGO_ENVIRONMENT=production HUGO_ENV=production
+
+./hugo \
+  --gc \
+  --minify \
+  --baseURL "$BASE_URL" \
+  --destination="${READTHEDOCS_OUTPUT}/html"