Re: DocBook->AsciiDoc conversion project

Charlotte Koch <[email protected]> Sat, 26 Jul 2025 21:44:12 +0000 (UTC)
Newsgroups gmane.os.netbsd.documentation
Message-ID <[email protected]>
On Sat, 26 Jul 2025, Martin Husemann wrote:

> Just curious: how flexible can you configure the html output generated
> from asciidoc? Which tool is used for that?
>
> Martin

Asciidoctor's output is actually quite tweakable, although I personally
haven't used these features very much. You can use the asciidoctor(1)
command line options `--template-engine` and `--template-dir` to change
which HTML tags are actually used and so on.

     https://docs.asciidoctor.org/asciidoctor/latest/cli/man1/asciidoctor/#options

With Asciidoctor, it's also possible to write some Ruby directly. You'd
write a subclass of the default converter code to change how the output
is generated. I do something like that in WilloraPDF:

     https://github.com/magentastripe/willorapdf/blob/master/project-files/lib/willora_pdf_converter.rb

Charlotte