Sphinx 卡在阅读资源索引上

Question

当我输入make html时，Sphinx 卡在了阅读部分。

通过更改 "asp" 中的名称可以更改卡住的百分比。我的范围是 100% 到 25%。这是我在运行 make html:

时在终端中看到的示例

make html
sphinx-build -b html -d _build/doctrees   . _build/html
sphinx-build -b html -d _build/doctrees   . _build/html
Running Sphinx v1.2.1
loading pickled environment... done
building [html]: targets for 2 source files that are out of date
updating environment: 0 added, 2 changed, 0 removed
reading sources... [ 50%] asp

如前所述，50% 不是恒定的。通过更改 asp.rst 文件的名称，它会更改我获得的百分比。但它从未超过它。

这是我的 asp.rst 文件：

 .. _asp:

 TEST123
 =======


.. automodule:: rcegui
.. module:: RCEController
.. autoclass:: RCE_Control_MainWindow
    :members:

这是我的 index.rst 文件：

Welcome to GUI's documentation!
===============================

Contents:

.. toctree::
   :maxdepth: 2

   asp

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

这里是 conf.py:

import sys
import os
# If extensions (or modules to document with autodoc) are in another directory,
# add these directories to sys.path here. If the directory is relative to the
# documentation root, use os.path.abspath to make it absolute, like shown here.
#sys.path.insert(0, os.path.abspath('.'))
sys.path.append(os.path.abspath('../'))

# -- General configuration ------------------------------------------------

# If your documentation needs a minimal Sphinx version, state it here.
#needs_sphinx = '1.0'

# Add any Sphinx extension module names here, as strings. They can be
# extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
# ones.
extensions = [
'sphinx.ext.autodoc',
'sphinx.ext.doctest',
'sphinx.ext.coverage',
]

删除覆盖范围扩展也改变了阅读百分比。但它仍然卡住了。这似乎是由于 RCEController 文件造成的，它生成一个 GUI 并需要用户输入。

Answer 1

在asp.rst

开头加一行.. _asp:

.. _asp:

TEST123
=======

.. automodule:: rcegui
.. module:: RCEController
.. autoclass:: RCE_Control_MainWindow
   :members:

对于index.rst

Welcome to GUI's documentation!
===============================

Contents:

.. toctree::
   :maxdepth: 2

   asp

Indices and tables
==================

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

请按照正确的缩进和 space 行 .

的确切代码

例如在rst中，标题和下划线的长度应该相同。

TEST123
=======

Answer 2

所以我最后检查了 --init--.py 并且它没有我调用的程序所需的所有文件。所以在添加丢失的文件并重新启动它之后。 Sphinx 能够运行没有错误。我不确定是什么修复了它，但我觉得它正在将丢失的文件添加到 --init--.py 文件中。

Sphinx 卡在阅读资源索引上

Sphinx getting stuck on reading sources index

python

python-sphinx

autodoc