Notes on how I generated EPUB from an AsciiDoc book using asciidoctor-htmlbook and HTMLBook

generating_epub_via_htmlbook.md

Starting point:

• April 1, 2015 version of Dubliners AsciiDoc file: Dubliners_2814/2814.asciidoc at 43ca7fde5bcd543e9174c69bfd187f88d42d0044 · rdhyee/Dubliners_2814

• to convert AsciiDoc to HTMLBook: rdhyee/asciidoctor-htmlbook at c28bb54943735fa474e94ae6e76b38b3ea72cea5. Note changes I've made to asciidoctor-htmlbook: Comparing oreillymedia:1c49c1db0c36434dcfab85d8357bba7e1a29846f...rdhyee:master · oreillymedia/asciidoctor-htmlbook

• to convert HTMLBook to EPUB: use XSLT from the HTMLBook project. I've not had to make any changes from the main repo: oreillymedia/HTMLBook at 547a4d356fb78189a7590a9bb7352ac0c723e525.

Code I used to generate the epub. (All paths for my own computer):

cd /Users/raymondyee/C/src/Dubliners_2814/
rm 2814.epub

asciidoctor -a toc -b xhtml5 -d book -T /Users/raymondyee/C/src/asciidoctor-htmlbook/htmlbook-autogen/ \
   --trace \
   2814.asciidoc

xsltproc -stringparam external.assets.list " " \
         /Users/raymondyee/C/src/HTMLBook/htmlbook-xsl/epub.xsl 2814.html 

# copy desired epub.css
cp epub.css OEBPS

# copy desired cover -- hardwired right now to png
cp cover.png OEBPS

# remove extraneous index.html
rm OEBPS/index.html 

zip -rX 2814.epub mimetype OEBPS/ META-INF/

No errors in generated EPUB according to epubcheck.