在python中使用sphinx自动生成功能文档不再有效

时间:2019-02-19 03:12:35

标签: python python-sphinx

编辑注意,我发现问题是由我的安装错误引起的-我认为这是由于导入matplotlib引起的错误。我已经保留了对问题的解释,但是我想知道为什么问题会破坏事情。

我以前在我的文档中有一个页面,列出了每个函数,并有指向该列表的链接,用于单个函数的文档。当前没有链接的版本位于https://epidemicsonnetworks.readthedocs.io/en/latest/,代码位于https://github.com/springer-math/Mathematics-of-Epidemics-on-Networks

我这样做是基于对我之前的问题的回答:Using Sphinx to automatically generate a separate document for each function

我刚刚发现文档不再具有该链接。尽管我尝试找出所有问题,但我的.rst文件中找不到任何更改。当我从github上获取我的代码的旧版本时,我肯定可以使用它,但是我仍然遇到相同的问题。

这就是我认为与代码相关的位(在文件EoN.rst中)

Quick list
^^^^^^^^^^

.. currentmodule:: EoN

.. autosummary::
   :toctree: functions

   fast_SIR
   fast_nonMarkov_SIR
   fast_SIS

(列表很长)。

文件夹functions/与相关的.rst文件以functions/EoN.fast_SIR.rst等存在。但是,当我删除该文件夹时,这些{.1st}文件不再由sphinx-autobuild . _build/html自动生成,尽管空文件夹被重新创建。我给自己的笔记建议应自动创建一个新的.rst文件。

在我不知情的情况下狮身人面像有变化吗?
还是我在没有注意的情况下进行了更改?

编辑我最近安装了Anaconda 4.3.1,这导致我的matplotlib安装出现了一些问题(我收到一个错误消息,指出Python不是框架)。这可能是为什么sphinx-autobuild不再按照我的期望做事的原因吗?

重新编辑,我现在已在另一台计算机上重做了此操作,并且它的行为符合预期。因此,这不是代码,这与我的安装有关,很可能是导入matplotlib失败的事实。因此,我更新的问题是:导入失败会导致sphinx-autobuild失败吗?如果失败,为什么?

0 个答案:

没有答案