Python Sphinx未正确更新文档

我使用Sphinx来记录python应用程序，并使用

Sphinx\u build\u script-b html

命令来构建index.html文件。当修改docstring并再次使用相同的命令时，会发现html内容没有正确更新

我尝试过从_模块、_源代码和构建目录中删除所有索引文件，但没有任何运气

这是生成的html文件：

Classe de generation de report PDF
：参数方向：纵向方向。
PARAM单位：PAR Duffut毫米。
：参数格式：文件pdf格式（A4、A6、字母）。

这就是源代码：

“生成和谐类PDF
：参数方向：纵向方向。
：键入方向：char。
PARAM单位：PAR Duffut毫米。
：param格式：文件pdf格式（A4、A6、字母）。
这是一个更新
“”“

---

连续多次运行build命令后，html文件将更新1/5次。

这不是正确的方法。您应该首先使用生成项目。之后要添加的所有类/模块都应该手动添加到文档中，或者再次调用

apidoc

（尽管如果您已经自定义了最初生成的项目，则不应该这样做）

例如，以下指令将向页面递归添加新模块及其成员：

.. automodule:: foo.bar
   :members:
   :undoc-members:

它不像JavaDoc那样自动化，但在某些情况下，至少对文档进行一些控制会更好

---

另外，最好使用

makehtml

而不是您正在使用的任何东西，因为它确实会生成一些索引等。我记不太清楚了，但我敢肯定，当你用斯芬克斯的裸体脚本做这件事时，有些东西是不会生成的。

不知道你实际上在做什么。只是澄清一下：您正在使用Sphinx文档中描述的autodoc扩展？Sphinx不像JavaDoc，默认情况下，它不会从程序源代码中提取文档。是的，我正在使用autodoc，它成功地创建了.rst文件。问题是运行build命令时创建的html文件Sphinx与我的源文件不是最新的。@BlackJack