在Sphinx文档期间覆盖.rst文件

Question

假设我们有一个如下所示的文档结构

.
|____src
| |____abc.py
|____docs

现在，我们使用以下命令生成文档：

sphinx-apidoc -F -o docs src

这将在./docs/文件夹中生成几个文件， 包括 ./docs/abc.rst ，我现在可以使用./docs/文件夹中的make html来构建./docs/文件。

现在，在./src/abc.py添加一些其他功能./src/abc.py我想重建文档。 我尝试相同的操作，Sphinx说其余文件已经存在，因此它没有更新。 在更新文档之前，我必须手动删除相关文件。

现在的问题是，如何执行整个过程而不必诉诸于删除.rst文件。

Answer 1

sphinx-apidoc具有--force选项，用于覆盖文件。

参见http://www.sphinx-doc.org/en/stable/man/sphinx-apidoc.html#sphinx-apidoc-manual-page 。