documentation - 控制 Doxygen 的 LaTeX 输出以制作 PDF 文档

Question

我正在使用 Doxygen 为我的代码生成文档。我需要制作一个 PDF 版本，使用 Doxygen 的 LaTeX 输出似乎是这样做的方法。

但是，我遇到了许多烦人的问题，而且以前对 LaTeX 一无所知，对如何处理它们并没有太多的想法，而且与 LaTeX 相关的无数引用资料也没有多大帮助......

我研究了如何在 sty 文件中创建自定义样式的东西以及如何让 Doxygen 使用它。经过大量搜索，我发现了如何通过此设置页边距等，我猜这可能是我想要做其他我想做的事情的文件，但我似乎找不到任何命令 doign我想要的是 :(

文档开头的目录包含很多项目 Id 而不是因为它使内容很长。有没有办法限制这些内容只说前两个级别，而不是每个单独的函数、变量等都有条目？然而，我非常喜欢保留所有书签。我确实尝试了“COMPACT_LATEX”选项，但除了删除内容页面上的项目外，它还删除了每个部分开头的书签和成员列表，我确实想保留这些内容。

有没有办法改变事物的顺序，比如将完整的类描述放在部分的开头，而不是放在所有成员和属性之后？

Answer 1

哇，这就是 Doxygen 的邪恶之处。

好的，绕过 tocdepth计数器问题，将以下行添加到您的 .sty文件:

\AtBeginDocument{\setcounter{tocdepth}{2}}% or whatever level you want

您可以将 PDF 书签深度设置为单独的值:

% requires you \usepackage{hyperref} first
\hypersetup{
  bookmarksdepth = section, % of whatever level you want
}

另请注意，如果您有图表/表格列表，tocdepth必须至少为 2 才能显示。

我看不到在 LaTeX 文件中重新排列这些项目的任何方法——Doxygen 只是将它们排除在外，所以我们无能为力。您必须仔细查看 Doxygen 文档，看看是否有任何方法可以指定我猜的顺序。 (这是希望!)