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 中,所以不需要在其他地方随机打印版本号.
我希望我的项目版本号出现在 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 中,所以不需要在其他地方随机打印版本号.