Существует файл уценки, который я использую для создания части документации doxygen с помощью директив cmake и операторов doxyfile.in. Сгенерированная документация почти правильная. На самом деле этот файл уценки является главной страницей документации doxygen.
Начало файла уценки читается
# Title1
[TOC]
## Title2
и остальная часть документа продолжается. Тем не менее, когда я генерирую документацию doxygen, оглавление не появляется. Пожалуйста, кто-нибудь что-нибудь знает?
Здесь мы имеем дело с оглавлением на странице.
Похоже, что проблем несколько.
1) [TOC] должен быть перед первым заголовком (т. е. # Title1) (в этом случае оглавление по-прежнему неверно, если не указаны другие команды, такие как \page.)
2) TOC_INCLUDE_HEADINGS (в Doxyfile, то есть в файле конфигурации doxygen) должно быть установлено значение > 0, чтобы получить оглавление на n страницах. Из документации Doxyfile/doxygen:
# When the TOC_INCLUDE_HEADINGS tag is set to a non-zero value, all headings up # to that level are automatically included in the table of contents, even if # they do not have an id attribute. # Note: This feature currently applies only to Markdown headings. # Minimum value: 0, maximum value: 99, default value: 0. # This tag requires that the tag MARKDOWN_SUPPORT is set to YES.
