Fix 7 to push to a new branch

Author: jonyMarino

.github/workflows/sphinx-docs.yml

@@ -1,14 +1,18 @@
-name: Build and Deploy Docs
+name: Documentation Build & Deploy
 
 on:
   push:
     branches: [docs_publish]
   pull_request:
     branches: [docs_publish]
+  workflow_dispatch:
 
 jobs:
-  deploy-docs:
+  build-and-deploy:
     runs-on: ubuntu-latest
+    permissions:
+      contents: write
+      pages: write
 
     steps:
       - name: Checkout repository
@@ -17,26 +21,22 @@ jobs:
       - name: Set up Python
         uses: actions/setup-python@v5
         with:
-          python-version: 3.12
+          python-version: '3.12'
 
       - name: Install dependencies
-        run: pip install -r docs/requirements.txt
+        run: |
+          python -m pip install --upgrade pip
+          pip install -r docs/requirements.txt
 
-      - name: Build documentation
+      - name: Build Sphinx documentation
         working-directory: docs
         run: make html
 
-      - name: Deploy to gen_page branch
-        run: |
-          git config user.name "github-actions[bot]"
-          git config user.email "github-actions[bot]@users.noreply.github.com"
-          
-          git fetch origin
-          git switch --orphan gen_page
-
-          cp -r docs/build/html/* .
-          touch .nojekyll
-
-          git add .
-          git commit -m "Deploy documentation to gen_page"
-          git push -f origin gen_page
+      - name: Deploy to GitHub Pages (gen_page)
+        uses: peaceiris/actions-gh-pages@v3
+        if: ${{ github.event_name == 'push' && github.ref == 'refs/heads/main' }}
+        with:
+          github_token: ${{ secrets.GITHUB_TOKEN }}
+          publish_dir: docs/build/html
+          publish_branch: gen_page
+          force_orphan: true