在 Doxygen 中看不到（链接的）Qt 类答案

【问题标题】：Don` t see (linked) Qt classes in Doxygen在 Doxygen 中看不到（链接的）Qt 类
【发布时间】：2016-03-16 12:47:55
【问题描述】：

这是doxygen generated documentation with auto-generated links to qt project 的后续，也在博客here

添加标签文件：

TAGFILES = qtcore.tags=http://doc.qt.io/qt-5/ qtgui.tags=http://doc.qt.io/qt-5/ \
           qtwidgets.tags=http://doc.qt.io/qt-5/ qtxml.tags=http://doc.qt.io/qt-5/ \
           qtnetwork.tags=http://doc.qt.io/qt-5/

GENERATE_TAGFILE = mytags

交叉检查，例如，这里有效：http://doc.qt.io/qt-5/qtcore.tags

尽管如此，我没有看到任何 Qt 类的链接（我希望 QString 是一个链接）

我做错了什么？顺便说一句，像\copydoc QString::toInt 这样的东西会起作用吗？

【问题讨论】：

标签： qt doxygen

【解决方案1】：

您是否检查过您的.tags 文件的位置？

.tags 文件就像一个将符号映射到文档相关链接的索引。这就是为什么您同时指定 标记文件的路径和记录符号的 实际文档 URL（顺便说一下，它也可以是 Qt 文档的本地路径)。

换句话说，您应该指定：

TAGFILES = path/to/a/tags/file=URL

您可以在 Qt 目录中找到这些 .tags 文件（通常在 QT_DIR/doc/html 中）。

最好将它们复制到项目目录中以避免使用绝对路径。所以如果你有以下项目结构：

myproject/
    Doxyfile
    src/
    doc/
        html/
        qt/
            qt.tags

那么你的 Doxyfile 应该包含：

TAGFILES = doc/qt/qt.tags=http://doc.qt.io/qt-5/

然后，您的文档中对 Qt 符号的所有引用都将链接到 Doxygen 生成的 html 输出中。

此外，GENERATE_TAGFILE 标记仅在您想从另一个项目链接到您的文档时才有用。

【讨论】：