我有一个用“ 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级水平-屏幕截图:

有什么提示吗?

谢谢

佩尔



由jacob提供->只需认为所需的级别num -1:

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

最佳答案

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

\setcounter{tocdepth}{0}

08-25 22:29