主页同一子文件夹中的参考文件

Question

我正在设置一个 Doxygen 文件，看起来有点像这样：

INPUT                  = doc src test
USE_MDFILE_AS_MAINPAGE = doc/README.md

我的文件结构是这样的

├── Doxyfile
├── doc
   ├── CHANGELOG.md
   ├── README.md
   ├── STYLEGUIDE.md
   ├── doxygen
   └── logo.png

README.md 看起来像这样：

# Introduction

This page contains the documentation for the project.

## Resources

- [Changelog](doc/CHANGELOG.md)
- [Styleguide](doc/STYLEGUIDE.md)

当我运行 doxygen 时，我收到以下警告：

doc/README.md:7: warning: unable to resolve reference to `doc/CHANGELOG.md' for \ref command

和我的 html 输出包含 README.md 的内容，但没有链接。文档（CHANGELOG.md 和 STYELGUIDE.md）可以在相关页面下找到，但它们的内容缺少所有部分 headers - README.md 也是如此，除了标题。

所有其他文档（类等）均按预期生成。将 README.md 移动到根文件夹没有帮助。

我做错了什么？

Doxygen 1.8.12

Answer 1

我做了我从一开始就应该做的事情——生成一个干净的 Doxyfile，然后用我当前的文件做一个 diff。

显然，这是由于 TOC_INCLUDE_HEADINGS 设置为 3 造成的。将其设置为 0 解决了这个问题，但我必须承认我不知道为什么，也不明白 [=10] =] 应该可以工作。

主页同一子文件夹中的参考文件

Reference files in same subfolder from main page

markdown

doxygen