Theme pin is a release behind: KaTeX fonts 404 on the live site

[mmcky]

The site pins the lecture theme at v2.3.0. v2.3.1 was published on 2026-08-26 and carries two fixes this site needs.

lectures/myst.yml:122 pins https://github.com/QuantEcon/quantecon-theme.mystmd/releases/download/v2.3.0/quantecon-theme.zip, last bumped in eb1fd89 on 2026-08-20.

What is broken today

The deployed stylesheet build/_assets/katex.min-STXY5V2I.css contains 60 references of the form url(/myst_assets_folder/_assets/KaTeX_*). All of them 404 — verified against the live site on 2026-09-04:

$ curl -o /dev/null -w '%{http_code}' https://quantecon.github.io/lecture-wasm/myst_assets_folder/_assets/KaTeX_Main-Regular-B22Nviop.woff2
404

Every maths glyph on the site therefore falls back to a system font. This is QuantEcon/quantecon-theme.mystmd#138, fixed by QuantEcon/quantecon-theme.mystmd#139 ("make built stylesheet asset URLs relative so static builds resolve them") and released in v2.3.1.

The same release also carries QuantEcon/quantecon-theme.mystmd#137, the fix for code cells nested inside a directive never registering with the kernel (QuantEcon/quantecon-theme.mystmd#117).

The change

Bump the pin in lectures/myst.yml:122 to v2.3.1.

While there, the workaround in lectures/short_path.md:276-281 was added for the nested-code-cell defect and can be reverted once the theme carries the fix.

Not this issue

#56 (root-relative /myst-theme.css, favicon and service-worker URLs ignoring BASE_URL) is a separate defect in this repository's own configuration and is not fixed by the bump.

[mmcky]

Retargeting this to v2.4.0, released 2026-09-04 (quantecon-theme.zip attached).

Bump lectures/myst.yml:122 to .../releases/download/v2.4.0/quantecon-theme.zip rather than v2.3.1. v2.4.0 carries everything v2.3.1 did plus two things that matter here:

• fix: rewrite asset URLs in route stylesheets, not just those in _assets/ quantecon-theme.mystmd#151 completes the asset-URL fix. v2.3.1 fixed the stylesheets in _assets/ — which is where the KaTeX CSS lives, so it does resolve the 60 font 404s described above — but four route and shared-chunk stylesheets still shipped with an absolute --jp-icon-plotly URL. A production build now emits zero absolute asset URLs, with all 78 references resolving.
• feat(styles): match lecture content typography to the existing builds quantecon-theme.mystmd#155 fixes inline code rendering wrapped in literal backticks, which affected every code span on every page.

So this becomes one bump to a fully-correct release instead of a bump to v2.3.1 followed by another.

The lectures/short_path.md:276-281 workaround and the note about #56 being a separate defect both still stand.

Ownership for this class of drift is now tracked at QuantEcon/workspace-lectures#63 — the site.template URL has no package ecosystem behind it, so no bot will ever open a bump PR for it, which is how this went unnoticed for nine days.

[mmcky]

Retargeting to v2.5.0, released 2026-09-05. The v2.4.0 target went stale the day after it was set; v2.5.0 carries everything v2.3.1 and v2.4.0 did, plus the Sphinx-matching heading typography and link colour, an icon-only search trigger, a Colab-only launcher (this site never configured the Private JupyterHub option it removes) and accessible names on every toolbar control.

The font 404 is still live as of this morning:

$ curl -o /dev/null -w '%{http_code}' https://quantecon.github.io/lecture-wasm/myst_assets_folder/_assets/KaTeX_Main-Regular-B22Nviop.woff2
404

#72 bumps the pin and reverts the short_path workaround in the same change, since QuantEcon/quantecon-theme.mystmd#117 shipped in v2.3.1. Tracked estate-wide under QuantEcon/workspace-lectures#63.

[mmcky]

Fixed by #72, merged 2026-09-07 as 632cbcd and deployed to GitHub Pages in https://github.com/QuantEcon/lecture-wasm/actions/runs/34070965332.

The site now pins the lecture theme at v2.5.0. The deployed KaTeX stylesheet references its fonts relatively (url(./KaTeX_Main-Regular-ARRPAO67.woff2) in build/_assets/katex.min-STXY5V2I.css, resolving 200), so the 60 absolute /myst_assets_folder/ references and their 404s are gone. The short_path graph-data cell is back inside its exercise, since the nested-code-cell fix (QuantEcon/quantecon-theme.mystmd#117) shipped in v2.3.1.

#56 (root-relative myst-theme.css, favicon and service-worker URLs ignoring BASE_URL) is unchanged by this and stays open.