Refactor GitHub Actions workflow to deploy site directly to gh-pages branch and update permissions

Author: codess-aus

.github/workflows/deploy-pages.yml

@@ -6,25 +6,21 @@ on:
       - main
 
 permissions:
-  contents: read
+  contents: write
   pages: write
   id-token: write
 
 jobs:
-  build:
+  deploy:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4
 
-      - name: Upload site folder for Pages
-        uses: actions/upload-pages-artifact@v2
+      - name: Deploy to gh-pages branch
+        uses: peaceiris/actions-gh-pages@v3
         with:
-          path: ./site
-
-  deploy:
-    needs: build
-    runs-on: ubuntu-latest
-    steps:
-      - name: Deploy to GitHub Pages
-        uses: actions/deploy-pages@v1
+          publish_dir: ./site
+          # Use the default GITHUB_TOKEN provided by Actions
+          publish_branch: gh-pages
+          keep_files: false