Consolidate documentation workflow

Author: benjeffery

.github/workflows/docs.yml

@@ -1,69 +1,15 @@
 name: Build Docs
-
 on:
   pull_request:
   merge_group:
   push:
     branches: [main]
     tags:
       - '*'
-
-env:
-  COMMIT_EMAIL: [email protected]
-  MAKE_TARGET: -C python
-  OWNER: tskit-dev
-  REPO: tskit
-  REQUIREMENTS: python/requirements/CI-docs/requirements.txt
-
 jobs:
-  build-deploy-docs:
-    name: Docs
-    runs-on: ubuntu-24.04
-    defaults:
-      run:
-        shell: bash -l {0}
-    steps:
-      - name: Cancel Previous Runs
-        uses: styfle/[email protected]
-        with:
-          access_token: ${{ github.token }}
-
-      - uses: actions/[email protected]
-
-      - name: Setup Conda
-        uses: conda-incubator/[email protected]
-        with:
-          miniforge-version: latest
-          activate-environment: tskit-docs-env
-          
-      - name: Cache Conda env
-        uses: actions/[email protected]
-        with:
-          path: ${{ env.CONDA }}/envs
-          key: conda-${{ runner.os }}--${{ runner.arch }}--${{ hashFiles(env.REQUIREMENTS) }}-${{ env.CACHE_NUMBER }}
-        env:
-          CACHE_NUMBER: 0
-        id: cache
-
-      - name: Update environment
-        run: |
-          mamba install -y python=3.12 doxygen=1.12.0 pip
-          pip install -r ${{ env.REQUIREMENTS }}
-        if: steps.cache.outputs.cache-hit != 'true'
-
-      - name: Build C module
-        if: env.MAKE_TARGET
-        run: make $MAKE_TARGET
-
-      - name: Build Docs
-        run: |
-          doxygen -v
-          make -C docs
-
-      - name: Trigger docs site rebuild
-        if: github.ref == 'refs/heads/main'
-        run: |
-          curl -X POST https://api.github.com/repos/tskit-dev/tskit-site/dispatches \
-                    -H 'Accept: application/vnd.github.everest-preview+json' \
-                    -u AdminBot-tskit:${{ secrets.ADMINBOT_TOKEN }} \
-                    --data '{"event_type":"build-docs"}'
+  Docs:
+    uses: tskit-dev/.github/.github/workflows/docs-build-template.yml@main
+    with:
+      requirements-path: python/requirements/CI-docs/requirements.txt
+      additional-setup: sudo apt-get install -y doxygen
+      make-command: make -C python