Skip to content

Commit 0fa514a

Browse files
aarmeyclaude
andcommitted
fix: Re-typeset MathJax equations after instant navigation
The theme enables navigation.instant, which swaps page content via client-side fetch instead of a full page load. MathJax's default startup only typesets once on initial load, so pymdownx.arithmatex equations on any page reached via instant navigation stayed as raw LaTeX source instead of rendering. Add docs/javascripts/mathjax.js, which configures MathJax's tex delimiters/options to match arithmatex's generic mode and subscribes to document$ (mkdocs-material's instant-navigation event) to clear and re-typeset MathJax on every page swap, per mkdocs-material's documented MathJax + instant navigation setup. Load it before the polyfill/MathJax CDN scripts in extra_javascript. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
1 parent d2525a7 commit 0fa514a

2 files changed

Lines changed: 20 additions & 0 deletions

File tree

‎docs/javascripts/mathjax.js‎

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,19 @@
1+
window.MathJax = {
2+
tex: {
3+
inlineMath: [["\\(", "\\)"]],
4+
displayMath: [["\\[", "\\]"]],
5+
processEscapes: true,
6+
processEnvironments: true
7+
},
8+
options: {
9+
ignoreHtmlClass: ".*|",
10+
processHtmlClass: "arithmatex"
11+
}
12+
};
13+
14+
document$.subscribe(() => {
15+
MathJax.startup.output.clearCache();
16+
MathJax.typesetClear();
17+
MathJax.texReset();
18+
MathJax.typesetPromise();
19+
});

‎mkdocs.yml‎

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -72,5 +72,6 @@ markdown_extensions:
7272
- md_in_html
7373

7474
extra_javascript:
75+
- javascripts/mathjax.js
7576
- https://polyfill.io/v3/polyfill.min.js?features=es6
7677
- https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js

0 commit comments

Comments
 (0)