diff options
| author | Egor Tensin <Egor.Tensin@gmail.com> | 2021-03-09 17:38:59 +0300 |
|---|---|---|
| committer | Egor Tensin <Egor.Tensin@gmail.com> | 2021-03-09 17:52:56 +0300 |
| commit | 9c44060f0d9dd530a4d90c635da7b83935a1ec19 (patch) | |
| tree | 9b4863cd1a38c965285506daf561619ee22b869a | |
| parent | add README.md (diff) | |
| download | jekyll-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.md | 23 | ||||
| -rw-r--r-- | _includes/common/mathjax.html | 8 | ||||
| -rw-r--r-- | _includes/common/mathjax_workaround.md | 1 |
3 files changed, 2 insertions, 30 deletions
@@ -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+" /} |