aboutsummaryrefslogtreecommitdiffstatshomepage
diff options
context:
space:
mode:
authorEgor Tensin <Egor.Tensin@gmail.com>2021-03-09 17:38:59 +0300
committerEgor Tensin <Egor.Tensin@gmail.com>2021-03-09 17:52:56 +0300
commit9c44060f0d9dd530a4d90c635da7b83935a1ec19 (patch)
tree9b4863cd1a38c965285506daf561619ee22b869a
parentadd README.md (diff)
downloadjekyll-theme-9c44060f0d9dd530a4d90c635da7b83935a1ec19.tar.gz
jekyll-theme-9c44060f0d9dd530a4d90c635da7b83935a1ec19.zip
MathJax: get rid of the workarond
Kramdown 2.2.0 supports MathJax v3 now.
-rw-r--r--README.md23
-rw-r--r--_includes/common/mathjax.html8
-rw-r--r--_includes/common/mathjax_workaround.md1
3 files changed, 2 insertions, 30 deletions
diff --git a/README.md b/README.md
index 188afe8..760ae02 100644
--- a/README.md
+++ b/README.md
@@ -36,27 +36,8 @@ $$
[MathJax]: https://www.mathjax.org/
-### GitHub workarounds
-
-MathJax version 3 is used, which is unsupported by Kramdown (which produces
-`<script type="math/tex; ..."` tags, suitable only for MathJax 2).
-This is why `math_engine` must be set to `null` in _config.yml in order to make
-Kramdown output block formulas wrapped in `$$` and inline formulas in `$`
-respectively ([inside `<span class="kdmath">` elements][kramdown issue]).
-Because if this, MathJax is additionally customized to recognize `$` as an
-inline formula delimiter in _includes/common/mathjax.html.
-
-GitHub Pages [helpfully overrides] the `math_engine` setting in your
-_config.yml, hardcoding it to `mathjax` instead of `null` (there's a related
-[pull request]).
-I couldn't find a better way than to override the setting in the markdown
-document itself using
-
- {::options math_engine="+nil+" /}
-
-[kramdown issue]: https://github.com/gettalong/kramdown/issues/342
-[helpfully overrides]: https://help.github.com/en/articles/configuring-jekyll
-[pull request]: https://github.com/github/pages-gem/pull/644
+Behind the scenes, Kramdown transforms these to `\(...\)` and `\[...\]`
+sequences, to be processed by MathJax.
History
-------
diff --git a/_includes/common/mathjax.html b/_includes/common/mathjax.html
index 7110f57..e01e380 100644
--- a/_includes/common/mathjax.html
+++ b/_includes/common/mathjax.html
@@ -1,12 +1,4 @@
{% if page.mathjax %}
- <script>
-// See the README.md for explanation:
-MathJax = {
- tex: {
- inlineMath: [['$', '$']]
- }
-};
- </script>
<script src="https://polyfill.io/v3/polyfill.min.js?features=es6"></script>
<script type="text/javascript" id="MathJax-script" async src="https://cdn.jsdelivr.net/npm/mathjax@3/es5/tex-chtml.js"></script>
{% endif %}
diff --git a/_includes/common/mathjax_workaround.md b/_includes/common/mathjax_workaround.md
deleted file mode 100644
index 9d0a77d..0000000
--- a/_includes/common/mathjax_workaround.md
+++ /dev/null
@@ -1 +0,0 @@
-{::options math_engine="+nil+" /}