markdown - 使用 doxygen 1.8.3 引用 markdown 主页内容

Question

我正在使用这样的降价主页（mainpage.md）

The Main Page
=============

qwertz

A Section
---------

asdf

连同USE_MDFILE_AS_MAINPAGE = mainpage.md在配置中。

我想从源代码中的文档（自动）链接到“A Section”部分，但我还没有弄清楚如何做到这一点。我假设“A 部分”生成一个可自动链接的目标，但我如何引用它（即使用\see ?WhatToWriteHere?）？

另外，尝试这个

A Section {#asdfg}
---------

产生奇怪的警告found subsection command outside of section context!。

Answer 1

如果您使用@section section_01 A Section而不是使用=====下划线对主页进行编码，那么您可以使用 doxygen 命令

@ref section_01 "text for link here"

从其他地方创建指向它的链接。我正在使用 1.8.5 成功完成此操作。

似乎 Doxygen 处理的 vanilla markdown 标头（使用 # 序列的下划线）不会产生任何 Doxygen 识别为目标的东西 - 无论是用于链接到文档索引还是用于在文档索引中列出（这有点令人沮丧）。