ci: Split docs deployment into a separate workflow

Author: BurningEnlightenment

.github/workflows/build.yml

@@ -3,6 +3,7 @@ name: build
 on:
   push:
   pull_request:
+  workflow_call:
 
 jobs:
   build:
@@ -19,15 +20,13 @@ jobs:
     runs-on: ${{ matrix.os }}
 
     steps:
-    - name: Check out repository
-      uses: actions/checkout@v4
-
-    - name: Set up Python
+    - uses: actions/checkout@v4
+    - name: Set up Python ${{ matrix.version }}
       uses: actions/setup-python@v5
       with:
         python-version: ${{ matrix.version }}
 
-    - name: Install package
+    - name: Install packages
       run: pip install .
 
     - name: Run tests
@@ -44,7 +43,6 @@ jobs:
       uses: actions/upload-pages-artifact@v3
       if: matrix.os == 'ubuntu-latest' && matrix.version == '3.12'
       with:
-        name: docs
         path: html/
 
     - name: Install pypa/build
@@ -60,25 +58,6 @@ jobs:
         name: python-package-distributions
         path: dist/
 
-  deploy-docs:
-    name: Deploy Docs to GitHub Pages
-    if: ${{ startsWith(github.ref, 'refs/tags/') || github.ref == 'refs/heads/main' }}
-    runs-on: ubuntu-latest
-    needs: [build]
-    permissions:
-      pages: write     # to deploy to Pages
-      id-token: write  # to verify the deployment originates from an appropriate source
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
-
-    steps:
-      - name: Deploy to GitHub Pages
-        id: deployment
-        uses: actions/deploy-pages@v4 # or specific "vX.X.X" version tag for this action
-        with:
-          artifact_name: docs
-
   deploy-testpypi:
     name: Deploy Distribution to Test PyPI
     if: false  # Currently disabled

.github/workflows/deploy-github-pages.yaml

@@ -0,0 +1,35 @@
+name: Deploy docs to Github Pages
+
+on:
+  push:
+    branches: [main]
+    tags:
+      - 'v*'
+
+# Allow only one concurrent deployment, skipping runs queued between the run in-progress and latest queued.
+# However, do NOT cancel in-progress runs as we want to allow these production deployments to complete.
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
+jobs:
+  build:
+    if: github.ref_protected == true
+    uses: ./.github/workflows/build.yml
+
+  deploy-docs:
+    name: Deploy Docs to GitHub Pages
+    if: github.ref_protected == true
+    runs-on: ubuntu-latest
+    needs: [build]
+    permissions:
+      pages: write     # to deploy to Pages
+      id-token: write  # to verify the deployment originates from an appropriate source
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+
+    steps:
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v4