On 16.08.2017, at 23:08, Marshall Schor <[email protected]> wrote: > > I'm wondering if a good way to think about asciidoc is as an alternative > markup > langauge that can produce html5 and docbook.
Asciidoc is a language in the spirit of markdown, restructured text, etc. Languages that work predominantly with formatting conventions that also make sense in a plain text view. So the idea is that you write a nicely formatted plain text document and then render that to an equally nicely formatted other format. Since the master is a plain text document, it works great with diff/version control and no special tooling is required for editing. > It seems to have another set of markup language. > > In this sense, it could be an alternative front end for DocBook, which it uses > to get to PDFs, I think. > > Does that sound right? Asciidoctor-J has several backends. HTML5 and DocBook XML are built-in. But there is also a direct-to-PDF backend and a EPub backend. Cf. http://search.maven.org/#search%7Cga%7C1%7Casciidoctorj I have used the built-in HTML5 and the direct-to-PDF backend. I didn't use the Docbook backend yet. You might also find the diagram plugin interesting - I haven't used it so far: http://asciidoctor.org/docs/asciidoctor-diagram/ Cheers, -- Richard
