使用doxygen 1.8.3引用markdown主页内容

时间:2013-03-04 11:38:42

标签: markdown doxygen

我正在使用像这样的降价主页(mainpage.md

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

qwertz

A Section
---------

asdf

与配置中的USE_MDFILE_AS_MAINPAGE = mainpage.md一起使用。

我想(自动)链接到来自coude的文档中的“A Section”部分,但我还没有想出如何做到这一点。我假设'A Section'生成一个可自动链接的目标,但我如何引用它(即使用\see ?WhatToWriteHere?)?

另外,尝试这个

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

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

1 个答案:

答案 0 :(得分:1)

如果您使用@section section_01 A Section编码主页而不是使用=====下划线,则可以使用doxygen命令

@ref section_01 "text for link here"

从其他地方创建指向它的链接。我正在使用1.8.5成功地做到这一点。

似乎由Doxygen处理的vanilla markdown标题(使用#sequences序列的下划线)不会产生Doxygen识别为目标的任何内容 - 无论是链接到文档索引还是列表(这有点令人沮丧)