使用 doxygen 将索引添加到 TOC答案

【问题标题】：Add index to TOC with doxygen使用 doxygen 将索引添加到 TOC
【发布时间】：2017-06-06 15:38:38
【问题描述】：

我正在使用 doxygen 为 C 项目创建文档（PDF）。我希望索引显示在目录中。这是simple enough，带有 [pdf]latex。

问题 #1：我无法使用 tocbibind 或 idxlayout 包（请参阅上面的链接）。如果我尝试将这些与 doxygen 一起使用

EXTRA_PACKAGES = [nottoc]tocbibind

然后 doxygen 写入 TeX 源文件

\usepackage{[nottoc]{tocbibind}}

额外的 {} 会导致 LaTeX 错误。这似乎是 doxygen 中的错误？

问题 #2：这给我留下了 imakeidx 包（再次，请参见上面的链接）。在 doxygen 配置文件中

EXTRA_PACKAGES = imakeidx

但现在我需要从\makeindex 更改为\makeindex[intoc]。

回到 Doxyfile：

MAKEINDEX_CMD_NAME = makeindex[intoc]

但这没有明显的效果。对于实际让索引显示在目录中的任何建议？

【问题讨论】：

我能想到至少一种解决方法（编辑 Doxygen 创建的 refman.tex 文件......这甚至可以用 sed -i 完成并包装成别名）但必须有一个更好的方法...
问题#2下提到的问题是由于误解造成的，MAKEINDEX_CMD_NAME是Makefile/make.bat中用于将tex文件转换为pdf的命令。对于 tex 文件中的部分，没有任何内容。
对于 #2 下提到的问题，我刚刚将建议的补丁推送到 github（拉取请求 715，github.com/doxygen/doxygen/pull/715）。
感谢@albert 提供非常有用的信息。

【解决方案1】：

所描述的问题发生在 Doxygen 1.6.1 中。上面的问题 #1 已修复（请参阅here）。在 Doxygen 1.8.7（我现在正在使用）中，索引包含在 TOC 中没有问题。

更新：问题 #2 是基于我自己对配置选项的误解。请参阅the comment from albert，他提出了一个提供我想要的功能的补丁。

编辑：提到的拉取请求 715 已集成到 github 上的 master 中。

【讨论】：