MathJax 4 was released a couple months ago. Now is the time for us to make the
move.
Ideal timeline: merge late November. Migrate to the CLI and Runestone as
classes wind down for semester-breaks. In place before JMM.
Testing parameters have been updated:
stringparam debug.mathjax4 set to "yes" will get you
- latest version 4 (now 4.0.0)
- tex-mml-chtml.js file/configuration/fonts (similar to current)
stringparam debug.mathjax.svg set to "yes" will get you
- tex-svg.js file/configuration/fonts (seems to be new default recommendation)
This will require coordination and help from (at least): Brad R (Runestone),
David A (PreFigure), Rob (Braille), Jason S (React version), David F (knowls,
see below), Alex J (WeBWork, maybe). We'll need help from MathJax proper
(Davide C, Volker S) for PreFigure and Braille (see below). For now, let's use
this thread, and it can wander through various topics.
Section 7 of the sample article looks pretty good.
* Knowls inside display math need help. This is a "\knowl" macro David Farmer
has supported. Lately in js_lib/mathjaxknowl3.js from early 2022.
* There is some change with special LaTeX characters tagging equations, I'll
chase that down.
* script/mjsre/mj-sre-page.js is essential to the production of PreFigure
tactile diagrams and conversions to braille. I'd be pretty confident it needs
work, or at least a review, but have not tested it yet. This is where MathJax
could help us.
GitHub issue for tracking some/all of this:
https://github.com/PreTeXtBook/pretext/issues/1841
Interested and affected parties can test and help as appropriate (please!).
Invariably some bugfixes will follow this change, but I'd sure like to minimize
those.
Thanks,
Rob