include mathjax

Author: overheadhunter

assets/js/mathjax-config.js

@@ -0,0 +1,9 @@
+MathJax = {
+  tex: {
+    displayMath: [['\\[', '\\]'], ['$$', '$$']],  // block
+    inlineMath: [['\\(', '\\)']]                  // inline
+  },
+  chtml: {
+    fontURL: '/webfonts/mathjax',
+  }
+};

hugo.toml

@@ -61,13 +61,29 @@ theme = ["hugo-admonitions"]
     source = "node_modules/altcha/dist_external"
     target = "assets/js/altcha"
 
-[markup.goldmark.renderer]
-unsafe = true
+  [[module.mounts]]
+    source = "node_modules/mathjax/es5"
+    target = "assets/js/mathjax"
 
-[markup.goldmark.parser.attribute]
-block = true
+  [[module.mounts]]
+    source = "node_modules/mathjax/es5/output/chtml/fonts/woff-v2"
+    target = "static/webfonts/mathjax"
+
+[markup]
+  [markup.goldmark]
+    [markup.goldmark.extensions]
+      [markup.goldmark.extensions.passthrough]
+        enable = true
+        [markup.goldmark.extensions.passthrough.delimiters]
+          block = [['\[', '\]'], ['$$', '$$']]
+          inline = [['\(', '\)']]
+      [markup.goldmark.renderer]
+      unsafe = true
+      [markup.goldmark.parser.attribute]
+      block = true
 
 [params]
+  math = false # set to true in frontmatter if required
   [params.releases]
     [params.releases.exe]
       version = "1.17.0"

layouts/_default/baseof.html

@@ -109,5 +109,11 @@
     <script type="text/javascript" src="{{ $alpine.RelPermalink }}" integrity="{{ $alpine.Data.Integrity }}" defer></script>
     {{ $lazysizes := resources.Get "js/lazysizes/lazysizes.min.js" | fingerprint }}
     <script type="text/javascript" src="{{ $lazysizes.RelPermalink }}" integrity="{{ $lazysizes.Data.Integrity }}" async></script>
+    {{ if .Param "math" }}
+      {{ $mjconfig := resources.Get "js/mathjax-config.js" | fingerprint }}
+      <script type="text/javascript" src="{{ $mjconfig.RelPermalink }}" integrity="{{ $mjconfig.Data.Integrity }}"></script>
+      {{ $mathjax := resources.Get "js/mathjax/tex-chtml.js" | fingerprint }}
+      <script type="text/javascript" src="{{ $mathjax.RelPermalink }}" integrity="{{ $mathjax.Data.Integrity }}"></script>
+    {{ end }}
   </body>
 </html>

package-lock.json

@@ -28,6 +28,7 @@
     "altcha": "^1.4.2",
     "jquery": "^3.7.1",
     "js-yaml": "^4.1.0",
-    "lazysizes": "^5.3.2"
+    "lazysizes": "^5.3.2",
+    "mathjax": "^3.2.2"
   }
 }