MathML support in calibre editor/previewer

[tomsem]

I have a math book that I'm going through and want to replace math expressions that are rendered in image or SVG files with MathML equivalents.

I found this:

https://manual.calibre-ebook.com/typesetting_math.html

However, while the ePub file downloaded from there previews and displays well in calibre viewer and editor preview, actual ePub software such as Apple Books or Thorium do not render it.

Conversely, when I create ePub with Sigil with a MathML example (attached) it does not render correctly in calibre viewer or editor previewer, but does so in Apple Books and Thorium reader.

So I do not understand the utility of using MathJax if only calibre reader / previewer handles it. It looks like I'll have to do this editing with Sigil and previewing there and with ePub apps like Thorium reader.

Am I missing something here?

I am guessing that adding the <script> stuff for MathJax would let me preview in calibre as well? and other reading apps would ignore it?

[tomsem]

Yes, looks like my guess was correct: I added the <script> reference to header and it previews now.

Perhaps the typesetting_math.html page could be updated to include a MathML example. It seems to me this is what most people will be doing as reading apps aren't going to support javascript solutions in general.

[kovidgoyal]

Why? Pretty much any browser based reader can and should support javascript. These days most of them are browser based, apart from e-ink ones. MathML is a royal pain to author its not designed for authoring, its more of a machine interchange format. But, that said you can put MathML into typsetting_math.html if you like and MathJax will render it for you just like it does ascii math.

[tomsem]

Originally Posted by kovidgoyal

Why? Pretty much any browser based reader can and should support javascript. These days most of them are browser based, apart from e-ink ones. MathML is a royal pain to author its not designed for authoring, its more of a machine interchange format. But, that said you can put MathML into typsetting_math.html if you like and MathJax will render it for you just like it does ascii math.

The two cases I cited (Apple Books and Thorium Reader) didn't render the ePub example downloaded from the calibre info page. And I want it to work on eInk.

I had been trying to do things with straight HTML with some success (okay for algebraic), but am running into expressions that are not amenable to that.

MathML may not be very user friendly, but given my self imposed requirements, I'd rather learn and work with that instead of TeX (if that's the only alternative). I need some auto-completion so I'll probably use VS Code w/MathML extension to compose things and then paste them where needed.

This 'project' started out as a Topaz-format book. You can imagine how awful conversion to ePub is and what there is to clean up. But it is a great learning exercise.

[KevinH]

FYI, Chromium version 109 finally supports Core MathML without any MathJax needed. Qt's WebEngine in Qt 6.7.2 (and maybe earlier) do support it.

We (Sigil) still internally use MathJax3.2.2 to render MathML because it supports the MML3 extensions (although that was recently broken by an Arch libxml2 new version bug).

Either way, a number of e-reading devices based on Chromium blink should soon have built in mathml core support without mathjax if they do not already.

[JSWolf]

Originally Posted by tomsem

I have a math book that I'm going through and want to replace math expressions that are rendered in image or SVG files with MathML equivalents.

Why switch SVG images to MathML? The SVG images will be easie to deal with a more compatible.

Back before ePub 3, I did see a sample ePub with math equations in SVG that worked very well. They even resized when the font size was changed. It looked very good.