fix(ci): cache texlive-fonts-extra differently

Signed-off-by: skjnldsv <skjnldsv@protonmail.com>

Author: Copilot

.github/workflows/sphinxbuild.yml

@@ -17,7 +17,8 @@ concurrency:
 jobs:
   setup-latex-cache:
     name: Cache LaTeX packages
-    runs-on: ubuntu-latest
+    # Force running on GitHub-hosted runners
+    runs-on: ubuntu-24.04
 
     steps:
       - name: Configure apt cache
@@ -33,7 +34,7 @@ jobs:
           path: |
             ${{ runner.temp }}/.cache/archives
             ${{ runner.temp }}/.cache/lists
-          key: latex-apt-${{ runner.os }}-${{ runner.arch }}-ubuntu-24.04-texlive-2023-v2
+          key: latex-apt-${{ runner.os }}-${{ runner.arch }}-ubuntu-24.04-texlive-2023-v3
           restore-keys: |
             latex-apt-${{ runner.os }}-${{ runner.arch }}-ubuntu-24.04-
             latex-apt-${{ runner.os }}-${{ runner.arch }}-
@@ -54,7 +55,7 @@ jobs:
             -o Dir::State::lists="${{ runner.temp }}/.cache/lists" \
             python3-pil python3-pip texlive-fonts-recommended latexmk \
             texlive-latex-extra texlive-latex-recommended texlive-xetex \
-            texlive-fonts-extra-links texlive-fonts-extra xindy tex-gyre
+            texlive-fonts-extra-links xindy tex-gyre
           # Ensure downloaded packages are owned by the current user so they can be cached
           sudo chown -R $(id -u):$(id -g) ${{ runner.temp }}/.cache/
 
@@ -65,7 +66,42 @@ jobs:
           path: |
             ${{ runner.temp }}/.cache/archives
             ${{ runner.temp }}/.cache/lists
-          key: latex-apt-${{ runner.os }}-${{ runner.arch }}-ubuntu-24.04-texlive-2023-v2
+          key: latex-apt-${{ runner.os }}-${{ runner.arch }}-ubuntu-24.04-texlive-2023-v3
+
+      - name: Check texlive-fonts-extra installed files cache
+        id: cache-fonts-extra
+        uses: actions/cache@668228422ae6a00e4ad889ee87cd7109ec5666a7 # v5.0.4
+        with:
+          path: ~/.cache/texlive-fonts-extra
+          key: latex-fonts-extra-${{ runner.os }}-${{ runner.arch }}-ubuntu-24.04-texlive-2023-v1
+          lookup-only: true
+
+      - name: Install texlive-fonts-extra and cache installed files (cache miss only)
+        if: steps.cache-fonts-extra.outputs.cache-hit != 'true'
+        run: |
+          for i in 1 2 3; do
+            sudo DEBIAN_FRONTEND=noninteractive apt-get update \
+              -o Acquire::Retries=3 && break
+            echo "apt-get update failed (attempt $i), retrying in 15s..."
+            sleep 15
+          done
+          sudo DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends texlive-fonts-extra
+          mkdir -p ~/.cache/texlive-fonts-extra
+          while IFS= read -r f; do
+            [ -f "$f" ] || [ -L "$f" ] || continue
+            rel="${f#/}"
+            dir="$HOME/.cache/texlive-fonts-extra/$(dirname "$rel")"
+            mkdir -p "$dir"
+            sudo cp -P "$f" "$dir/"
+          done < <(dpkg -L texlive-fonts-extra)
+          sudo chown -R $(id -u):$(id -g) ~/.cache/texlive-fonts-extra
+
+      - name: Save texlive-fonts-extra installed files cache (cache miss only)
+        if: steps.cache-fonts-extra.outputs.cache-hit != 'true'
+        uses: actions/cache/save@668228422ae6a00e4ad889ee87cd7109ec5666a7 # v5.0.4
+        with:
+          path: ~/.cache/texlive-fonts-extra
+          key: latex-fonts-extra-${{ runner.os }}-${{ runner.arch }}-ubuntu-24.04-texlive-2023-v1
 
   build:
     name: Build ${{ matrix.manual.name }}
@@ -138,14 +174,30 @@ jobs:
           path: |
             ${{ runner.temp }}/.cache/archives
             ${{ runner.temp }}/.cache/lists
-          key: latex-apt-${{ runner.os }}-${{ runner.arch }}-ubuntu-24.04-texlive-2023-v2
+          key: latex-apt-${{ runner.os }}-${{ runner.arch }}-ubuntu-24.04-texlive-2023-v3
           restore-keys: |
             latex-apt-${{ runner.os }}-${{ runner.arch }}-ubuntu-24.04-
             latex-apt-${{ runner.os }}-${{ runner.arch }}-
 
+      - name: Restore texlive-fonts-extra installed files
+        if: ${{ matrix.manual.build_pdf_path }}
+        uses: actions/cache/restore@668228422ae6a00e4ad889ee87cd7109ec5666a7 # v5.0.4
+        with:
+          path: ~/.cache/texlive-fonts-extra
+          key: latex-fonts-extra-${{ runner.os }}-${{ runner.arch }}-ubuntu-24.04-texlive-2023-v1
+
+      - name: Install texlive-fonts-extra from cache
+        if: ${{ matrix.manual.build_pdf_path }}
+        run: |
+          if [ -d ~/.cache/texlive-fonts-extra ]; then
+            sudo cp -r ~/.cache/texlive-fonts-extra/. /
+          else
+            echo "texlive-fonts-extra cache not found, installing from apt..." >&2
+            sudo DEBIAN_FRONTEND=noninteractive apt-get install -y --no-install-recommends texlive-fonts-extra
+          fi
+
       - name: Install LaTeX from cache
         if: ${{ matrix.manual.build_pdf_path }}
-        timeout-minutes: 5
         run: |
           debs=(${{ runner.temp }}/.cache/archives/*.deb)
           if [ ! -e "${debs[0]}" ]; then