Building on macOS Mojave

[corasaurus-hex]

Just wanted to share how I got the HTML to build on macOS Mojave 10.4.5.

Dependencies:

• ruby 2.3.8 (I used asdf-ruby to install it then set the asdf ruby version locally)
• python 2.7.16 (I used asdf-python to install it then set the asdf python version locally)
• pygments.rb 0.6.3 (gem install pygments.rb -v 0.6.3)
• asciidoctor 1.5.4 (gem install asciidoctor -v 1.5.4)

Then use make html. To get the HTML to look right I had to move dist/index.html to the root of the git checkout and then open it (so ./assets/* and ./images/* could be found by the browser).

(NOTE: It might pay for the Makefile to copy ./assets and ./images into ./dist for the html target.)

[corasaurus-hex]

To build the PDF I needed:

• xquartz 2.7.11 (brew install Caskroom/cask/xquartz)
• Java 8 (1.8.0_141) (I used asdf-java to install oracle-8.141 then set the asdf java version locally)
• ghostscript 9.27 (brew install gs) (NOTE: ghostscript makes the pdf look nicer but it removes all links, so, leave this uninstalled if you prefer to have links from the ToC and stuff, although building will succeed and yet print an error at the end without this installed)

I did these steps from the root of the git clone:

• rm -rf asciidoctor-fopub
• git clone https://github.com/asciidoctor/asciidoctor-fopub (current commit is 15933455befd14434c3a144b29530f996844d302)
• make pdf
• open dist/clojurescript-unraveled.pdf

[corasaurus-hex]

To get mobi and epub to build I needed:

• docbook-xsl 1.79.1 (brew install docbook-xsl)
• calibre 3.44.0 (brew cask install calibre)

Then I just ran:

• make mobi
• make epub