Try artifact deploy

.github/workflows/deploy.yml

@@ -59,6 +59,11 @@ jobs:
     needs: build
     name: Deploy docs
     runs-on: ubuntu-latest
+
+    permissions:
+      pages: write
+      id-token: write
+
     steps:
       - name: Checkout repository
         uses: actions/checkout@v4.2.2
@@ -100,5 +105,19 @@ jobs:
         run: pip install -r docs/requirements.txt
       - name: Generate images-by-category.md
         run: python scripts/generate-images-by-category.py
+      - name: Build documentation
+        run: mkdocs build
+      - name: Upload static files as artifact
+        uses: actions/upload-pages-artifact@v3.0.1
+        with:
+          path: site/
+  pages:
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: deploy
+    steps:
       - name: Deploy to GitHub Pages
-        run: mkdocs gh-deploy --force
+        id: deployment
+        uses: actions/deploy-pages@v4