pages publish split into two jobs

Author: Peter Braun

.github/workflows/code.yaml

@@ -54,10 +54,9 @@ jobs:
       run: |
         uv run pytest tests/ -v
 
-  publish-pages:
+  build-pages:
     permissions:
-      contents: read
-      pages: write
+      contents: write
       id-token: write
     runs-on: ubuntu-latest
     #if: ${{startsWith(github.ref, 'refs/tags/')}}  # only publish to PyPI on tag pushes
@@ -89,11 +88,33 @@ jobs:
       shell: bash -l {0}
       run: uv run make -C docs/ html
 
+    - name: Upload
+      uses: actions/upload-pages-artifact@v3
+      with:
+        path: ./docs/build/html
+
     - name: Deploy to GitHub Pages
       id: deployment
       uses: actions/deploy-pages@v4
 
 
+  # Deployment job
+  deploy-pages:
+    permissions:
+      contents: read
+      pages: write
+      id-token: write
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    needs: build-pages
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4
+
+
   build:
     name: Build distribution 📦
     runs-on: ubuntu-latest