doxygen - doxygen @tableofcontents 不起作用

Question

我正在尝试使用 doxygen 生成用户帮助，当我在主页中使用命令 \tableofcontents 时，html 输出中没有显示任何内容。我只是不知道为什么，有人知道如何使用 tableofcontents 命令吗？一些例子会更好，谢谢！注意浏览器没问题。

Answer 1

解决方案的关键是在标题中添加标签：

This is a level 1 header {#labelid_H1}
========================

This is a level 2 header {#labelid_H2}
------------------------

# This is a level 1 header # {#labelidH1}

## This is level 2 header ## {#labelidH2}

然后是目录 [TOC]

[TOC]

以及标题链接

[Link to first headline](@ref labelid_H1) 
[Link to second headline](#labelid_H2)

在工作中。

另一点要提的是，Doxygen 占用了用作主页的文件中的第一行（在以下位置查找“吃我的短裤，Doxygen！”：使用 README.md 文件作为 Doxygen 的主页）