XML 中的 Doxygen 项目版本号

Doxygen project version number in XML

我希望我的项目版本号出现在 Doxygen XML 输出中,以便我可以通过编程方式检索它。我已经设置了 PROJECT_NUMBER,我在那里使用的值出现在同一构建的 HTML 输出中,但不出现在 XML 输出中。我在 XML 输出文件夹中搜索了我在 PROJECT_NUMBER 中输入的值的原始文本,但它无处出现。通过 Doxygen 配置选项搜索,除了 PROJECT_NUMBER 本身,我找不到任何可以控制它的东西,所以我认为这不仅仅是一个配置问题。

这不是 Doxygen 的功能吗?如果是这样,是否有解决方法可以在 XML 输出中获取该值?版本号是在文档构建过程中生成的,我强烈不希望将它直接存储在任何源文件中。

我正在使用 Doxygen 1.8.11

没有明确的答案,但如果没有其他问题出现,我将使用这个解决方案。

创建别名:

ALIASES = "myversion=\anchor version \xmlonly a.b.c \endxmlonly"

其中 'a.b.c' 是也放在 PROJECT_NUMBER 中的版本号。

然后将 \myversion 标记放在标记为 \page\mainpage 的注释块中,因为 \anchor 需要位于其中之一(source).

这并不理想,但您可以使用锚点轻松定位 xml 中的版本。在我的例子中,xml 输出是:

<para><anchor id="index_1version"/> a.b.c </para>

在页面的详细描述中,因此您可以只获取封闭 'para' 标签的文本内容。

我不一定需要 \xmlonly 标签,但是由于 PROJECT_NUMBER 已经出现在 html 中,所以不需要在其他地方随机打印版本号.