Re: [boost] Asciidoc, an alternative for documentation

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