Skip to content

oreillymedia/asciidoctor-htmlbook

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

236 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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

Contributors 8