PythonSphinx文档“准备文档”挂起

Question

我试图用Sphinx生成一个文档，但是生成的代码却挂在“preparing documents…”我在寻找解决方案，但没有找到任何解决问题的建议。在

将目录添加到所有文件后，问题出现。 文档结构如下所示：

几个模型：每个模型都有一些表（每个表一个文件） 示例：

• 型号=AUDITRAIL
• Tables=AUDITTRAIL_BFLOG.rst，审核跟踪_会话日志.rst在

在审核轨.rst在

AUDITTRAIL
==========

.. toctree::
   :maxdepth: 1

   AUDITTRAIL_BFLOG.rst
   AUDITTRAIL_SESSIONLOG.rst

审计跟踪_会话日志.rst在

AUDITTRAIL.SESSIONLOG

.. toctree:: :maxdepth: 1

AUDITTRAIL.rst

Keys and indexes

===== ===== ==================== seq type fields
===== ===== ==================== 1 P SESSIONLOGID 2 I USRID,SESSIONLOGID ===== ===== ====================

Fields

===== ==================== ===== ===== ========== =============== ==================== seq fieldname type inDB interface widgettype description
===== ==================== ===== ===== ========== =============== ==================== 5 CLIENTNAME S Y W20 EDITBOX Client name 4 COMPUTERNAME S
Y W20 EDITBOX Server name 6
CREDATIM E Y E8 EDITBOX Creation date field 11 DESCR S Y W1024
EDITBOXLONG Description field 10 LABEL S
Y W100 EDITBOX Label field 1
SESSIONLOGID N Y C10 EDITBOX Id field 8 UPDDATIM E Y E8
EDITBOX Update date field 2 USRID N
Y C10 EDITBOX id user 7
USRIDCRE N Y C10 EDITBOX Creation user id field 9 USRIDUPD N Y C10
EDITBOX Update user id field *3 USR_CODE S
N W30 EDITBOX * ===== ==================== ===== ===== ========== =============== ====================

我在每个表文件上添加了一个目录，以引用同一模型中的其他表。 我希望有人能帮助我。在

问候， 米沙

Answer 1

您的文档目录中有循环引用。在

AUDITRAIL.rst引用其TOC中的AUDITTRAIL_SESSIONLOG.rst，而{}引用回{}。不能有循环目录树引用，需要从一个文件或另一个文件中删除.. toctree::指令。在

在1.1.3之前，斯芬克斯的失败是一个RuntimeError: maximum recursion depth exceeded in cmp，在1.1.3中是changed to ignoring the circular toctree references and printing a warning message。在