Our great sponsors
-
Asciidoctor
:gem: A fast, open source text processor and publishing toolchain, written in Ruby, for converting AsciiDoc content to HTML 5, DocBook 5, and other formats.
-
WorkOS
The modern identity platform for B2B SaaS. The APIs are flexible and easy-to-use, supporting authentication, user identity, and complex enterprise features like SSO and SCIM provisioning.
I'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/
Pandoc[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/