Merge branch 'main' into copilot/fix-407

Author: mmcky

.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
@@ -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@v5
+      - name: Upload Pages artifact
+        uses: actions/upload-pages-artifact@v3
         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@v4
       - name: Prepare lecture-python-programming.notebooks sync
         shell: bash -l {0}
         run: |

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

@@ -1,5 +1,6 @@
 # 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:
@@ -8,18 +9,22 @@ on:
     paths:
       - 'lectures/**/*.md'
       - 'lectures/_toc.yml'
+  issue_comment:
+    types: [created]
 
 jobs:
   sync:
-    if: github.event.pull_request.merged == true
+    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.11.1
+      - uses: QuantEcon/action-translation@v0.13.0
         with:
           mode: sync
           target-repo: QuantEcon/lecture-python-programming.fa

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

@@ -1,5 +1,6 @@
 # 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:
@@ -8,18 +9,22 @@ on:
     paths:
       - 'lectures/**/*.md'
       - 'lectures/_toc.yml'
+  issue_comment:
+    types: [created]
 
 jobs:
   sync:
-    if: github.event.pull_request.merged == true
+    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.11.1
+      - uses: QuantEcon/action-translation@v0.13.0
         with:
           mode: sync
           target-repo: QuantEcon/lecture-python-programming.zh-cn

lectures/_config.yml

@@ -26,7 +26,8 @@ sphinx:
                        'https://data.oecd.org/',
                        'https://www.reddit.com/',
                        'https://openai.com',
-                       'https://chatgpt.com/']
+                       'https://chatgpt.com/',
+                       'https://fred.stlouisfed.org/.*']
     nb_merge_streams: true
     # sphinx-exercise
     exercise_style: "solution_follow_exercise"

lectures/pandas.md

@@ -169,7 +169,7 @@ The dataset contains the following indicators
 We'll read this in from a URL using the `pandas` function `read_csv`.
 
 ```{code-cell} ipython3
-df = pd.read_csv('https://raw.githubusercontent.com/QuantEcon/lecture-python-programming/master/source/_static/lecture_specific/pandas/data/test_pwt.csv')
+df = pd.read_csv('https://raw.githubusercontent.com/QuantEcon/lecture-python-programming/main/lectures/_static/lecture_specific/pandas/data/test_pwt.csv')
 type(df)
 ```