Question

我从doxygen 1.8.4迁移到1.8.8。我的DoxygenLayout.xml文件有一个这样的条目：

<tab type="user" url="@ref FAQ" visible="yes" title="FAQ" intro=""/>

在我的Doxyfile中，我的INPUT包括＆＃34; faq.htm＆＃34;我在Doxy输出中看到了：

Reading /git/bfg_iOS_sdk/bfg_internal/docs/htmlFramework/faq.htm...

我的＆＃34; faq.htm＆＃34;文件以这样开头：

/** 
\page FAQ Frequently Asked Questions
\ingroup FAQ
\{

使用Doxy 1.8.4，没有问题。在1.8.8中，我看到了这些警告：

explicit link request to 'FAQ' in layout file 'DoxygenLayout.xml' could not be resolved

我做错了什么？

更新

我（并且一直）使用这些文件模式：

FILE_PATTERNS          = *.m \
                         *.mm \
                         *.html \
                         *.h \
                         *.htm

我继续使用Doxygen 1.8.10看到这些警告，而我的doc set无法正确构建。

Answer 1

发生此错误是因为您在DoxygenLayout.xml中引用了FAQ组，但没有文件与该组关联。

在这种情况下，原因可能是因为您的html文件未被Doxygen读取和解析。这是因为默认情况下默认的DoxygenConfig FILE_PATTERNS参数不包含html。

尝试更改您的FILE_PATTERNS以包含html和所有其他所需的扩展程序，可能是这样的：

EXTENSION_MAPPING      = htm=Objective-C html=Objective-C

您还可以更改EXTENSION_MAPPING以确定将用于HTML文件的解析器，因为没有默认的HTML解析器。你提到的语法对我来说很好。

我不确定为什么从版本1.8.4更改为1.8.8。版本1.8.10的bug report意味着这是一个常见的错误，开发人员甚至添加了文档来澄清这种行为。

来自OP的注释 - 我需要这个映射：

{{1}}

DoxygenLayout.xml解析未找到显式链接请求

1 个答案: