Merge branch 'main' into jb2

# Conflicts:
#	.github/workflows/ci.yml
#	lectures/need_for_speed.md
#	lectures/numba.md
#	lectures/numpy_vs_numba_vs_jax.md

Author: mmcky

.github/workflows/cache.yml

@@ -33,13 +33,13 @@ jobs:
         run: |
           jb build lectures --path-output ./ -W --keep-going
       - name: Upload Execution Reports
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         if: failure()
         with:
           name: execution-reports
           path: _build/html/reports
       - name: Upload "_build" folder (cache)
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         with:
           name: build-cache
           path: _build

.github/workflows/execution-linux.yml

@@ -32,7 +32,7 @@ jobs:
         shell: bash -l {0}
         run: jb build lectures --path-output=./ -W --keep-going
       - name: Upload Execution Reports
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         if: failure()
         with:
           name: execution-reports

.github/workflows/execution-osx.yml

@@ -32,7 +32,7 @@ jobs:
         shell: bash -l {0}
         run: jb build lectures --path-output=./ -W --keep-going
       - name: Upload Execution Reports
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         if: failure()
         with:
           name: execution-reports

.github/workflows/execution-win.yml

@@ -37,7 +37,7 @@ jobs:
         shell: powershell
         run: jb build lectures --path-output=./ -W --keep-going
       - name: Upload Execution Reports
-        uses: actions/upload-artifact@v6
+        uses: actions/upload-artifact@v7
         if: failure()
         with:
           name: execution-reports

.github/workflows/linkcheck.yml

@@ -11,15 +11,23 @@ jobs:
     permissions:
       issues: write   # required for QuantEcon link-checker
     steps:
-      # Checkout the live site (html)
-      - name: Checkout
-        uses: actions/checkout@v6
-        with:
-          ref: gh-pages
+      # Download the latest release HTML archive (permanent, not subject to artifact expiry)
+      - name: Get latest release asset URL
+        id: release
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          ASSET_URL=$(gh api repos/${{ github.repository }}/releases/latest \
+            --jq '.assets[] | select(.name | endswith(".tar.gz")) | .browser_download_url')
+          echo "asset-url=$ASSET_URL" >> $GITHUB_OUTPUT
+      - name: Download and extract release HTML
+        run: |
+          mkdir -p _site
+          curl -sL "${{ steps.release.outputs.asset-url }}" | tar -xz -C _site
       - name: AI-Powered Link Checker
         uses: QuantEcon/action-link-checker@main
         with:
-          html-path: '.'            # gh-pages live html
+          html-path: '_site'
           fail-on-broken: 'false'
           silent-codes: '403,503'
           ai-suggestions: 'true'

.github/workflows/publish.yml

@@ -3,10 +3,24 @@ on:
   push:
     tags:
       - 'publish*'
+
+permissions:
+  contents: write
+  actions: read
+  pages: write
+  id-token: write
+
+concurrency:
+  group: "pages"
+  cancel-in-progress: false
+
 jobs:
   publish:
     if: github.event_name == 'push' && startsWith(github.event.ref, 'refs/tags')
     runs-on: "runs-on=${{ github.run_id }}/family=g4dn.2xlarge/image=quantecon_ubuntu2404/disk=large"
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
     steps:
       - name: Checkout
         uses: actions/checkout@v6
@@ -52,7 +66,7 @@ jobs:
         run: pip list
       # Download Build Cache from cache.yml
       - name: Download "build" folder (cache)
-        uses: dawidd6/action-download-artifact@v12
+        uses: dawidd6/action-download-artifact@v20
         with:
           workflow: cache.yml
           branch: main
@@ -73,7 +87,7 @@ jobs:
         run: |
           jb build lectures --path-output ./ --builder=custom --custom-builder=jupyter -n -W --keep-going
           zip -r download-notebooks.zip _build/jupyter
-      - uses: actions/upload-artifact@v6
+      - uses: actions/upload-artifact@v7
         with:
           name: download-notebooks
           path: download-notebooks.zip
