doxygen - doxygen 标记文件中究竟包含什么？

Question

根据docs您总是使用指向一组 HTML 文件的 doxygen 标记文件。那么标记文件本身到底做了什么呢？对于一个生成 700 个 HTML 文件的中等规模的项目，我的标记文件是 500Kb，所以里面显然有很多东西。但是，为什么我不直接告诉 doxygen 外部文档的位置？

Answer 1

标签文件就像 C 语言的预编译头文件。它包含外部项目中的所有符号，以及每个符号对应的 HTML 文档的深层链接。它只是一个 XML 文件，因此您可以打开它并查看其中的内容。

您不能只告诉 doxygen 外部文档的位置，因为那样它就没有信息可以为每个符号深度链接到哪里。它所能做的就是指向文档树的根，但这对用户来说不是很友好。

理论上，doxygen 可以尝试直接从生成的 HTML 文件中提取链接。事实上，这在过去是可能的，但它非常脆弱，而且经常出现故障，因此该功能已被删除。