Doxygen Markdown 主页链接不起作用

Question

我正在使用 Doxygen 1.8.17 创建文档，其中有几个用 Markdown 编写的概述页面。为此，我正在创建一个主页和一些其他页面，它们之间将包含 links，如 this post 和 doxygen 文档中所示。

我的问题是，link从其他页面到主页（README.md）不起作用，而从主页到其他页面的 links 工作并且其他页面之间的 links 有效。

我使用默认的 doxyfile（doxygen -g 后跟 doxygen Doxyfile）编译了示例。编译时，doxygen 抱怨未解析的引用 (DoxyMinimalExample/otherpage.md:6: warning: unable to resolve reference to 'mainpage' for \ref command)

没有 link 到 README.md 有效。我如何创建一个 link 返回主页？ \ref 命令的正确名称是怎样的？

最小示例（同一文件夹中的所有文件）：README.md

# The Main Page {#mainpage}
My Main Page
============

Documentation that will appear on the main page

1. See [the other page](@ref otherpage) for more info.
2. or see @ref md_otherpage for more info.

or
1. See [the third page](@ref thirdpage) for more info.

otherpage.md

# The Other Page {#otherpage}
My other page
============

More detailed Info
1. See [the main page](@ref mainpage) for an overview.
2. See [the main page](@ref #mainpage) for an overview.
3. See [the main page](@ref #README) for an overview.
4. See [the main page](@ref README) for an overview.
5. See [the main page](@ref README.md) for an overview.
6. See [the main page](README.md) for an overview.
7. See [the main page](@ref md_README) for an overview.
8. See [the main page](@ref md_mainpage) for an overview.
9. See [the main page](md_README) for an overview.
10. See [the main page](md_mainpage) for an overview.
11. See @ref mainpage for an overview.
12. See [the main page](@ref md_README.md) for an overview.
13. See @ref md_README for an overview.
14. See @ref md_README.md for an overview.

or
1. See [the third page](@ref thirdpage) for other info

thirdpage.md

# The Third Page {#thirdpage}
My third page
============

More detailed Info
1. See [the other page](@ref otherpage) for other info

Answer 1

有点奇怪，锚点{#mainpage}的页面无法在doxygen中引用，必须使用'index'作为引用。

我刚刚将提议的补丁推送到 github（拉取请求 7511，https://github.com/doxygen/doxygen/pull/7511）以解决这个问题。

编辑：拉取请求的代码已集成到 github

的 master 中

Doxygen Markdown 主页链接不起作用

Doxygen Markdown Links to main page do not work

markdown

doxygen