latex - 如何设置 Sphinx 和 latexpdf toc 深度？

Question

我有一个用“sphinx-quickstart”创建的香草狮身人面像项目（Sphinx 1.2b3。）

我添加了一个带有 4 个标题级别的基本 page.rst。

我可以在 index.rst 中控制 html toc 的深度：

.. toctree::
   :maxdepth: 1
   :numbered:

   page

根据文档http://sphinx-doc.org/latest/markup/toctree.html我调整 conf.py 如下：

ADDITIONAL_PREAMBLE = """
\setcounter{tocdepth}{1}
"""

latex_elements = {
# The paper size ('letterpaper' or 'a4paper').
'papersize': 'a4paper',

# The font size ('10pt', '11pt' or '12pt').
#'pointsize': '10pt',

# Additional stuff for the LaTeX preamble.
'preamble': '\setcounter{tocdepth}{1}'
#'preamble': ADDITIONAL_PREAMBLE
}

然后我建立：

$ make clean
$ make html
$ make latexpdf

html 仅按预期显示 1 级，但 pdf 继续显示 2 个 toc 级别 - 屏幕截图：

有什么提示吗？

谢谢

佩尔

解决方案

由 jacob 提供 -> 简单地认为所需的级别 num -1：

'preamble': '\setcounter{tocdepth}{0}'

Answer 1

默认的 Sphinx 乳胶文档类基于报告类并使用章节，因此在您必须设置的乳胶目录中仅显示章节名称

\setcounter{tocdepth}{0}