Posible fix to docs generation in github pages 22

.github/workflows/ci.yml

@@ -64,27 +64,43 @@ jobs:
         with:
           name: site-artifact
           path: ./docs/
-
-  deploy:
-    needs: docs
+  build:
     runs-on: ubuntu-latest
     permissions:
-      contents: read
-      pages: write
-      id-token: write
-      actions: read
-
+      contents: write
     steps:
-      - name: Checkout Repository
-        uses: actions/checkout@v4
-
-      - name: Download documentation artifact
-        uses: actions/download-artifact@v4
-        with:
-          name: site-artifact
-          path: docs
-
-      - name: Deploy to GitHub Pages
-        uses: actions/deploy-pages@v3
-        with:
-          path: ./_build/
+    - uses: actions/checkout@v4
+    - name: Build HTML
+      uses: ammaraskar/sphinx-action@master
+    - name: Upload artifacts
+      uses: actions/upload-artifact@v4
+      with:
+        name: html-docs
+        path: docs/_build/html/
+    - name: Deploy
+      uses: peaceiris/actions-gh-pages@v3
+      if: github.ref == 'refs/heads/main'
+      with:
+        github_token: ${{ secrets.GITHUB_TOKEN }}
+        publish_dir: docs/build/html
+  # deploy:
+  #   needs: docs
+  #   runs-on: ubuntu-latest
+  #   permissions:
+  #     contents: read
+  #     pages: write
+  #     id-token: write
+  #     actions: read
+
+  #   steps:
+  #     - name: Checkout Repository
+  #       uses: actions/checkout@v4
+
+  #     - name: Download documentation artifact
+  #       uses: actions/download-artifact@v4
+  #       with:
+  #         name: site-artifact
+  #         path: docs
+
+  #     - name: Deploy to GitHub Pages
+  #       uses: actions/deploy-pages@v3