将 XML 文件添加到文件列表答案

【问题标题】：Add XML file to the file list将 XML 文件添加到文件列表
【发布时间】：2012-02-17 15:44:52
【问题描述】：

我想将 XML 文件的内容添加到 doxygen 生成的文档中。我将 XML 文件添加到 doxygen 配置文件的 INPUT 标记中。但是，虽然 XML 文件列在文件列表中，但文件的内容并未显示。我必须做什么才能包含内容？

【问题讨论】：

【解决方案1】：

Doxygen 不支持解析 XML，因此不能使用 INPUT，但可以在输出中包含 XML 文件的内容。

假设您的 XML 文件名为 test.xml 并且位于目录 xml 中（相对于 doxygen 的运行位置）。然后你可以使用下面的注释块：

/** @page xml_example My XML File
 *  Here is my xml file included in the doxygen output:
 *  @verbinclude test.xml
 */

为了确保doxygen可以找到你需要设置xml目录路径的xml文件

EXAMPLE_PATH = xml

【讨论】：

谢谢 ;) 你知道是否也可以创建一个新的自定义选项卡，如“示例”或“相关页面”？
如果您从 SVN 获取最新快照，您可以创建自定义布局文件（使用 -l 选项），然后您可以在其中添加用户定义的选项卡。通过在 doc 目录中运行 make 从 SVN 构建文档，以获取有关如何定义此类用户定义选项卡的详细信息。