У меня есть проект vanilla sphinx (Sphinx 1.2b3.), созданный с помощью «sphinx-quickstart».
Я добавляю базовый page.rst с 4 уровнями заголовков.
Я могу контролировать глубину html toc в index.rst:
.. 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}'