MathJax: enable via kramdown + layout scripts; add Codex page and nav; add math overflow CSS

recursionlab · recursionlab · commit 9825f1ce27a1 · 2025-09-19T19:00:02.000Z
diff --git a/Eye of the Cosmos.png b/Eye of the Cosmos.png
diff --git a/_config.yml b/_config.yml
@@ -61,6 +61,8 @@ incremental: false
 # Markdown Processing
 kramdown:
   input: GFM
+  math_engine: mathjax
+  math_engine_opts: {}
   hard_wrap: false
   auto_ids: true
   footnote_nr: 1
diff --git a/_data/navigation.yml b/_data/navigation.yml
@@ -3,5 +3,7 @@ main:
     url: /blog/
   - title: "Projects"
     url: /projects/
+  - title: "Codex"
+    url: /codex/
   - title: "About"
     url: /about/
diff --git a/_layouts/default.html b/_layouts/default.html
@@ -27,6 +27,10 @@
     {% if site.tags != "" %}
   {% include collecttags.html %}
 {% endif %}
+
+    <!-- MathJax v3 -->
+    <script src="{{ '/assets/js/mathjax-config.js' | relative_url }}"></script>
+    <script async id="MathJax-script" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml.js"></script>
   </head>
 
   <body class="layout--{{ page.layout | default: layout.layout }}{% if page.classes or layout.classes %}{{ page.classes | default: layout.classes | join: ' ' | prepend: ' ' }}{% endif %}">
diff --git a/_pages/codex.md b/_pages/codex.md
@@ -0,0 +1,6 @@
+---
+layout: page
+title: Codex
+permalink: /codex/
+---
+
diff --git a/assets/css/main.scss b/assets/css/main.scss
@@ -44,3 +44,9 @@ $susy: (
 @import "slimmenu";
 @import "post";
 @import "page";
+
+/* Avoid horizontal overflow for math renderers */
+.katex-display, .MathJax, .mjx-container {
+  overflow-x: auto;
+  overflow-y: hidden;
+}
diff --git a/assets/js/mathjax-config.js b/assets/js/mathjax-config.js
@@ -0,0 +1,10 @@
+window.MathJax = {
+  tex: {
+    inlineMath: [['$', '$'], ['\\(', '\\)']],
+    displayMath: [['$$', '$$'], ['\\[', '\\]']],
+    processEscapes: true
+  },
+  options: {
+    skipHtmlTags: ['script', 'noscript', 'style', 'textarea', 'pre', 'code']
+  }
+};