@@ -113,12 +127,17 @@ jobs:
             html-manifest.json
         env:
           GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
-      - name: Deploy website to gh-pages
-        uses: peaceiris/actions-gh-pages@v4
+      - name: Add CNAME for custom domain
+        run: echo "python-programming.quantecon.org" > _build/html/CNAME
+      - name: Setup Pages
+        uses: actions/configure-pages@v6
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v4
         with:
-          github_token: ${{ secrets.GITHUB_TOKEN }}
-          publish_dir: _build/html/
-          cname: python-programming.quantecon.org
+          path: _build/html/
+      - name: Deploy to GitHub Pages
+        id: deployment
+        uses: actions/deploy-pages@v5
       - name: Prepare lecture-python-programming.notebooks sync
         shell: bash -l {0}
         run: |

.github/workflows/sync-translations-fa.yml

@@ -0,0 +1,35 @@
+# Sync Translations — Farsi
+# On merged PR, translate changed lectures into the Farsi target repo.
+# Comment \translate-resync on a merged PR to re-trigger sync.
+name: Sync Translations (Farsi)
+
+on:
+  pull_request:
+    types: [closed]
+    paths:
+      - 'lectures/**/*.md'
+      - 'lectures/_toc.yml'
+  issue_comment:
+    types: [created]
+
+jobs:
+  sync:
+    if: >
+      (github.event_name == 'pull_request' && github.event.pull_request.merged == true) ||
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '\translate-resync'))
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 2
+
+      - uses: QuantEcon/action-translation@v0.14.1
+        with:
+          mode: sync
+          target-repo: QuantEcon/lecture-python-programming.fa
+          target-language: fa
+          source-language: en
+          docs-folder: lectures
+          anthropic-api-key: ${{ secrets.ANTHROPIC_API_KEY }}
+          github-token: ${{ secrets.QUANTECON_SERVICES_PAT }}

.github/workflows/sync-translations-zh-cn.yml

@@ -0,0 +1,35 @@
+# Sync Translations — Simplified Chinese
+# On merged PR, translate changed lectures into the zh-cn target repo.
+# Comment \translate-resync on a merged PR to re-trigger sync.
+name: Sync Translations (Simplified Chinese)
+
+on:
+  pull_request:
+    types: [closed]
+    paths:
+      - 'lectures/**/*.md'
+      - 'lectures/_toc.yml'
+  issue_comment:
+    types: [created]
+
+jobs:
+  sync:
+    if: >
+      (github.event_name == 'pull_request' && github.event.pull_request.merged == true) ||
+      (github.event_name == 'issue_comment' && contains(github.event.comment.body, '\translate-resync'))
+    runs-on: ubuntu-latest
+
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 2
+
+      - uses: QuantEcon/action-translation@v0.14.1
+        with:
+          mode: sync
+          target-repo: QuantEcon/lecture-python-programming.zh-cn
+          target-language: zh-cn
+          source-language: en
+          docs-folder: lectures
+          anthropic-api-key: ${{ secrets.ANTHROPIC_API_KEY }}
+          github-token: ${{ secrets.QUANTECON_SERVICES_PAT }}

_notebook_repo/README.md

@@ -4,4 +4,4 @@
 
 Notebooks for https://python-programming.quantecon.org
 
-**Note:** This README should be edited [here](https://github.com/quantecon/lecture-python-programming.myst/.binder)
+**Note:** This README should be edited [here](https://github.com/quantecon/lecture-python-programming/.binder)

environment.yml

@@ -7,11 +7,11 @@ dependencies:
   - pip
   - pip:
     - jupyter-book>=1.0.4post1,<2.0
-    - quantecon-book-theme==0.15.1
+    - quantecon-book-theme==0.20.0
     - sphinx-tojupyter==0.6.0
     - sphinxext-rediraffe==0.3.0
     - sphinx-exercise==1.2.1
-    - sphinxcontrib-youtube==1.4.1
-    - sphinx-togglebutton==0.3.2
+    - sphinxcontrib-youtube==1.5.0
+    - sphinx-togglebutton==0.4.5