我有一个相当复杂的项目，有相当大的文档。
转换正常用户指南使用 Sphinx 转为 PDF 通过make latexpdf效果很好。但是，如果我还想在所有函数、类和模块文档中包含库引用，则该命令将失败并显示：
! LaTeX Error: Too deeply nested.
手动减少嵌套不是一种选择。 Sphinx内部嵌套了参数描述、函数描述、模块描述等。因此，弄清楚每种情况下如何减少嵌套几乎是不可能的。
我通过在 sphinx 序言中添加一些乳胶语句解决了这个问题。
因此，我创建了一个新的latex_preamble.tex文件在我的狮身人面像中source文件夹。它只包含以下两个命令：
\usepackage{enumitem}
\setlistdepth{99}
此外，在conf.py文件，也在我的source文件夹中，我更改了以下内容（您可以查找latex_elements变量在conf.py文件，通常被注释掉）：
fh = open('latex_preamble.tex', 'r+')
PREAMBLE = fh.read()
fh.close()
latex_elements = {
# Additional stuff for the LaTeX preamble.
'preamble': PREAMBLE,
}
因此，现在 sphinx 使用enumitem允许任意嵌套的包。我猜现在enumitem应该是任何乳胶发行版的一部分。我不需要安装该软件包。此外，这也可以开箱即用阅读文档 https://readthedocs.org/.
本文内容由网友自发贡献，版权归原作者所有，本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容，请联系:hwhale#tublm.com(使用前将#替换为@)
