Subject: Re: [boost] Asciidoc, an alternative for documentation
From: Vinnie Falco (vinnie.falco_at_[hidden])
Date: 2017-10-03 14:54:43
On Tue, Jun 6, 2017 at 8:03 AM, Lorenzo Caminiti via Boost
<boost_at_[hidden]> wrote:
> * Does ascii interface with Doxygen? For example, can you embed in the
> asciidoc output a reference section generated by Doxygen and have
> hyperlinks in between the ascidoc and Doxygen sections? (Similar to
> Quickbook [xinclude ...].)
I think the toolchain for Doxygen plus Asciidoc would look like this:
(header files) -> XML; using Doxygen
XML -> Asciidoc; using xsltproc
You would need to write an .xslt program to perform the translation
from XML to asciidoc. It might look like this:
<https://github.com/vinniefalco/docca/blob/master/include/docca/doxygen.xsl>
(The .xsl file linked above converts XML into Quickbook).
Thanks