Sphinx-quickstart 在询问 "Separate source and build directories" 后中止

Question

我在 docs 目录下继承了一个包含 sphinx-quickstart 生成的工件的项目。部分内容发生了变化，我想重建它们。

我用过

  sphinx-quickstart

这不是一个很好的结果。下面的注释：我尝试了两个选项（y 和 n）来响应

Separate source and build directories (y/n) [n]:

Answer 1

sphinx-quickstart 是一个用于设置项目文档的工具。它不用于更新或维护文档。

假设您已经设置了 Python 虚拟环境，激活了虚拟环境，并安装了构建文档的要求，您应该能够使用 make <builder> 重建文档，其中 <builder> 是您要构建的文档的格式。例如，在与文档的 conf.py 文件相同的目录中，发出命令 make html。另见 documentation of sphinx-build。