move gh pages script to mise (as much as possible)

Signed-off-by: Gregor Zeitlinger <[email protected]>

Author: zeitlinger

.github/workflows/github-pages.yaml

@@ -28,8 +28,6 @@ jobs:
   # Build job
   build:
     runs-on: ubuntu-24.04
-    env:
-      HUGO_VERSION: 0.115.4
     steps:
       - uses: actions/checkout@v4
         with:
@@ -39,42 +37,15 @@ jobs:
       - uses: jdx/mise-action@7a111ead46986ccad89a74ad013ba2a7c08c9e67 # v2.1.1
         with:
           cache: 'false'
-      - name: Set release version
-        run: ./scripts/set-release-version-github-pages.sh
-        with:
-          permissions: block
-      - name: Make Javadoc
-        run: ./mvnw -B clean compile javadoc:javadoc javadoc:aggregate -P javadoc
-        with:
-          permissions: block
-      - name: Move the Javadoc to docs/static/api/
-        run: mv ./target/reports/apidocs ./docs/static/api && echo && echo 'ls ./docs/static/api' && ls ./docs/static/api
+      - name: Prepare GitHub Pages
+        run: mise run prepare-gh-pages
         with:
           permissions: block
       - name: Setup Pages
         id: pages
         uses: actions/configure-pages@v5
-      - name: Install Node.js dependencies
-        run: "[[ -f package-lock.json || -f npm-shrinkwrap.json ]] && npm ci || true"
-        with:
-          permissions: block
-        working-directory: ./docs
-      - name: Build with Hugo
-        env:
-          # For maximum backward compatibility with Hugo modules
-          HUGO_ENVIRONMENT: production
-          HUGO_ENV: production
-          BASE_URL: "${{ steps.pages.outputs.base_url }}"
-        run: |
-          hugo \
-            --gc \
-            --minify \
-            --baseURL "${BASE_URL}/"
-        with:
-          permissions: block
-        working-directory: ./docs
-      - name: ls ./docs/public/api
-        run: echo 'ls ./docs/public/api' && ls ./docs/public/api
+      - name: Build GitHub Pages
+        run: mise run build-gh-pages
         with:
           permissions: block
       - name: Upload artifact

mise.lock

@@ -3,7 +3,7 @@ version = "1.6.0"
 backend = "cargo:zizmor"
 
 [tools."go:github.com/gohugoio/hugo"]
-version = "latest"
+version = "v0.147.0"
 backend = "go:github.com/gohugoio/hugo"
 
 [tools."go:github.com/grafana/oats"]
@@ -14,6 +14,10 @@ backend = "go:github.com/grafana/oats"
 version = "temurin-17.0.13+11"
 backend = "core:java"
 
+[tools.node]
+version = "23.10.0"
+backend = "core:node"
+
 [tools.protoc]
 version = "30.2"
 backend = "aqua:protocolbuffers/protobuf/protoc"

mise.toml

@@ -6,6 +6,7 @@ PROTO_GENERATION = "true"
 "go:github.com/gohugoio/hugo" = "latest"
 "go:github.com/grafana/oats" = "latest"
 java = "temurin-17.0.13+11"
+node = "latest"
 protoc = "latest"
 
 [tasks.ci]
@@ -57,6 +58,30 @@ dir = "integration-tests/it-spring-boot-smoke-test"
 [tasks.set-version]
 run = 'mvn versions:set -DnewVersion={{arg(name="version")}}'
 
+[tasks.javadoc]
+run = [
+  "./mvnw -B clean compile javadoc:javadoc javadoc:aggregate -P javadoc",
+  "mv ./target/reports/apidocs ./docs/static/api && echo && echo 'ls ./docs/static/api' && ls ./docs/static/api"
+]
+
+[tasks.set-gh-pages-version]
+run = "./scripts/set-release-version-github-pages.sh"
+
+[tasks.prepare-gh-pages]
+description = "Prepare GitHub pages"
+depends = ["javadoc", "set-gh-pages-version"]
+
+[tasks.build-gh-pages]
+description = "Build GitHub pages"
+# For maximum backward compatibility with Hugo modules
+env = { HUGO_ENVIRONMENT = "production", HUGO_ENV = "production" }
+dir = "docs"
+run = [
+  "npm ci",
+  "hugo --gc --minify --baseURL ${BASE_URL}/",
+  "echo 'ls ./docs/public/api' && ls ./docs/public/api"
+]
+
 [settings]
 # to get lock file support and for go backend
 experimental = true