我写了一个库,它使用另一个 3rd 方库。此第 3 方库在特定网站上在线提供。我已经成功地使用 DoxyGen 来记录我的项目,但是我很难让它生成到第 3 方、在线、文档的链接。
我发现我可以在我的文件中为这些类创建“虚拟”条目,并为它们生成页面,这些页面有一个指向在线文档的链接。这样做的缺点是,我被迫在我的文档上有一个页面,它只是一个链接。理想情况下,单击第 3 方课程应该将用户直接带到在线文档,而不是让用户浏览“无所事事但链接”页面。
我试图为此使用外部标记文件,但是当 doxygen 运行时不断出现错误,并且标记的类在输出中仍然是非链接。我没有找到任何使用手动创建的标记文件来引用在线文档的示例,但是根据 doxygen 说明的措辞,这似乎应该是可行的。我当前的标签文件目前看起来像这样(尽管我尝试了很多变体):ExternalTags.xml
<?xml version="1.0" encoding="UTF-8" standalone="true"?>
<tagfile>
<compound kind="class">
<name>Vector3</name>
<filename>Vector3.html</filename>
</compound>
</tagfile>
我的配置文件包含以下行(也尝试了许多变体):
TAGFILES = "externalTags.xml = http://docs.unity3d.com/ScriptReference/"
当标记文件从配置中删除时,doxygen 运行时不会出现任何错误。如果包含标签文件选项,doxygen 总是会产生以下错误:
lookup cache used 941/65536 hits=6682 misses=1048
finished...
error: Fatal error at line 1 column 1: error while parsing element
error: Fatal error at line 1 column 1: error while parsing prolog
如何解决这些错误,并在 doxygen 输出中正确生成链接?