我尝试使用Sphinx生成文档，但是该生成过程挂在“准备文档..”上。我在寻找解决方案，但找不到解决该问题的建议。
将目录添加到所有文件后，出现此问题。
该文档的结构如下所示：
一些模型：每个模型都有一些表（每个表一个文件）
例：
型号= AUDITRAIL
表格= AUDITTRAIL_BFLOG.rst，AUDITTRAIL_SESSIONLOG.rst
AUDITRAIL.rst
AUDITTRAIL
==========
.. toctree::
:maxdepth: 1
AUDITTRAIL_BFLOG.rst
AUDITTRAIL_SESSIONLOG.rst
AUDITTRAIL_SESSIONLOG.rst
审核日志
.. toctree ::：maxdepth：1
音频跟踪
键和索引
===== ===== =================== seq类型字段
===== ===== =================== 1 P SESSIONLOGID 2 I USRID，SESSIONLOGID
===== ===== ===================
领域
===== ============================================= ============================= seq字段名称类型inDB接口小部件类型描述
===== ============================================= ============================= 5 CLIENTNAME SY W20 EDITBOX客户端名称4 COMPUTERNAME S
是W20 EDITBOX服务器名称6
CREDATIM E Y E8 EDITBOX创建
日期字段11 DESCR S Y W1024
EDITBOXLONG说明字段10标签S
是W100 EDITBOX标签字段1
SESSIONLOGID N Y C10 EDITBOX ID
字段8 UPDDATIM E Y E8
EDITBOX更新日期字段2 USRID N
是C10 EDITBOX ID用户7
USRIDCRE N Y C10 EDITBOX创建
用户ID字段9 USRIDUPD N Y C10
EDITBOX更新用户ID字段* 3 USR_CODE S
N W30编辑框*
===== ============================================= =============================
我在每个表文件上添加了一个目录表，以引用同一模型中的其他表。
我希望有人能帮助我。
问候语
米沙
最佳答案
您的文档目录中有循环引用。AUDITRAIL.rst在其目录中引用AUDITTRAIL_SESSIONLOG.rst，并且AUDITTRAIL_SESSIONLOG.rst引用回到AUDITTRAIL.rst。您不能具有循环的toctree引用，需要从一个文件或另一个文件中删除.. toctree::指令。
直到1.1.3 Sphinx失败并出现RuntimeError: maximum recursion depth exceeded in cmp，而在1.1.3中则为changed to ignoring the circular toctree references and printing a warning message。
关于python - Python Sphinx文档-“准备文档”挂起，我们在Stack Overflow上找到一个类似的问题：https://stackoverflow.com/questions/12143156/