我有一个用“ 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}