4 ms·
Asciidoc and Asciidoctor can produce DocBook, and from DocBook you can do most formats. Working with the DocBook toolchain is rather unpleasant and brittle (de
by kimi 5y ago
Asciidoc and Asciidoctor can produce DocBook, and from DocBook you can do most formats.
Working with the DocBook toolchain is rather unpleasant and brittle (depends a lot on the versions), so my company ended up packaging everything in a Docker container https://github.com/l3nz/dockbooker https://github.com/l3nz/dockbooker - this has worked pretty well for many years but now we mostly use Asciidoctor by itself.
- Tomte 5y agoAsciiDoctor has been designed so that its syntax elements map well to Docbook. You can use pretty much every feature of Docbook with the much nicer AsciiDoctor syntax on top.
- cryptos 5y agoI've the same experience. Soem years ago I tried DocBook to render HTML and PDF documents, but the whole setup was so unpleasant that I gave up. Writing the syntax is not overly hard, but also not pleasant. I ended up with AsciiDoc, what is nice to read and write and which has a rich set of features. It is also very easy to set up: just download AsciiDoctor and you're ready to go. https://asciidoctor.org/ https://asciidoctor.org/
- innocentoldguy 5y agoI find DocBook (and XML in general) too cumbersome. I've been using Asciidoc in conjunction with Pandoc to create Word documents, Asciidoctor-PDF to generate PDF documents, and Antora to generate websites. This combination works well for me, anyway.
- ognarb 5y agoDoes anyone know a good tool to convert docbook to asciidoc? Also is there a good way to extract a asciidoc document to a gettext pot file?
- marbu 5y agoPandoc[1] is worth trying. I haven't used it for docbook, but I'm quite happy with pandoc conversions in other cases. [1] https://pandoc.org/ https://pandoc.org/
- BenFeldman1930 5y agoAsciidoctor could be perfect for my use case, but as of now it does not support end of page footnotes, but end of chapter or end of article ones.