Login  Register

Re: asciidoctor-j based documentation generator

Posted by abelsromero on May 05, 2019; 8:32am
URL: https://discuss.asciidoctor.org/asciidoctor-j-based-documentation-generator-tp6888p6889.html

Welcome to the forums and thx for the encouraging words.

There are several tools to build documentation that sit on top of asciidoctor and that depends on your the use case.
If you need to build documentation sites I'd strongly recommend antora (https://antora.org/), its own document is written with it so you can see how the defaults look (https://docs.antora.org).
Antora checks out-of-the-box all your points except for "search in created documentation using JS" for which there are third party options.

Note it uses asciidoctor.js under the hood, not AsciidoctorJ. Don't be afraid if your are not familiar with JS tools, features are 100% the same and at the end of the day once installed (with npm or just use docker) you use it as any other cli command.