Section 30.1 Prerequisites
There are a handful of prerequisites to build an EPUB version of a book:
You must use a publication file (referred to below as
publication.xml
) withsource/directories/@generated
andsource/directories/@external
so that images can be located and bundled. The publication file must also haveepub/@cover
that points to a cover image (JPEG or PNG, 2048 pixels tall, 1280 pixels wide).If the book has images generated by the
pretext/pretext
script, SVG format must be produced for standard EPUB and PNG format must be produced for Kindle.node
andnpm
must be installed. See Section F.1 for more onnode
andnpm
.You must install a local version of MathJax. We provide a bash script in
scripts/mjsre
that 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.