fix: ensure .nojekyll is deployed to gh-pages branch

- Revert to mkdocs gh-deploy workflow for gh-pages branch deployment
- Add extra_files configuration to include .nojekyll in deployment
- This will disable Jekyll processing on the gh-pages branch

Author: dataGriff

.github/workflows/deploy-docs.yml

@@ -26,10 +26,12 @@ jobs:
         run: |
           pip install mkdocs-material mkdocs-git-revision-date-localized-plugin pymdown-extensions mkdocs-mermaid2-plugin
 
-      - name: Build and deploy to GitHub Pages
+      - name: Configure git for deployment
         run: |
           git config --global user.name "github-actions[bot]"
           git config --global user.email "github-actions[bot]@users.noreply.github.com"
-          mkdocs gh-deploy --force --clean
+
+      - name: Build and deploy to gh-pages branch
+        run: mkdocs gh-deploy --force --clean
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}

mkdocs.yml

@@ -48,6 +48,9 @@ plugins:
       type: date
   - mermaid2
 
+extra_files:
+  - .nojekyll
+
 markdown_extensions:
   - pymdownx.highlight:
       anchor_linenums: true