Modified

Author: voltsparx

.github/workflows/pages.yml

@@ -22,46 +22,45 @@ concurrency:
   cancel-in-progress: true
 
 jobs:
-  deploy:
-    name: Deploy Docs Website
+  build:
+    name: Build Docs Website
     runs-on: ubuntu-latest
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
 
     steps:
       - name: Checkout
         uses: actions/checkout@v4
 
-      - name: Check whether GitHub Pages is enabled
-        id: pages_status
-        shell: bash
-        run: |
-          status_code="$(curl -sS -o /tmp/pages.json -w '%{http_code}' \
-            -H 'Accept: application/vnd.github+json' \
-            -H 'Authorization: Bearer ${{ github.token }}' \
-            "https://api.github.com/repos/${{ github.repository }}/pages")"
-
-          if [ "$status_code" = "200" ]; then
-            echo "enabled=true" >> "$GITHUB_OUTPUT"
-            echo "GitHub Pages is enabled for this repository."
-          else
-            echo "enabled=false" >> "$GITHUB_OUTPUT"
-            echo "::notice title=GitHub Pages not enabled::Enable Pages in Settings -> Pages and set Source to GitHub Actions, then rerun this workflow."
-            cat /tmp/pages.json || true
-          fi
+      - name: Set up Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: "22"
 
       - name: Configure Pages
-        if: steps.pages_status.outputs.enabled == 'true'
         uses: actions/configure-pages@v5
 
+      - name: Validate docs website shell
+        shell: bash
+        run: |
+          node --check docs/website/app.js
+          test -f docs/website/index.html
+          test -f docs/website/styles.css
+          test -f docs/website/web_assets/favicon.ico
+          test -f docs/website/.nojekyll
+
       - name: Upload static site artifact
-        if: steps.pages_status.outputs.enabled == 'true'
         uses: actions/upload-pages-artifact@v3
         with:
           path: docs/website
 
+  deploy:
+    name: Deploy Docs Website
+    runs-on: ubuntu-latest
+    needs: build
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
       - name: Deploy to GitHub Pages
-        if: steps.pages_status.outputs.enabled == 'true'
         id: deployment
         uses: actions/deploy-pages@v4

docs/website/.nojekyll

@@ -0,0 +1 @@
+