doxygen 页面的 URL 是永久的吗

Question

大家好，我们刚刚添加了一个夜间操作，用 doxygen 处理整个源代码树并将输出放到开发网络服务器上。

我们还拥有一个共享点结构，其中包含各种模块/项目的设计文档。目前，我们保留此文档的级别相对较高。我们讨论模块的结构并讨论主要的类，但从不深入到单个方法级别。我想通过在 SDS word 文档中添加指向 doxygen 输出的超链接来弥补这一差距。

我注意到链接看起来像这样：

http://example.com/docs/ProjectName/d4/d98/class_c_reader.html
http://example.com/docs/ProjectName/d4/d16/class_c_stream.html

让我印象深刻的部分是路径中的“d4”、“d98”和“d16”字符串。如果我复制这些链接并创建超链接，有没有人知道这些 URL 是否保证在将来保留。正如我所说，整个 doxygen 输出每晚都会重新生成。

Answer 1

您可以通过在 doxygen 配置中禁用 CREATE_SUBDIRS 来禁用 d4/d98 子目录。

HTML 文件的名称是否会保持不变我不确定，但从我在使用 doxygen 时看到的情况来看，似乎是这样。如果您想确定，可以随时查看 doxygen 的来源。

Answer 2

这些链接可能不会永久存在。 此外，Doxygen 具有生成文档的 XML 表示形式，但即使是这个接口也是如此。相应的 DSD 已随 doxygen 的新版本而更改。这很令人沮丧，因为我们曾在类似的应用程序中使用 XML 表示，并假设每个新版本的结构都保持相同。