Server side rendering of math equations (KaTeX)

README.md

@@ -169,14 +169,25 @@ tags: ["Hugo"]
 ### KaTeX
 Make your mathematical notations pop.
 
-For notations that should appear on their own line, use the block quotes `$$ ... $$`
+Update your site configuration to enable the passthrough extension and define opening and closing delimiters for each passthrough element type, either block or inline. For example:
+
+```
+[markup]
+  [markup.goldmark]
+    [markup.goldmark.extensions]
+      [markup.goldmark.extensions.passthrough]
+        enable = true
+        [markup.goldmark.extensions.passthrough.delimiters]
+          block = [['\[', '\]'], ['$$', '$$']]
+          inline = [['\(', '\)']]
+```
+
+Then, for notations that should appear on their own line, use the block quotes `$$ ... $$`
 
 $$ 5 \times 5 = 25 $$
 
-For notations that should appear on the same line, use the inline quotes `$ ... $`
+For notations that should appear on the same line, use the inline quotes `\( ... \)`
 
-**Note**: *Enabling KaTeX will add external dependencies.*
-
 ### Tabs
 Some content is just better viewed in tabs.  Luckily we have a shortcode for that.
 <p float="left">

layouts/_default/_markup/render-passthrough.html

@@ -0,0 +1,9 @@
+{{- $opts := dict "output" "htmlAndMathml" "displayMode" (eq .Type "block") }}
+{{- with try (transform.ToMath .Inner $opts) }}
+  {{- with .Err }}
+    {{ errorf "Unable to render mathematical markup to HTML using the transform.ToMath function. The KaTeX display engine threw the following error: %s: see %s." . $.Position }}
+  {{- else }}
+    {{- .Value }}
+    {{- $.Page.Store.Set "hasMath" true }}
+  {{- end }}
+{{- end -}}

layouts/partials/head/scripts.html

@@ -3,14 +3,6 @@
       (resources.Get "js/light_dark.js")
       (resources.Get "js/tabs.js") }}
 
-{{/* Locally hosted code for KaTeX */}}
-{{ $js = $js | append
-      (resources.Get "js/lib/katex.js")
-      (resources.Get "js/lib/auto-render.js") }}
-
-{{/* Personal/custom scripts for KaTeX */}}
-{{ $js = $js | append (resources.Get "js/katex.js") }}
-
 {{/* Personal/custom scripts for table of contents */}}
 {{ if not .Site.Params.hideToc }}
     {{ $js = $js | append (resources.Get "js/toc.js") }}