如何添加目錄到doxygen生成的html文件？

Question

我有一個與doxygen記錄的C項目，並希望添加一個目錄，顯示部分和子部分。我嘗試了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（儘管它不如使用內置命令）建立自己的目錄。