Merge branch 'main' into chore/sweeps-2-4

Author: hyperpolymath

.github/workflows/pages.yml

@@ -1,53 +1,90 @@
-name: GitHub Pages (Ddraig SSG)
+# SPDX-License-Identifier: MPL-2.0
+# GitHub Pages via casket-ssg (hyperpolymath's pure-Haskell static site generator).
+# Replaces the orphan one-off Pages deployment with a reproducible build.
+name: GitHub Pages
+
 on:
   push:
-    branches: [main, master]
+    branches: [main]
   workflow_dispatch:
+
 permissions:
   contents: read
   pages: write
   id-token: write
+
+# Serialise Pages deploys; never cancel an in-flight deploy.
 concurrency:
   group: "pages"
   cancel-in-progress: false
+
 jobs:
   build:
+    timeout-minutes: 20
     runs-on: ubuntu-latest
-    timeout-minutes: 15
-    container:
-      image: ghcr.io/stefan-hoeck/idris2-pack@sha256:f0758996a931fb35d9ecb1de273c4d59dabe2a09b433afc7e357f65a08b7e1ff
     steps:
-      - name: Checkout Site
-        uses: actions/checkout@v4
-      - name: Checkout Ddraig SSG
-        uses: actions/checkout@v4
+      - name: Checkout
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
+
+      - name: Checkout casket-ssg
+        uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0
         with:
-          repository: hyperpolymath/ddraig-ssg
-          path: .ddraig-ssg
-      - name: Compile Ddraig
-        working-directory: .ddraig-ssg
-        run: idris2 Ddraig.idr -o ddraig
+          repository: hyperpolymath/casket-ssg
+          path: .casket-ssg
+
+      - name: Setup GHCup
+        uses: haskell-actions/setup@cd0d9bdd65b20557f41bea4dbe43d0b5fbbfe553 # v2.11.0
+        with:
+          ghc-version: '9.8.2'
+          cabal-version: '3.10'
+
+      - name: Cache Cabal
+        uses: actions/cache@55cc8345863c7cc4c66a329aec7e433d2d1c52a9 # v4
+        with:
+          path: |
+            ~/.cabal/packages
+            ~/.cabal/store
+            .casket-ssg/dist-newstyle
+          key: ${{ runner.os }}-casket-${{ hashFiles('.casket-ssg/casket-ssg.cabal') }}
+
+      - name: Build casket-ssg
+        working-directory: .casket-ssg
+        run: cabal build
+
       - name: Build site
         run: |
-          mkdir -p src
-          if [ ! -f src/index.md ] && [ -f README.md ]; then
-            cp README.md src/index.md
-          elif [ ! -f src/index.md ]; then
-            echo "# ${GITHUB_REPOSITORY}" > src/index.md
+          mkdir -p site _site
+          # Seed site/index.md from README if the author hasn't provided one.
+          if [ ! -f site/index.md ]; then
+            {
+              echo "---"
+              echo "title: $(basename "$PWD")"
+              echo "date: $(date +%Y-%m-%d)"
+              echo "---"
+              if [ -f README.adoc ]; then cat README.adoc
+              elif [ -f README.md ]; then cat README.md
+              else printf '\n# %s\n\nDocumentation coming soon.\n' "$(basename "$PWD")"
+              fi
+            } > site/index.md
           fi
-          ./.ddraig-ssg/build/exec/ddraig build src _site https://hyperpolymath.github.io/${GITHUB_REPOSITORY#*/}
+          cd .casket-ssg && cabal run casket-ssg -- build ../site ../_site
+
+      - name: Setup Pages
+        uses: actions/configure-pages@45bfe0192ca1faeb007ade9deae92b16b8254a0d # v6.0.0
+
       - name: Upload artifact
-        uses: actions/upload-pages-artifact@v3
+        uses: actions/upload-pages-artifact@fc324d3547104276b827a68afc52ff2a11cc49c9 # v3
         with:
           path: '_site'
+
   deploy:
+    timeout-minutes: 20
     environment:
       name: github-pages
       url: ${{ steps.deployment.outputs.page_url }}
     runs-on: ubuntu-latest
-    timeout-minutes: 15
     needs: build
     steps:
       - name: Deploy to GitHub Pages
         id: deployment
-        uses: actions/deploy-pages@v4
+        uses: actions/deploy-pages@cd2ce8fcbc39b97be8ca5fce6e763baed58fa128 # v5.0.0