狮身人面像被困在阅读源索引上

Question

当我输入make html时，狮身人面像会被卡在读取段上。

通过更改"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

所以我最后检查了--init-..py，它没有我调用的程序所需要的所有文件。所以在添加了丢失的文件并重新启动之后。狮身人面像没有错误地运行。我不知道是什么修复了它，但我觉得它是在将丢失的文件添加到-init-..py文件中。

Answer 2

在.. _asp:开头添加一行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`

请按照正确的代码与正确的缩进和空格线。

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

TEST123
=======