This is an awesome book. It’s written in AsciiDoc and compiles to HTML, PDF, EPUB, and MOBI using the Asciidoctor Gradle plugin.
To convert this book to HTML, EPUB, and MOBI, run the following command:
$ build.sh
To convert this book to a 6x9" PDF for printing:
$ generate-pdf.sh
To convert this book to a 8.5x11" PDF for downloading:
$ generate-pdf.sh screen
-
Open build/asciidoc/html5/index.html in your browser to see the generated HTML file.
-
Open build/asciidoc/pdf-prepress/index.pdf to see the 6x9" printable PDF file.
-
Open build/asciidoc/pdf-screen/index.pdf to see the downloadable 8.5x11" PDF file.
-
Open build/asciidoc/epub3/index.epub in iBooks to see the generated EPUB file.
-
Open build/asciidoc/epub3/index.mobi in Calibre to see the generated MOBI file.
Note
|
To be able to generate the PDF, you need have some dependencies installed. First, install RVM to manage your Ruby installation(s). Once RVM is installed and loaded, run the following commands:
The |
If you’d like a very pleasant authoring experience, the project provides build files that make it possible. First of all,
you’ll need to run gradlew
once. After running it once, you can run ./gradlew watch
to watch for any changes and
recompile files as you save them.
To have a similar awesome experience (watch and auto-reload) in your browser, install Node.js on your machine.
After installing Node, you can run the following command to install development tools (like Browsersync).
You will only need to run this command when dependencies change in package.json
.
npm install
This project use Gulp as the client-code build system. You can install the gulp
command-line
tool globally with:
npm install -g gulp-cli
Now you can run the following gulp
command to create a blissful development experience where your browser auto-refreshes
when files change on your hard drive.
gulp