我有一个相当复杂的项目，其中包含相当大的文档。
通过make latexpdf 使用Sphinx 将普通用户指南 转换为PDF 效果很好。但是，如果我还想在所有函数、类和模块文档中包含库引用，则命令失败并显示：
! LaTeX Error: Too deeply nested.
手动减少嵌套不是一种选择。 Sphinx 内部嵌套了参数描述、函数描述、模块描述等等。因此，在每种情况下找出如何减少嵌套几乎是不可能的。
【问题讨论】：
标签： python latex pdf-generation python-sphinx
我通过在 sphinx 序言中添加一些乳胶语句解决了这个问题。
因此，我在我的 sphinx source 文件夹中创建了一个新的 latex_preamble.tex 文件。它只包含以下两个命令：
\usepackage{enumitem}
\setlistdepth{99}
此外，在我的 source 文件夹中的conf.py 文件中，我更改了以下内容（您可以在conf.py 文件中查找latex_elements 变量，它通常被注释出）：
fh = open('latex_preamble.tex', 'r+')
PREAMBLE = fh.read()
fh.close()
latex_elements = {
# Additional stuff for the LaTeX preamble.
'preamble': PREAMBLE,
}
因此，现在 sphinx 使用允许任意嵌套的 enumitem 包。我想现在enumitem 应该是任何乳胶发行版的一部分。我不需要安装软件包。此外，这在 read the docs 上也可以开箱即用。
【讨论】：
'preamble': r'\usepackage{enumitem}\setlistdepth{99}'