[Doxygen-users] Creating hierarchical documentation

[Randy Y. <Ra...@as...>]

We are using doxygen for general project documentation (i.e., not for
code). We are standardized on using markdown (.md) files.

I would like to partition the documentation into separate files, but
have them show up in a hierarchy in the TOC pane on the left and as a
continuous document in the output.

For example, let's say I have a standard mainpage.md file, but then I
want to create a glossary in a separate file called glossary.md:

# Glossary {#glossary}

- TBD: To Be Determined

- n/a: Not Available

etc.

When I add this file to mainpage.md like this

@subpage glossary

doxygen nicely provides "Glossary" to the TOC pane, as I desire, but
instead of actually including the markdown in the output, it includes a
_link_ to the page; you must click on the link to see the page.


How do I partition documents and get doxygen to 1) include the file in
the TOC, and 2) get the content of the included file directly into the
output rather than just a link? I also want to nest this under multiple
hierarchies.

--Randy





This message contains confidential information. If you are not the intended recipient, notify the sender immediately and delete this e-mail from your system. You should always check e-mail for viruses. Sender does not accept liability for any viruses that may be inadvertently transmitted.