Replace math images with MathJAX.

pawchen · pawchen · commit 8620871a139f · 2026-06-12T14:01:54.000+08:00
diff --git a/converter/generator/DocToStaticPagesTransformer.cs b/converter/generator/DocToStaticPagesTransformer.cs
@@ -80,7 +80,16 @@ protected internal override void Transform(IHtmlDocument document, IHtmlHeadElem
 
     protected override IHtmlElement? TransformImage(IHtmlDocument document, IHtmlImageElement img, string sourceFile, string sourceDir)
     {
-        if (base.TransformImage(document, img, sourceFile, sourceDir) is IHtmlElement transformed)
+        if (img.ClassList.Contains("tex"))
+        {
+            var span = document.CreateElement<IHtmlSpanElement>();
+
+            span.ClassName = "tex";
+            span.TextContent = $"\\({img.AlternativeText}\\)";
+
+            return span;
+        }
+        else if (base.TransformImage(document, img, sourceFile, sourceDir) is IHtmlElement transformed)
         {
             transformed.SetAttribute("loading", "lazy");
 
diff --git a/converter/generator/DocTransformer.cs b/converter/generator/DocTransformer.cs
@@ -93,12 +93,18 @@ internal protected virtual void Transform(IHtmlDocument document, IHtmlHeadEleme
 
         foreach (var a in document.Descendants<IHtmlAnchorElement>())
         {
-            TransformAnchor(document, a, sourceFile, sourceDir);
+            if (TransformAnchor(document, a, sourceFile, sourceDir) is IHtmlElement transformed && transformed != a)
+            {
+                a.Replace(transformed);
+            }
         }
 
         foreach (var img in document.Descendants<IHtmlImageElement>())
         {
-            TransformImage(document, img, sourceFile, sourceDir);
+            if (TransformImage(document, img, sourceFile, sourceDir) is IHtmlElement transformed && transformed != img)
+            {
+                img.Replace(transformed);
+            }
         }
     }
 
diff --git a/converter/templates/Layouts/Site.cshtml b/converter/templates/Layouts/Site.cshtml
@@ -13,11 +13,11 @@
     <script src="https://cdn.jsdelivr.net/npm/bootstrap@3.4.1/dist/js/bootstrap.min.js" integrity="sha384-aJ21OjlMXNL5UyIl/XNwTMqvzeRMZH2w8c5cRVpzpU8Y5bApTppSuUkhZXN0VxHd" crossorigin="anonymous"></script>
     <script src="~/global/originlab.js" asp-append-version="true"></script>
 
-    <script src='https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.4/MathJax.js?config=TeX-MML-AM_CHTML'></script>
-
     <link href="~/books/style.css" asp-append-version="true" rel="stylesheet" />
     <script src="~/books/script.js" asp-append-version="true"></script>
 
+    <script src='https://cdnjs.cloudflare.com/ajax/libs/mathjax/2.7.4/MathJax.js?config=TeX-MML-AM_CHTML'></script>
+
     @RenderSection("head", required: false)
 </head>
 <body>
diff --git a/converter/templates/wwwroot/books/script.js b/converter/templates/wwwroot/books/script.js
@@ -39,21 +39,6 @@ function searchDoc(lang, inputId, selectId) {
     document.location.replace(searchUrl);
 }
 
-function applyNavMenuData(dataId, groupId, minItems) {
-    let dataElement = document.getElementById(dataId);
-    if (!dataElement || dataElement.children.length < minItems) {
-        document.getElementById(groupId)?.querySelector('button')?.classList.add('disabled');
-    } else {
-        let ul = document.getElementById(groupId)?.querySelector('ul');
-        if (ul) {
-            ul.replaceChildren(...dataElement.childNodes);
-            if (ul.childNodes.length > 20) {
-                ul.classList.add('pre-scrollable');
-            }
-        }
-    }
-}
-
 (function () {
     let nav = document.getElementById('doc-nav-data');
 
@@ -89,6 +74,28 @@ function applyNavMenuData(dataId, groupId, minItems) {
         nav.appendChild(data);
     }
 
+    function applyNavMenuData(dataId, groupId, minItems) {
+        let dataElement = document.getElementById(dataId);
+        if (!dataElement || dataElement.children.length < minItems) {
+            document.getElementById(groupId)?.querySelector('button')?.classList.add('disabled');
+        } else {
+            let ul = document.getElementById(groupId)?.querySelector('ul');
+            if (ul) {
+                ul.replaceChildren(...dataElement.childNodes);
+                if (ul.childNodes.length > 20) {
+                    ul.classList.add('pre-scrollable');
+                }
+            }
+        }
+    }
+
     applyNavMenuData('doc-siblings-data', 'doc-nav-siblings', 2);
     applyNavMenuData('doc-children-data', 'doc-nav-children', 1);
 })();
+
+window.MathJax = {
+    options: {
+        processHtmlClass: 'tex',
+        ignoreHtmlClass: '.*'
+    }
+};

Original file line number	Diff line number	Diff line change
`@@ -93,12 +93,18 @@ internal protected virtual void Transform(IHtmlDocument document, IHtmlHeadEleme`
`93`	`93`
`94`	`94`	`foreach (var a in document.Descendants<IHtmlAnchorElement>())`
`95`	`95`	`{`
`96`		`- TransformAnchor(document, a, sourceFile, sourceDir);`
	`96`	`+ if (TransformAnchor(document, a, sourceFile, sourceDir) is IHtmlElement transformed && transformed != a)`
	`97`	`+ {`
	`98`	`+ a.Replace(transformed);`
	`99`	`+ }`
`97`	`100`	`}`
`98`	`101`
`99`	`102`	`foreach (var img in document.Descendants<IHtmlImageElement>())`
`100`	`103`	`{`
`101`		`- TransformImage(document, img, sourceFile, sourceDir);`
	`104`	`+ if (TransformImage(document, img, sourceFile, sourceDir) is IHtmlElement transformed && transformed != img)`
	`105`	`+ {`
	`106`	`+ img.Replace(transformed);`
	`107`	`+ }`
`102`	`108`	`}`
`103`	`109`	`}`
`104`	`110`