doxygen 页面的 URL 是永久的吗

发布于 2024-11-02 06:20:48 字数 475 浏览 3 评论 0原文

大家好,我们刚刚添加了一个夜间操作,用 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 输出每晚都会重新生成。

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

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

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.

如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。

扫码二维码加入Web技术交流群

发布评论

需要 登录 才能够评论, 你可以免费 注册 一个本站的账号。

评论(2

蓝戈者 2024-11-09 06:20:48

您可以通过禁用 CREATE_SUBDIRSd4/d98 子目录a> 在 doxygen 配置中。

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

You can disable the d4/d98 subdirectories by disabling CREATE_SUBDIRS in the doxygen configuration.

Whether the name of the HTML files will stay the same I do not know for sure but from what I have seen when using doxygen it seems so. If you want to know for sure you can always look at the doxygen source.

水染的天色ゝ 2024-11-09 06:20:48

这些链接可能不会永久保留。
此外,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.

~没有更多了~
我们使用 Cookies 和其他技术来定制您的体验包括您的登录状态等。通过阅读我们的 隐私政策 了解更多相关信息。 单击 接受 或继续使用网站,即表示您同意使用 Cookies 和您的相关数据。
原文