c++ - 使用 doxygen 将文档生成为降价文件

Question

我知道可以在评论中使用 markdown 并且 doxygen 可以理解它。但我需要知道是否可以生成降价格式的文档？

我需要从 C++ 文件生成这些文档。

Answer 1

我知道这个问题很老，但似乎有一个新工具可用：https ://www.npmjs.com/package/doxygen2md

Answer 2

我不知道有什么可以直接执行的，但是 doxygen 能够使用 XML 生成器输出 XML 文档。

有各种各样的项目可以使用所述 XML 数据来转换它，我所知道的最简单的项目之一是Breathe，它用于将 XML 文档转换为Sphinx可以使用 doxygen 作为输出文档的东西预处理器可以这么说。

Breathe 的代码可能足够简单，可以用作起点，然后生成 Markdown 文件，而不是 Sphinx 所需的 ReStructuredText 文件。我没有看过 Breathe 的代码，但我已经将它用于一些主要项目。

Answer 3

使用 doxygen http://www.doxygen.nl/manual/customize.html#xmlgenerator生成 XML 。

使用 PanDoc http://pandoc.org/ 将 XML 转换为 Markdown。