Thursday, January 4, 2018

Asciidoctor

I've stumbled across a nice project called 'Asciidoctor'.

Quoting their website:
Asciidoctor - A fast text processor & publishing toolchain for converting AsciiDoc to HTML5, DocBook & more.
HTML, PDF, epub and .mobi files are supported amongst others.

It is a ruby project, but thanks to jruby it is also usable in JVM land. A maven or gradle plugin helps for continuous integration scenarios.

You can find an example project on github (asciidoctor-maven-examples) which shows various ways to configure the maven plugin, it gives you a head start for your own purposes.

I created also a asciidoctor-template project on github which contains an example configuration to create reveal.js slides, pdf documents or epub target files for that matter. Not to forget that it is also possible to create .mobi files, which can be consumed by Amazon Kindle.

I used it for writing some technical documentation and was very satisfied with the results.

Give it a try!