当路径为目录时，Doxygen 引用 link 失败

Question

我正在使用 doxygen 生成 C++ 项目文档，在 .md 文件中使用 reference link @ref。一些 @ref 在 html 页面中生成真正的 hyperlink，而其他的则不会（当 .md 文件的真实路径更深时）。

重现：

- docs
  - root.md
  - Doxyfile
- src
  - rok_core
    - doc
      - test.md
    - do
      - test.md

Doxy文件：

...
INPUT: root.md \
../src/rok_core/doc/test.md \
../src/rok_core/do/test.md \
...

doc/root.md:

Rok {#mainpage}
===

- @ref test
- @ref test2

src/rok_core/doc/test.md:

test {#test}
=====

src/rok_core/do/test.md:

test2 {#test2}
=====

预期的行为：test 和 test2 在主页（从 root.md 生成）中都是 link，但实际上 test2 是 link 但 test 不是 link.

好吧，我终于明白是我的错了。我提供的示例可以生成所有@ref link。我误写了涵盖我的文档目录的 EXCLUDE，导致了这个愚蠢的问题。非常抱歉。

Answer 1

根据问题中的信息并将 INPUT 标记更正为：

INPUT= root.md \
../src/rok_core/doc/test.md \
../src/rok_core/do/test.md

（Doxyfile 的其余部分留空）。我启动了 doxygen (1.9.2 (97cb0de4dab1f9eb77325f7ee9f46dcaed8b0c69)) 结果是：

其中两个 test 都是链接（指向正确的位置）。

Doxygen reference link failed when path is directory