MathJax 4

8 views
Skip to first unread message

Rob Beezer

unread,
Oct 14, 2025, 12:20:18 PMOct 14
to prete...@googlegroups.com
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

Bradley Miller

unread,
Oct 14, 2025, 12:32:38 PMOct 14
to PreTeXt development
I did a Runestone build and browsed through the various sections of the sample book.  The Runestone components with math in them looked like they were all rendering correctly.   I can give the svg flag a try later.

Brad R??  — Brad Runestone and my friend Tim Apple?

Brad Miller
Professor Emeritus, Luther College
Founder, Runestone Academy LTD
Blog: http://reputablejournal.com

Set up a time to meet with me.


--
You received this message because you are subscribed to the Google Groups "PreTeXt development" group.
To unsubscribe from this group and stop receiving emails from it, send an email to pretext-dev...@googlegroups.com.
To view this discussion visit https://groups.google.com/d/msgid/pretext-dev/MTAwMDA0Mi5iZWV6ZXI.1760458815%40pnsh.

Rob Beezer

unread,
Oct 14, 2025, 12:36:56 PMOct 14
to prete...@googlegroups.com
First baby step. I think

js_lib/mathjaxknowl.js

is obsolete. Replaced by a v3 version.

I'm going to remove it, unless somebody screams.

I asked about this back in December:
https://groups.google.com/g/pretext-dev/c/2UMUBW8Sjgc/m/ZR-lg7k3BAAJ

as part of a putative clean-up of the js_lib directory. Which went nowhere.

If we make a mathjaxknowl4.js perhaps it can move somewhere closer to all the
other JS.

Rob

Rob Beezer

unread,
Oct 14, 2025, 5:40:43 PMOct 14
to prete...@googlegroups.com
On 10/14/25 09:20, 'Rob Beezer' via PreTeXt development wrote:
> *  There is some change with special LaTeX characters tagging equations, I'll
> chase that down.
Argument to \tag{} is now in "text mode" so the "#" character needs to be
escaped. But can't be done now, lest the "\" bleeds through.

So I've got the change on a branch I'm starting to build up.

Rob

Reply all
Reply to author
Forward
0 new messages