ai-agent-book 精选快照（<2MB 代码与文档，来自 github.com/bojieli/ai-agent-book）

extras/mathjax.js

@@ -0,0 +1,37 @@
+/**
+ * MathJax 3 configuration for MkDocs Material.
+ *
+ * This file MUST be loaded before the MathJax bundle
+ * (`tex-mml-chtml.js`) in mkdocs.yml `extra_javascript` — MathJax reads
+ * `window.MathJax` once at startup, so setting it afterwards has no effect.
+ *
+ * `pymdownx.arithmatex` (generic mode) rewrites the book's `$...$` and
+ * `$$...$$` source math into `\(...\)` / `\[...\]` wrapped in
+ * `<span class="arithmatex">` / `<div class="arithmatex">`. MathJax's
+ * default delimiters are `$...$`/`$$...$$`, which no longer exist in the
+ * rendered HTML, so without this config nothing is typeset at all.
+ */
+window.MathJax = {
+  tex: {
+    inlineMath: [['\\(', '\\)']],
+    displayMath: [['\\[', '\\]']],
+    processEscapes: true,
+    processEnvironments: true,
+  },
+  options: {
+    // Only typeset elements arithmatex marked as math; ignore everything
+    // else (code blocks, search summaries, etc.).
+    ignoreHtmlClass: '.*|',
+    processHtmlClass: 'arithmatex',
+  },
+};
+
+// Material's `navigation.instant` swaps page content without a full reload,
+// so MathJax must re-typeset after every page swap (same pattern as
+// extras/mermaid-init.js).
+document$.subscribe(() => {
+  MathJax.startup.output.clearCache();
+  MathJax.typesetClear();
+  MathJax.texReset();
+  MathJax.typesetPromise();
+});