/infoq-mini-book

Template project for creating an InfoQ Mini-Book with Asciidoctor

Primary LanguageCSS

An InfoQ Mini-Book

This book is written in Asciidoctor. It compiles to HTML, PDF, EPUB, and MOBI using the Asciidoctor Gradle plugin.

Building

To convert this book to HTML, PDF, EPUB, and MOBI, install KindleGen, change build.sh to point to your installation, then run the following command:

$ build.sh

  • Open build/asciidoc/html5/index.html in your browser to see the generated HTML file.

  • Open build/asciidoc/pdf/index.pdf in a PDF Reader to see the generated 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.

Sweet Authoring Experience

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

Now you can run the grunt command to create a blissful development experience where your browser auto-refreshes when files change on your hard drive.