如何避免使用Sphinx創建PDF時出現「嵌套太深」的錯誤？

我有一個相當大的文檔相當複雜的項目。轉換正常用戶指南通過make latexpdf工程相當不錯的獅身人面像PDF格式。但是，如果我還希望包括所有的函數，類和模塊單證庫引用，命令失敗：如何避免使用Sphinx創建PDF時出現「嵌套太深」的錯誤？

! LaTeX Error: Too deeply nested.

手動減少嵌套是不是一種選擇。獅身人面像在內部嵌套參數描述，功能描述，模塊描述和內容。因此，在每種情況下找出如何減少嵌套幾乎是不可能的。

來源

2015-02-11 SmCaterpillar

我通過向獅身人面像序言添加了一些乳膠語句來解決了這個問題。因此，我在我的sphinx 源文件夾中創建了一個新的latex_preamble.tex文件。它僅包含以下兩個命令：

\usepackage{enumitem} 
\setlistdepth{99}

此外，在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, 
}

因此，現在斯芬克斯使用enumitem包，允許任意嵌套。我想現在的enumitem應該是任何乳膠發行的一部分。我不需要安裝這個軟件包。此外，這也在read the docs的箱子上開箱即用。

來源

2015-02-11 12:31:25 SmCaterpillar

我發現我可以通過直接將命令直接輸入到conf.py文件中來實現相同的結果，因此：''preamble'：r'\ usepackage {enumitem} \ setlistdepth {99}'' – 2017-07-19 14:01:55

如何避免使用Sphinx創建PDF時出現「嵌套太深」的錯誤？

回答

相關問題