Skip to content

oreillymedia/asciidoctor-htmlbook

Repository files navigation

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:

  • htmlbook - a set of templates that can be used directly with the asciidoctor gem. This is a direct source conversion
  • htmlbook-autogen - a set of templates that can only be used with the orm_asciidoctor gem. This provides some autogeneration abilities.

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

About

Templates for the htmlbook backend for Asciidoctor

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published