1

Sphinx でドキュメントを生成しようとしましたが、生成が「ドキュメントの準備中..」でハングします。解決策を探していますが、問題を解決するためのアドバイスが見つかりません。

この問題は、すべてのファイルに目次を追加した後に発生します。ドキュメントの構造は次のようになります。

いくつかのモデル: すべてのモデルにはいくつかのテーブルがあります (テーブルごとに 1 つのファイル) 例:

  • モデル = アウディトレイル
  • テーブル = AUDITTRAIL_BFLOG.rst、AUDITTRAIL_SESSIONLOG.rst

AUDITRAIL.rst

AUDITTRAIL
==========

.. toctree::
   :maxdepth: 1

   AUDITTRAIL_BFLOG.rst
   AUDITTRAIL_SESSIONLOG.rst

AUDITTRAIL_SESSIONLOG.rst

AUDITTRAIL.SESSIONLOG

.. toctree:: :最大深度: 1

AUDITTRAIL.rst

キーとインデックス

===== ===== ==================== seq 型フィールド
===== ===== ======= ============= 1 P セッションログ ID 2 I USRID、セッションログ ID ===== ===== ================== =

田畑

===== ==================== ===== ===== ========== ===== ========== ==================== seq フィールド名 タイプ inDB インターフェイス ウィジェットタイプ 説明 =====
======== ============ ===== ===== ========== ================== ================ 5 CLIENTNAME SY W20 EDITBOX クライアント名 4 COMPUTERNAME S
Y W20 EDITBOX サーバー名 6
CREDATIM EY E8 EDITBOX 作成日フィールド 11 DESCR SY W1024
EDITBOXLONG 説明フィールド 10 LABEL S
○ W100 EDITBOX ラベルフィールド 1
SESSIONLOGID NY C10 EDITBOX Id フィールド 8 UPDDATIM EY E8
EDITBOX 更新日付フィールド 2 USRID N
Y C10 EDITBOX id ユーザー 7
USRIDCRE NY C10 EDITBOX 作成ユーザー ID フィールド 9 USRIDUPD NY C10
EDITBOX 更新ユーザー ID フィールド *3 USR_CODE S
N W30 EDITBOX * == === =================== ===== ===== ========== ======= ======== ====================

同じモデルの他のテーブルを参照するために、すべてのテーブル ファイルに目次を追加しました。誰かが私を助けてくれることを願っています。

あいさつ、ミーシャ

4

1 に答える 1

3

ドキュメントの TOCに循環参照があります。

AUDITRAIL.rstAUDITTRAIL_SESSIONLOG.rstTOC 内の参照、およびへのAUDITTRAIL_SESSIONLOG.rst参照AUDITTRAIL.rst。循環的な toctree 参照を持つことはできません.. toctree::。いずれかのファイルからディレクティブを削除する必要があります。

1.1.3 までは、Sphinx は で失敗しました。1.1.3 では、循環 toctree 参照を無視して警告メッセージを表示するように変更されましRuntimeError: maximum recursion depth exceeded in cmpた。

于 2012-08-27T17:37:59.343 に答える