doxygen页面的URL是否永久 [英] Are URLs to doxygen pages permanent

问题描述

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

hey everyone, we just added a nightly action to process the entire source tree with doxygen and place the output onto development webserver.

我们已经有了一个共享点结构其中包含各种模块/项目的设计文档。当前，我们保留此文档的级别相对较高。我们讨论模块的结构并讨论主要的类，但决不涉及单个方法级别。我想通过在SDS Word文档中具有指向doxygen输出的超链接来弥合这种差距。

We also already have a sharepoint structure which holds design documents for various modules/projects. Currently, the level at which we are keeping this documentation is relatively high. We discuss structures of modules and talk about the major classes, but never go down to the individual method level. I wanted to bridge that gap by having hyperlinks in the SDS word documents that would point to doxygen output.

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

I noticed the links look like this:

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输出每晚都会重新生成。

The part that sketches me out a bit is "d4", "d98" and "d16" strings in the path. If I copy these links and create the hyperlinks, does anyone know if these URLs are guaranteed be preserved in the future. As I said, entire doxygen output gets regenerated nightly.

推荐答案

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

Probably these links will not stay permanent. Furthermore, Doxygen has a XML representation of the generated documentation but even this interface resp. the corresponding DSD has been changed with new releases of doxygen. This is quite frustrating, as we had used the XML representation for a similar application with the assumption that the structures would be kept identical with every new release.

这篇关于doxygen页面的URL是否永久的文章就介绍到这了，希望我们推荐的答案对大家有所帮助，也希望大家多多支持IT屋！