Как добавить оглавление в файл html, созданный doxygen?

Question

У меня есть C-проект, документированный с помощью doxygen, и вы хотите добавить оглавление, которое показывает разделы и подразделы. Я попробовал \tableofcontents и [TOC], как описано в руководстве doxygen, но ничего не происходит. Вот небольшой пример:

/***********************************//** 
* \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

documentation для Doxygen говорит, что @tableofcontents работает только на дополнительных страницах (@page, @mainpage), а не в обычных блоках документации.

Вы все еще можете создать собственное оглавление, используя @ref и немного html (хотя это не так хорошо, как использование встроенной команды).