Sphinx не будет обновлять страницу html при обновлении файла python

Question

У меня проблема с тем, что Sphinx не обновляет страницу html при обновлении моего python файла.

Мой 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 файл), затем страница html обновляется при запуске make html.

Чего мне не хватает или как это исправить? Действительно предпочел бы, чтобы имя hqc folder оставалось hqc.

Answer 1

Иногда происходит, когда sphinx не распознает изменения, используйте make clean && make html, это сначала удалит все существующие файлы, а затем создаст новые.