Update github-pages.yml

.github/workflows/github-pages.yml

@@ -1,22 +1,32 @@
 name: GitHub Pages Deploy
+
 on:
-  release:
+  push:
-    types: [published, prereleased]
+    paths:
-  workflow_dispatch: 
+      - 'mkdocs.yml'
-permissions:
+      - 'docs/**'
-  contents: write
+      - 'overrides/**'
+      - 'CONTRIBUTING.md'
+  workflow_dispatch:
+
 jobs:
-  deploy:
+  build-and-deploy:
     runs-on: ubuntu-latest
+
     steps:
-      - uses: actions/checkout@v4
+      - name: Checkout Repository
-      - uses: actions/setup-python@v4
+        uses: actions/checkout@v4
         with:
-          python-version: 3.x
+          fetch-depth: '0'  # Fetch all commit history for all branches as well as tags.
-      - uses: actions/cache@v4
+
+      - name: Setup Python
+        uses: actions/setup-python@v5
         with:
-          key: ${{ github.ref }}
+          python-version: 3.x  # Install latest Stable release of Python 3
-          path: .cache
+          cache: 'pip'  # Caching pip dependencies
-      - run: pip install mkdocs-material
+
-      - run: pip install pillow cairosvg
+      - name: Install Necessary Dependencies
-      - run: mkdocs gh-deploy --force
+        run: pip install -r .github/requirements.txt
+
+      - name: Build & Deploy using mkdocs
+        run: mkdocs gh-deploy --force -f .github/mkdocs.yml