Sphinx:强制重建html,包括autodoc

Question

目前,每当我运行时sphinx-build,只有在源文件发生更改时才会拾取和使用内联文档字符串.我试过sphinx-build用-a开关调用,但这似乎没有效果.

如何强制完全重建HTML输出并强制执行autodoc？

Answer 1

如果-E 选项与之一起使用似乎有效-a.我将它添加到html我的目标中Makefile,现在更改了文档字符串,而不更新任何.rst文件.

Answer 2

我使用 的clean子命令make强制重建文档（正如 @Henrik 在他的评论中所述）。

您可以将其作为单独的命令发出：

make clean
make html

或者可以组合命令：

make clean html

Answer 3

我不使用sphinx-build但是使用make html我总是touch *.rst使用我的源文件.然后使html可以拾取更改.