feat: add pelican-render-math plugin

Author: Swiftb0y

netlify.toml

@@ -48,5 +48,5 @@
 [[headers]]
  for = "/news/*"
  [headers.values]
-   # Additionally allow YouTube/Discourse frames and scripts
-    Content-Security-Policy = "default-src 'self'; style-src 'self' 'unsafe-inline'; script-src 'self' 'sha256-UPkidoMErzWw1gW/eY4LhAi9ZkPch3PP31d6KQoJ6Yc='  'sha256-G40wI6OaLZXCtrb02xUq1H1kEVWjstzoQ0FXKwsWxPw='	https://mixxx.discourse.group/javascripts/embed.js *.discourse-cdn.com; frame-src 'self' https://www.youtube-nocookie.com https://mixxx.discourse.group ; img-src 'self' https://i.ytimg.com ; connect-src 'self' https://mixxx.discourse.group https://*.discourse-cdn.com"
+   # Additionally allow YouTube/Discourse frames and scripts and MathJax
+    Content-Security-Policy = "default-src 'self'; style-src 'self' 'unsafe-inline'; script-src 'self' 'sha256-UPkidoMErzWw1gW/eY4LhAi9ZkPch3PP31d6KQoJ6Yc='  'sha256-G40wI6OaLZXCtrb02xUq1H1kEVWjstzoQ0FXKwsWxPw='	 'sha256-NoYDhgfdmQGg59XPik/7lIF57F0zlpWNHiB+uKc1Lc8=' https://mixxx.discourse.group/javascripts/embed.js *.discourse-cdn.com cdn.jsdelivr.net; frame-src 'self' https://www.youtube-nocookie.com https://mixxx.discourse.group ; img-src 'self' https://i.ytimg.com ; connect-src 'self' https://mixxx.discourse.group https://*.discourse-cdn.com"

pelicanconf.py

@@ -89,8 +89,15 @@
     "download_metadata",
     "draft_override",
     "md_yaml",
+    "render_math",
 ]
 
+MATH_JAX = {
+    # Disable auto_insert because we insert our own MathJax3 <script> into the needed articles.
+    # This also means that any settings created here are not relayed to mathjax (see templates/article.html instead)
+    "auto_insert": False,
+}
+
 
 class MenuItem:
     def __init__(self, url, title, context, css="", children=()):

requirements.txt

@@ -9,6 +9,7 @@ markdown-full-yaml-metadata @ git+https://github.com/Holzhaus/python-markdown-fu
 Markdown-Video @ git+https://github.com/Holzhaus/Python-Markdown-Video@98725ee09995fdeb05597d82defacaa7ceeca546
 MarkupSafe==2.1.3
 pelican==4.9.1
+pelican-render-math==1.0.4
 Pygments==2.17.2
 python-dateutil==2.8.2
 pytz==2023.3.post1

theme/templates/article.html

@@ -68,5 +68,9 @@ <h4>{% trans %}Comments{% endtrans %}</h4>
 {% block extra_head %}
 {% if article.comments and article.comments in ("true", "yes") %}
 <script src="{{ SITEURL }}/theme/js/discourse.js"></script>
+{% if article.math and article.math in ("true", "yes") %}
+{# mathjax version is pinned for security and version 2.7.9 because pelican-render-math likely doesn't support MathJax 3#}
+<script id="MathJax-script" type="text/javascript" src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-svg.js"></script>
+{% endif %}
 {% endif %}
 {% endblock %}