如何将 table 的内容添加到 doxygen 生成的 html 文件中？

Question

我有一个用 doxygen 记录的 C 项目，我想添加一个 table 的内容来显示部分和小节。我按照 doxygen 手册中的描述尝试了 \tableofcontents 和 [TOC]，但没有任何反应。这是一个小例子：

/***********************************//**
 * \file        Bsp.c
 * \brief       example
 *
 * \tableofcontents
 *
 * \section sec1 section 1
 * blabla
 *
 * \section sec2 section 2
 * blabla
 *
 * \subsection ssec21 subsection 21
 * blabla
 ***********************************/



/***********************************//**
 * \brief   
 *
 * \section sec1func funcsection 1
 * blabla
 ***********************************/
void func() 
{

}

这是我在 html 中得到的：

link to output of example

我做错了什么？预先感谢您的每一个提示！

Answer 1

doxygen 的 documentation 表示，@tableofcontents 仅适用于额外页面（@page、@mainpage），不适用于常规文档块。

您仍然可以使用 @ref 和一些 html 构建您自己的 table 内容（尽管它不如使用内置命令好）。