在Doxygen中看不到(链接的) Qt类

Question

这是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

Crosscheck，作为一个例子，这里是这样的：http://doc.qt.io/qt-5/qtcore.tags

然而，我没有看到任何Qt类的链接(我希望QString是一个链接)

​

​

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

Answer 1

你检查过.tags文件的位置了吗？

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

换句话说，您应该指定：

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

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

将它们复制到项目目录中可能是一个好主意，以避免使用绝对路径。因此，如果您有以下项目结构：

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

那么你的your文件应该包含：

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

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

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