Section 29.1 Prerequisites
There are a handful of prerequisites to build an EPUB version of a book:
You must use a publisher file (referred to below as
source/directories/@externalso that images can be located and bundled. The publisher file must also have
epub/@coverthat points to a cover image (JPEG or PNG, 2560 pixels tall, 1600 pixels wide).
If the book has images generated by the
pretext/pretextscript, SVG format must be produced for standard EPUB and PNG format must be produced for Kindle.
npmmust be installed. See Section F.1 for more on
You must install a local version of MathJax. We provide a bash script in
scripts/mjsrethat automates this process. See Section F.2 for instructions.
Furthermore, builds will need to use the
pretext/pretext script, since creating an EPUB file is a multi-stage process; building with
xsltproc is not supported.
As updates to the EPUB conversion are released, you may occasional want to update your local copy of MathJax. Simply use the script referenced above.