Cache Migration: Global Conda & LaTeX Caching (#3)

* Migrate cache.yml to use composite actions with global caching

Changes:
- Use setup-lecture-env@main for Conda environment (global cache)
- Use setup-latex@main for LaTeX packages (global cache)
- Use build-lectures@main for Jupyter Book builds
- Add latex-requirements.txt with version pinning
- Add push:branches:[main] trigger for golden cache creation

This establishes the global caching infrastructure:
- Conda cache: shared across all workflows
- LaTeX cache: shared across all workflows
- Version-pinned LaTeX packages for explicit invalidation

* Fix latex-requirements.txt formatting (remove duplicates)

* Remove push trigger from cache.yml - use weekly schedule only

Long-running cache builds should only run:
- Weekly on schedule (Monday 3am)
- Manual dispatch when needed
- Not on every main push (dependencies change rarely)

* Update latex-requirements.txt

* Disable Google Colab workflow for testing phase

Renamed collab.yml to collab.yml.disabled to prevent execution during cache migration testing

Author: mmcky

.github/workflows/cache.yml

@@ -10,41 +10,39 @@ jobs:
     steps:
       - name: Checkout
         uses: actions/checkout@v5
-      - name: Setup Anaconda
-        uses: conda-incubator/setup-miniconda@v3
+      
+      # Use composite action for environment setup
+      - name: Setup Lecture Environment
+        uses: quantecon/actions/setup-lecture-env@main
         with:
-          auto-update-conda: true
-          auto-activate-base: true
-          miniconda-version: 'latest'
-          python-version: "3.13"
-          environment-file: environment.yml
-          activate-environment: quantecon
+          python-version: '3.13'
+          environment-file: 'environment.yml'
+          environment-name: 'quantecon'
+      
       - name: graphviz Support # TODO: required?
         run: |
           sudo apt-get -qq update && sudo apt-get install -y graphviz
-      - name: Install latex dependencies
-        run: |
-          sudo apt-get -qq update
-          sudo apt-get install -y     \
-            texlive-latex-recommended \
-            texlive-latex-extra       \
-            texlive-fonts-recommended \
-            texlive-fonts-extra       \
-            texlive-xetex             \
-            latexmk                   \
-            xindy                     \
-            dvipng                    \
-            cm-super
+      
+      # Use composite action for LaTeX setup
+      - name: Install LaTeX Dependencies
+        uses: quantecon/actions/setup-latex@main
+      
+      # Use composite action for building
       - name: Build HTML
-        shell: bash -l {0}
-        run: |
-          jb build lectures --path-output ./ -W --keep-going
+        id: build
+        uses: quantecon/actions/build-lectures@main
+        with:
+          builder: 'html'
+          source-dir: 'lectures'
+          extra-args: '-W --keep-going'
+      
       - name: Upload Execution Reports (HTML)
         uses: actions/upload-artifact@v5
         if: failure()
         with:
           name: execution-reports
           path: _build/html/reports
+      
       - name: Upload "_build" folder (cache)
         uses: actions/upload-artifact@v5
         with:

.github/workflows/collab.yml renamed to .github/workflows/collab.yml.disabled

@@ -0,0 +1,21 @@
+# LaTeX packages required for Jupyter Book PDF builds
+# Version pinning ensures reproducibility and explicit cache invalidation
+# Last updated: 2025-11-07
+# TexLive: 2023 (Ubuntu 24.04 LTS Noble ships with 2023.20240207-1)
+# Reference: https://packages.ubuntu.com/noble/texlive-base
+
+# Core LaTeX distribution (TexLive 2023)
+texlive-latex-recommended=2023.20240207-1
+texlive-latex-extra=2023.20240207-1
+texlive-fonts-recommended=2023.20240207-1
+texlive-fonts-extra=2023.20240207-1
+texlive-xetex=2023.20240207-1
+texlive-luatex=2023.20240207-1
+
+# Build tools
+# Note: Versions will be determined on first run
+latexmk
+xindy
+dvipng
+ghostscript
+cm-super