Mention GladTeX for EPUB export

This updates the manual and the web site about the GladTeX usage.
This commit is contained in:
Sebastian Humenda 2021-05-30 19:03:04 +02:00 committed by John MacFarlane
parent 94e8a650fb
commit 39afd4297f
2 changed files with 13 additions and 7 deletions

View file

@ -1415,13 +1415,12 @@ results only for basic math, usually you will want to use
`--gladtex`
: Enclose TeX math in `<eq>` tags in HTML output. The resulting HTML
can then be processed by [GladTeX] to produce images of the typeset
formulas and an HTML file with links to these images.
So, the procedure is:
can then be processed by [GladTeX] to produce SVG images of the typeset
formulas and an HTML file with these images embedded.
pandoc -s --gladtex input.md -o myfile.htex
gladtex -d myfile-images myfile.htex
# produces myfile.html and images in myfile-images
gladtex -d image_dir myfile.htex
# produces myfile.html and images in image_dir
[MathML]: https://www.w3.org/Math/
[MathJax]: https://www.mathjax.org

View file

@ -141,8 +141,15 @@ Pandoc has an EPUB3 writer. It renders LaTeX math into MathML, which
EPUB3 readers are supposed to support (but unfortunately few do).
Of course, this isn't much help if you want EPUB2 output (`pandoc -t epub2`)
or target readers that don't support MathML. Then you should try using the
`--webtex` option, which will use a web service to convert the TeX to an image.
or target readers that don't support MathML. Then you have two options:
1. Use the [`--webtex`](https://pandoc.org/MANUAL.html#option--webtex) option,
which will use a web service to convert the TeX to an image.
2. Use the [`--gladtex`](https://pandoc.org/MANUAL.html#option--gladtex) option
to convert maths into SVG images on your local machine.
Both GladTeX and WebTeX add the LaTeX source of the formula as alternative text
of the image, increasing accessibility for blind users.
[KindleGen]: https://www.amazon.com/gp/feature.html?ie=UTF8&docId=1000765211
[EPUB]: https://en.wikipedia.org/wiki/EPUB