Python Sphinx文档 - “准备文档”挂起

Question

我尝试使用Sphinx生成一个文档但是这一代依赖于“准备文档......”我搜索了一个解决方案，但我找不到任何解决问题的建议。

将内容表添加到所有文件后，会出现问题。 文档的结构如下所示：

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

• 型号= AUDITRAIL
• Tables = 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我USRID，SESSIONLOGID   ===== ===== ====================

     

字段

     

===== ==================== ===== ===== ========== == ============= ==================== seq fieldname type inDB界面widgettype描述
  ===== ==================== ===== ===== ========== ===== ========== ==================== 5 CLIENTNAME SY W20 EDITBOX客户名称4 COMPUTERNAME S
  Y W20 EDITBOX服务器名称6
  CREDATIM E Y E8 EDITBOX创作   日期字段11 DESCR S Y W1024
  EDITBOXLONG描述字段10 LABEL S
  Y W100 EDITBOX标签栏1   SESSIONLOGID N Y C10 EDITBOX Id   字段8 UPDDATIM E Y E8
  EDITBOX更新日期字段2 USRID N
  Y C10 EDITBOX id用户7
  USRIDCRE N Y C10 EDITBOX创作   用户ID字段9 USRIDUPD N Y C10
  EDITBOX更新用户ID字段* 3 USR_CODE S
  N W30 EDITBOX *   ===== ==================== ===== ===== ========== ===== ========== ====================

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

问候语， 米莎

Answer 1

您的文件“TOC”中有循环引用。

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。