如何使 sphinx-build 构建更快？

Question

sphinx -build 文档说它只重建更改的文件。但在这个项目中，它正在重建每个模块的所有输出文件。“高亮模块代码”阶段花费的时间特别长。Python 源文件根本没有改变，生成的 .rst 文件也没有改变sphinx-apidoc- 我只编辑了一些其他 .rst 文件。

sphinx-build该项目中有 700 多个模块，因此即使使用 ，也需要大约 20 分钟-j 8。我怎样才能让它更快？

我正在使用的命令是：

sphinx-build -M html source build

以及相关部分source/index.rst：

.. toctree::
   :maxdepth: 1

   tutorial/index
   library/modules
   development/index
   setup/index
   usage/index
   test_cases/index
   services/index
   troubleshooting
   todo/index

Indices and tables
------------------

* :ref:`genindex`
* :ref:`modindex`
* :ref:`search`

我正在更改services目录内的文件。

Answer 1

尝试将navigation_depth主题选项从默认值 4 更改为 2，然后collapse_navigation更改为True。看注释：

将collapse_navigation设置为False并使用高navigation_深度可能会导致具有许多文件和深层文件结构的项目生成文件大小明显更大且编译时间更长的HTML文件。”