具有导出到doxygen文档的目录的Markdown文件不会在HTML中创建TOC

时间:2018-03-30 19:25:05

标签: markdown doxygen tableofcontents

我有一个markdown文件用于通过cmake指令和doxyfile.in语句创建doxygen文档的一部分。生成的文档几乎是正确的。实际上这个降价文件是doxygen文档的主页。

降价文件的开头是

# Title1

[TOC]
## Title2

然后文件的其余部分继续。然而,当我生成doxygen文档时,目录不会出现。请问有人有任何线索吗?

1 个答案:

答案 0 :(得分:0)

我们正在处理页内目录。

看起来存在多个问题。

1)[TOC]应该在第一个标题之前(即#Title1)(当不是这种情况时,目录仍然是不正确的,除非给出其他命令,如\ page。)

2)TOC_INCLUDE_HEADINGS(在Doxyfile中,即doxygen配置文件)应设置为值> 0获得n页TOC。来自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.