fix(theme): enable KaTeX auto-render and add robust math shortcodes; partially convert /blog/katex-bug/ examples

Author: n-WN

content/blog/katex_bug.md

@@ -11,33 +11,41 @@ tags = ["demo"]
 > Display exceptions, such as inconsistent trailing commas and local restrictions, being pushed to one line, or not being displayed
 
 ```markdown
-$$\begin{cases} f(x) \equiv V_1(x)^2 \pmod{U_1(x)} \\ f(x) \equiv V_2(x)^2 \pmod{U_2(x)} \\ f(x) \equiv V_3(x)^2 \pmod{U_3(x)} \end{cases}$$
+{% katex_block() %}
+\\begin{cases}
+ f(x) \\equiv V_1(x)^2 \\pmod{U_1(x)} \\\\
+ f(x) \\equiv V_2(x)^2 \\pmod{U_2(x)} \\\\
+ f(x) \\equiv V_3(x)^2 \\pmod{U_3(x)}
+ \\end{cases}
+{% end %}
 ```
 
 $$\begin{cases} f(x) \equiv V_1(x)^2 \pmod{U_1(x)} \\ f(x) \equiv V_2(x)^2 \pmod{U_2(x)} \\ f(x) \equiv V_3(x)^2 \pmod{U_3(x)} \end{cases}$$
 
 ---
 
 ```markdown
-$(\text{order\_candidate} / p_i) \cdot G$
+{% katex() %}(\\text{order\\_candidate} / p_i) \\cdot G{% end %}
 ```
 
 $(\text{order\_candidate} / p_i) \cdot G$
 
 ---
 
 ```markdown
-$$\text{order\_candidate} \leftarrow \frac{\text{order\_candidate}}{p_i}$$
+{% katex_block() %}
+\\text{order\\_candidate} \\leftarrow \\frac{\\text{order\\_candidate}}{p_i}
+{% end %}
 ```
 
 $$\text{order\_candidate} \leftarrow \frac{\text{order\_candidate}}{p_i}$$
 
 ---
 
 ```markdown
-$$
-\text{flag\_chocolate}= (a^m+b^m)\bmod p ,
-$$
+{% katex_block() %}
+\\text{flag\\_chocolate}= (a^m+b^m)\\bmod p ,
+{% end %}
 ```
 
 $$
@@ -47,9 +55,9 @@ $$
 ---
 
 ```markdown
-$$
-q = p_{\text{crypto}}-1\; / \; 2 = 85\,414\,812\,699\,185\,126\,250\,990\,381\,881\,994\,204\,791 .
-$$
+{% katex_block() %}
+q = p_{\\text{crypto}}-1\\; / \\; 2 = 85\\,414\\,812\\,699\\,185\\,126\\,250\\,990\\,381\\,881\\,994\\,204\\,791 .
+{% end %}
 ```
 
 $$
@@ -59,16 +67,12 @@ $$
 ---
 
 ```markdown
-$$
-B=
-\begin{pmatrix}
-2 &        &        &        &        & d_{1,6} \\
-  & 2      &        &        &        & d_{1,7} \\
-  &        & \ddots &        &        & \vdots\\
-  &        &        & 2      &        & d_{17,11}\\
-  &        &        &        & 1 & -M
-\end{pmatrix},
-$$
+{% katex_block() %}
+B=\\begin{pmatrix}
+2 &        &        &        &        & d_{1,6} \\\\
+  & 2      &        &        &        & d_{1,7} \\\\
+  &        & \\ddots &        &        & \\vdots\\\\n+  &        &        & 2      &        & d_{17,11}\\\\n+  &        &        &        & 1 & -M\\end{pmatrix},
+{% end %}
 ```
 
 $$
@@ -85,9 +89,9 @@ $$
 ---
 
 ```markdown
-$$
-S=S_{0}+\sum_{i,k}b_{i,k}\,d_{i,k} - K\,M,
-$$
+{% katex_block() %}
+S=S_{0}+\\sum_{i,k}b_{i,k}\\,d_{i,k} - K\\,M,
+{% end %}
 ```
 
 $$
@@ -97,9 +101,9 @@ $$
 ---
 
 ```markdown
-   $$
-   \text{idek\{ \ldots \}} .
-   $$
+{% katex_block() %}
+\\text{idek\\{ \\ldots \\}} .
+{% end %}
 ```
 
    $$
@@ -109,17 +113,15 @@ $$
 ---
 
 ```markdown
-$$
-m_{\text{min}} = \underbrace{0x20\cdots20}_{20\text{ 个空格}} 
-\qquad
-m_{\text{max}} = \underbrace{0x7E\cdots7E}_{20\text{ 个波浪号}} 
-$$
+{% katex_block() %}
+m_{\\text{min}} = \\underbrace{0x20\\cdots20}_{20\\text{ 个空格}} \\\\
+\\qquad \\\\
+m_{\\text{max}} = \\underbrace{0x7E\\cdots7E}_{20\\text{ 个波浪号}}
+{% end %}
 ```
 
 $$
 m_{\text{min}} = \underbrace{0x20\cdots20}_{20\text{ 个空格}} 
 \qquad
 m_{\text{max}} = \underbrace{0x7E\cdots7E}_{20\text{ 个波浪号}} 
 $$
-
-

static/js/katex_autorender.min.js

@@ -0,0 +1,4 @@
+{# Inline/block KaTeX rendering via client-side katex.render #}
+{%- set display = display | default(value=false) -%}
+<span class="math-katex" data-display="{{ display }}">{{ body | safe }}</span>
+

templates/shortcodes/katex.html

@@ -0,0 +1,3 @@
+{# Block KaTeX rendering via client-side katex.render #}
+<div class="math-katex" data-display="true">{{ body | safe }}</div>
+

templates/shortcodes/katex_block.html

@@ -0,0 +1,29 @@
+{# Local KaTeX auto-render for standard delimiters and robust shortcode rendering #}
+{%- if macros_settings::evaluate_setting_priority(setting="katex", page=page | default(value=""), section=section | default(value=""), default_global_value=false) == "true" -%}
+    <script defer src="{{ get_url(path='js/katex_autorender.min.js', trailing_slash=false) | safe }}"></script>
+    <script>
+    document.addEventListener("DOMContentLoaded", function() {
+        try {
+            if (typeof renderMathInElement === 'function') {
+                renderMathInElement(document.body, {
+                    delimiters: [
+                        {left: "$$", right: "$$", display: true},
+                        {left: "\\(", right: "\\)", display: false},
+                        {left: "\\[", right: "\\]", display: true}
+                    ],
+                    ignoredTags: ["script","noscript","style","textarea","pre","code","option"],
+                });
+            }
+        } catch (e) { /* no-op */ }
+
+        // Fallback: render shortcodes that avoid Markdown interference
+        if (window.katex) {
+            document.querySelectorAll('.math-katex').forEach(function(el){
+                try {
+                    window.katex.render(el.textContent, el, { displayMode: (el.dataset.display === 'true') });
+                } catch (e) { /* ignore parse errors */ }
+            });
+        }
+    });
+    </script>
+{%- endif -%}