aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSebastian Humenda <shumenda@gmx.de>2021-05-30 19:03:04 +0200
committerJohn MacFarlane <jgm@berkeley.edu>2021-06-07 19:17:39 -0600
commit39afd4297ff9d03b3c70eec0d99a43ed5c05ab34 (patch)
treefde0b4aadc59de8a890d928d56c2da5d3a83a429
parent94e8a650fb200b55af7cd1ea7f331fa642b3102e (diff)
downloadpandoc-39afd4297ff9d03b3c70eec0d99a43ed5c05ab34.tar.gz
Mention GladTeX for EPUB export
This updates the manual and the web site about the GladTeX usage.
-rw-r--r--MANUAL.txt9
-rw-r--r--doc/epub.md11
2 files changed, 13 insertions, 7 deletions
diff --git a/MANUAL.txt b/MANUAL.txt
index b4f74b8c4..b3a1f95e2 100644
--- a/MANUAL.txt
+++ b/MANUAL.txt
@@ -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
diff --git a/doc/epub.md b/doc/epub.md
index 82c26dcef..c05faf80c 100644
--- a/doc/epub.md
+++ b/doc/epub.md
@@ -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