python - 更新python文件时，Sphinx不会更新html页面

Question

我有一个问题，当我的 python 文件更新时，Sphinx 不会更新 html 页面。

我的 docs folder看起来像这样:

api.rst上面文件夹中的文件如下所示:

API Documentation
=================

This is a documentation for the Helstrom Quantum Centroid (HQC) classifier's API.

.. automodule:: hqc.HQC
    :members:

hqc folder看起来像这样:


两者docs folder和 hqc folder都在同一个 HQC folder .

当我更新 HQC.py文件并运行 make html在命令提示符下，html 页面不会自行更新。

但是我注意到当我将文件夹名称从 hqc 更改时到一个新的文件夹名称，比如 hqc1 (并在 hqc.HQC 文件中将 hqc1.HQC 更改为 api.rst)，然后当我运行 make html 时 html 页面会更新.

我错过了什么或如何解决这个问题？真的更喜欢hqc folder姓名留为hqc .

Answer 1

有时会在 sphinx 无法识别更改时发生，请使用 make clean && make html ，这将首先删除所有现有文件，然后创建新文件。