Merge pull request #186 from MoiraeSoftware/copilot/fix-9e1c27c5-b6d0-493b-b78d-51e553ca6f1e

Fix GitHub Pages deployment workflow for Hugo documentation site

Author: 7sharp9

.github/workflows/gh-pages.yml

@@ -5,16 +5,21 @@ on:
     branches: [master]
     paths:
     - 'docs/**'
+  workflow_dispatch:  # Allow manual triggering
 
 jobs:
   deploy:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-latest
+    # Add permissions for GitHub Pages deployment
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
     steps:
-      - uses: actions/checkout@v2
+      - uses: actions/checkout@v4
         with:
-          ref: master
-          submodules: true
-          fetch-depth: 1
+          submodules: recursive
+          fetch-depth: 0
 
       - name: Setup Hugo
         uses: peaceiris/actions-hugo@v3
@@ -28,7 +33,7 @@ jobs:
 
       - name: Deploy
         uses: peaceiris/actions-gh-pages@v3
-        if: github.ref == 'refs/heads/master'
+        if: github.ref == 'refs/heads/master' || github.event_name == 'workflow_dispatch'
         with:
           commit_message: ${{ github.event.head_commit.message }}
           github_token: ${{ secrets.GITHUB_TOKEN }}

docs/.gitignore

@@ -1,2 +1,3 @@
 /public/
-/resources/_gen/
+/resources/_gen/
+.hugo_build.lock