MobileRead Forums - View Single Post

pkra · 08-17-2012, 06:51 PM

Hi,

Very cool to see a plugin happening -- Calibre is a great tool!

@kovidgoyal: since you activated SVG output, you won't need STIX or any fonts (the SVG fonts are webfonts that certain old browsers understand, SVG-rendering is different). But you should definitely add MathML-input to the configuration you're creating (and why not asciimath notation as well?) The point being that the standard for math in epub3 is MathML, both practically (the only thing epub3 reading systems are required to understand) and conceptually (ensuring accessibility etc). This may seem moot in a time where no reading system renders MathML 100%, but it's still the right thing to do imho. Since the OP is coming from a shinx/reST-setup, it should be possible to properly translate the math into MathML in the conversion process (not sure the sphinx people are working on that but pandoc goes a long way).

For what it's worth, here's the semi-official guide to shrinking MathJax in general:

https://github.com/mathjax/MathJax/w...2-installation

We're working on a better guide to include in the official MathJax documentation (mathjax.org/docs).

I should point out that my old blog post linked to above is outdated and the example files won't even work. However, the result is still possible, i.e., you can include a shrunk MathJax inside your epub file and it will render in javavscript-enabled readers such as Calibre and iBooks. (I do plan to update that post soon...) A very good start is to simply check out the MathJax code included in Readium (in particular, the MathJax configuration file they use)

One last thing, we created a resource on epub3 reading systems and MathML at http://www.mathjax.org/resources/epub-readers/ -- any help and comments are very welcome there!

08-17-2012, 06:51 PM	#13
pkra Junior Member Posts: 4 Karma: 10 Join Date: Aug 2012 Device: all	Hi, Very cool to see a plugin happening -- Calibre is a great tool! @kovidgoyal: since you activated SVG output, you won't need STIX or any fonts (the SVG fonts are webfonts that certain old browsers understand, SVG-rendering is different). But you should definitely add MathML-input to the configuration you're creating (and why not asciimath notation as well?) The point being that the standard for math in epub3 is MathML, both practically (the only thing epub3 reading systems are required to understand) and conceptually (ensuring accessibility etc). This may seem moot in a time where no reading system renders MathML 100%, but it's still the right thing to do imho. Since the OP is coming from a shinx/reST-setup, it should be possible to properly translate the math into MathML in the conversion process (not sure the sphinx people are working on that but pandoc goes a long way). For what it's worth, here's the semi-official guide to shrinking MathJax in general: https://github.com/mathjax/MathJax/w...2-installation We're working on a better guide to include in the official MathJax documentation (mathjax.org/docs). I should point out that my old blog post linked to above is outdated and the example files won't even work. However, the result is still possible, i.e., you can include a shrunk MathJax inside your epub file and it will render in javavscript-enabled readers such as Calibre and iBooks. (I do plan to update that post soon...) A very good start is to simply check out the MathJax code included in Readium (in particular, the MathJax configuration file they use) One last thing, we created a resource on epub3 reading systems and MathML at http://www.mathjax.org/resources/epub-readers/ -- any help and comments are very welcome there!