oreillymedia / asciidoctor-htmlbook

Templates for the htmlbook backend for Asciidoctor
45 stars 15 forks source link

HTMLBook Backends

This repo holds the backend templates for converting .asciidoc files into .html files in the htmlbook flavor. The repo ships with 2 backends:

One-time Conversion of Books

In this folder there's a script that helps you convert book files written in asciidoc into htmlbook. Before you run it, it assumes you have installed the asciidoctor gem.

Convert a book by running the script like this:

$ ruby scripts/convert_book.rb PATH_TO_BOOK_REPO

So If my book repo exists in /Documents/MyBook, you would do the following:

$ ruby scripts/convert_book.rb /Documents/MyBook

Running Tests

To run the test suite, run the following command:

$ rspec spec/htmlbook_spec.rb