diff options
| author | Rudolf Adamkovič <salutis@me.com> | 2022-10-07 15:03:48 +0200 |
|---|---|---|
| committer | Ihor Radchenko <yantar92@posteo.net> | 2022-11-21 10:44:56 +0800 |
| commit | 62e1513b5aa32d04ce1e7229e676093f55388ecd (patch) | |
| tree | 79435484dc0487bd640909b8f16550b0574f10e3 /etc/ORG-NEWS | |
| parent | 46c4335e44f59e77d74c7f6ec432cf70ae2d35b0 (diff) | |
| download | org-mode-62e1513b5aa32d04ce1e7229e676093f55388ecd.tar.gz | |
ox-html: Update from MathJax 2 to MathJax 3+
* lisp/ox-html.el (
org-html-mathjax-options,
org-html-mathjax-template,
org-html--build-mathjax-config
): Update from MathJax 2 to 3 while maintaining compatibility. All
legacy options should continue to work, except for the 'path' option
which must now point to MathJax 3 or later.
* testing/lisp/test-ox-html.el (
ox-html/mathjax-path-none,
ox-html/mathjax-path-default,
ox-html/mathjax-path-custom,
ox-html/mathjax-path-in-buffer,
ox-html/mathjax-options-default,
ox-html/mathjax-options-custom,
ox-html/mathjax-options-in-buffer,
ox-html/mathjax-legacy-scale-default,
ox-html/mathjax-legacy-scale-custom,
ox-html/mathjax-legacy-scale-in-buffer,
ox-html/mathjax-legacy-scale-message,
ox-html/mathjax-legacy-scale-message-in-buffer,
ox-html/mathjax-legacy-scale-ignore,
ox-html/mathjax-legacy-autonumber-ams,
ox-html/mathjax-legacy-autonumber-ams-in-buffer,
ox-html/mathjax-legacy-autonumber-none,
ox-html/mathjax-legacy-autonumber-none-in-buffer,
ox-html/mathjax-legacy-autonumber-all,
ox-html/mathjax-legacy-autonumber-all-in-buffer,
ox-html/mathjax-legacy-autonumber-message,
ox-html/mathjax-legacy-autonumber-message-in-buffer,
ox-html/mathjax-legacy-font-tex,
ox-html/mathjax-legacy-font-tex-in-buffer,
ox-html/mathjax-legacy-font-stix-web,
ox-html/mathjax-legacy-font-stix-web-in-buffer,
ox-html/mathjax-legacy-font-asana-math,
ox-html/mathjax-legacy-font-asana-math-in-buffer,
ox-html/mathjax-legacy-font-neo-euler,
ox-html/mathjax-legacy-font-neo-euler-in-buffer,
ox-html/mathjax-legacy-font-gyre-pagella,
ox-html/mathjax-legacy-font-gyre-pagella-in-buffer,
ox-html/mathjax-legacy-font-gyre-termes,
ox-html/mathjax-legacy-font-gyre-termes-in-buffer,
ox-html/mathjax-legacy-font-latin-modern,
ox-html/mathjax-legacy-font-latin-modern-in-buffer,
ox-html/mathjax-legacy-line-breaks-true,
ox-html/mathjax-legacy-line-breaks-true-in-buffer,
ox-html/mathjax-legacy-line-breaks-false,
ox-html/mathjax-legacy-line-breaks-false-in-buffer,
ox-html/mathjax-legacy-line-breaks-message,
ox-html/mathjax-legacy-line-breaks-message-in-buffer): Test MathJax in
general and also the conversion of legacy options from MathJax 2 to 3.
* testing/org-test.el (org-test-capture-messages): Add a new macro
useful for testing the messages put in the echo area.
* etc/ORG-NEWS: Document MathJax 2 to 3 upgrade, highlighting the
benefits of the new version but also mentioning the fact that the user
may need to update the `path' option in `org-html-mathjax-options'.
* doc/org-manual.org (Math formatting in HTML export): Update the link
to the MathJax CDN and the example of how to use `+HTML_MATHJAX' with
MathJax 3. Also, remove the note on MathJax extensions, as they did
not work (and do not work) as documented.
Link: https://list.orgmode.org/orgmode/m2a667n4ax.fsf@me.com/
Diffstat (limited to 'etc/ORG-NEWS')
| -rw-r--r-- | etc/ORG-NEWS | 38 |
1 files changed, 38 insertions, 0 deletions
diff --git a/etc/ORG-NEWS b/etc/ORG-NEWS index 78f7c5d..c03bbb7 100644 --- a/etc/ORG-NEWS +++ b/etc/ORG-NEWS @@ -139,6 +139,44 @@ rely on the details of visibility state implementation in backend. From now on, using =outline-*= functions is strongly discouraged when working with Org files. +*** HTML export uses MathJax 3+ instead of MathJax 2 + +Org now uses MathJax 3 by default instead of MathJax 2. During HTML +exports, Org automatically converts all legacy MathJax 2 options to +the corresponding MathJax 3+ options, except for the ~path~ option in +which now /must/ point to a file containing MathJax version 3 or +later. The new Org does /not/ work with the legacy MathJax 2. + +Further, if you need to use a non-default ~font~ or ~linebreaks~ (now +~overflow~), then the ~path~ must point to MathJax 3 or later. + +See the updated ~org-html-mathjax-options~ for more details. + +MathJax 3, a ground-up rewrite of MathJax 2 came out in 2019. The new +version brings modularity, better and faster rendering, improved LaTeX +support, and more. + +For more information about new features, see: + +https://docs.mathjax.org/en/latest/upgrading/whats-new-3.0.html +https://docs.mathjax.org/en/latest/upgrading/whats-new-3.1.html +https://docs.mathjax.org/en/latest/upgrading/whats-new-3.2.html + +MathJax 3 comes with useful extensions. For instance, you can typeset +calculus with the ~physics~ extension or chemistry with the ~mhchem~ +extension, like in LaTeX. + +Note that the Org manual does not discuss loading of MathJax +extensions via ~+HTML_MATHJAX~ anymore. It has never worked anyway. +To actually load extensions, consult the official documentation: + +https://docs.mathjax.org/en/latest/input/tex/extensions.html + +Lastly, MathJax 3 changed the default JavaScript content delivery +network (CDN) provider from CloudFlare to jsDelivr. You can find the +new terms of service, including the privacy policy, at +https://www.jsdelivr.com/terms. + ** New features *** Clock table can now produce quarterly reports |
