From f2da6ea2d42dadcc0ec822a2cfeb1827595dbc04 Mon Sep 17 00:00:00 2001
From: Jon Peirce <jon.peirce@gmail.com>
Date: Wed, 29 Apr 2026 09:46:20 +0100
Subject: [PATCH 1/2] Testing why Tectonic stopped building

---
 .github/workflows/build_docs.yaml | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/.github/workflows/build_docs.yaml b/.github/workflows/build_docs.yaml
index e1f275d..085d9ce 100644
--- a/.github/workflows/build_docs.yaml
+++ b/.github/workflows/build_docs.yaml
@@ -89,10 +89,6 @@ jobs:
     - name: "HTML: Sphinx build html"
       run: |
         sphinx-build -b html source build/html
-        # then copy over the plugins.json from psychopy/plugins repo
-        curl -LO https://github.com/psychopy/plugins/raw/refs/heads/${{ github.event.inputs.pp_branch }}/plugins.json
-        mv plugins.json build/html
-
     - name: "PDF: Sphinx build latex"
       run: |
         sphinx-build -b latex source build/latex
@@ -108,6 +104,10 @@ jobs:
     - name: "PDF: Build PDF with Tectonic"
       run: |
         tectonic build/latex/PsychoPyManual.tex --outdir build/html
+    - name: fetch plugins.json
+      run: |
+        curl -LO https://github.com/psychopy/plugins/raw/refs/heads/${{ github.event.inputs.pp_branch }}/plugins.json
+        mv plugins.json build/html
     - name: "DEBUG: Upload docs as artifact"
       uses: actions/upload-artifact@v6
       with:

From e76c6f5f84247049c2a240fa3ad1e8c3f407f138 Mon Sep 17 00:00:00 2001
From: Jon Peirce <jon.peirce@gmail.com>
Date: Wed, 29 Apr 2026 10:15:31 +0100
Subject: [PATCH 2/2] Workaround current tectonic failure to build

---
 .github/workflows/build_docs.yaml | 21 +++++++++++++--------
 1 file changed, 13 insertions(+), 8 deletions(-)

diff --git a/.github/workflows/build_docs.yaml b/.github/workflows/build_docs.yaml
index 085d9ce..e0bedf3 100644
--- a/.github/workflows/build_docs.yaml
+++ b/.github/workflows/build_docs.yaml
@@ -92,18 +92,22 @@ jobs:
     - name: "PDF: Sphinx build latex"
       run: |
         sphinx-build -b latex source build/latex
-    - name: "PDF: Cache Tectonic files"
-      uses: actions/cache@v5
-      with:
-        path: ~/.cache/Tectonic
-        key: ${{ runner.os }}-tectonic-${{ hashFiles('**/*.tex') }}
-        restore-keys: |
-          ${{ runner.os }}-tectonic-
+    # - name: "PDF: Cache Tectonic files"
+    #   uses: actions/cache@v5
+    #   with:
+    #     path: ~/.cache/Tectonic
+    #     key: ${{ runner.os }}-tectonic-${{ hashFiles('**/*.tex') }}
+    #     restore-keys: |
+    #       ${{ runner.os }}-tectonic-
     - name: "PDF: Set up Tectonic"
       uses: wtfjoke/setup-tectonic@v4
     - name: "PDF: Build PDF with Tectonic"
       run: |
-        tectonic build/latex/PsychoPyManual.tex --outdir build/html
+        # try building with tectonic or fetch from psychopy.org if that fails (e.g. due to missing latex packages)
+        if ! tectonic build/latex/PsychoPyManual.tex --outdir build/html; then
+          echo "Tectonic build failed, fetching pre-built PDF from psychopy.org"
+          curl -L -o build/html/PsychoPyManual.pdf https://www.psychopy.org/PsychoPyManual.pdf
+        fi
     - name: fetch plugins.json
       run: |
         curl -LO https://github.com/psychopy/plugins/raw/refs/heads/${{ github.event.inputs.pp_branch }}/plugins.json
@@ -115,6 +119,7 @@ jobs:
         path: build/html
     - name: "DEBUG: Upload PsychoPyManual.tex as artifact"
       uses: actions/upload-artifact@v6
+      if: always() # upload even if build fails, to allow debugging of build issues
       with:
         name: PsychoPyManual.tex
         path: build/latex/PsychoPyManual.tex