“准备文档”挂起-Sphinx中的toctree循环引用

Question

[我尝试使用Sphinx生成文档，但是该生成过程挂在“准备文档..”上，我正在寻找解决方案，但没有找到解决问题的建议。

向所有文件添加目录后出现问题。该文档的结构如下所示：

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

• Model = AUDITRAIL
• 表= AUDITTRAIL_BFLOG.rst，AUDITTRAIL_SESSIONLOG.rst

AUDITRAIL.rst

AUDITTRAIL
==========

.. toctree::
   :maxdepth: 1

   AUDITTRAIL_BFLOG.rst
   AUDITTRAIL_SESSIONLOG.rst

AUDITTRAIL_SESSIONLOG.rst

AUDITTRAIL.SESSIONLOG

.. toctree :: :: maxdepth：1

AUDITTRAIL.rst

键和索引

===== ===== ==================== seq类型字段===== ===== =================== 1 P SESSIONLOGID 2 I USRID，SESSIONLOGID===== ===== ===================

字段

===== ============================================= =============================== seq字段名称类型inDB接口小部件类型描述===== ============================================= ============================= 5 CLIENTNAME SY W20 EDITBOX客户端名称4 COMPUTERNAME S是W20 EDITBOX服务器名称6CREDATIM E Y E8 EDITBOX创建日期字段11 DESCR S Y W1024EDITBOXLONG说明字段10标签S是W100 EDITBOX标签字段1SESSIONLOGID N Y C10 EDITBOX ID字段8 UPDDATIM E Y E8EDITBOX更新日期字段2 USRID N是C10 EDITBOX ID用户7USRIDCRE N Y C10 EDITBOX创建用户ID字段9 USRIDUPD N Y C10EDITBOX更新用户ID字段* 3 USR_CODE SN W30编辑框*===== ============================================= =============================

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

问候，Mischa

Answer 1

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

AUDITRAIL.rst引用其TOC中的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。