狮身人面像-构建文档说它只重建修改过的文件。但是在这个项目中,它要重建每个模块的所有输出文件。“高亮模块代码”阶段需要特别长的时间。Python源文件一点也没有改变,sphinx-apidoc生成的sphinx-apidoc文件也没有改变--我只编辑了一些其他.rst文件。
这个项目中有超过700个模块,所以使用sphinx-build需要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目录中的文件。
发布于 2018-09-05 00:18:54
尝试将主题选项从默认的4更改为2,将collapse_navigation更改为True。见注:
将collapse_navigation设置为False并使用较高的navigation_depth可能会导致具有许多文件和深度文件结构的项目生成文件大小和编译时间都要大得多的HTML文件。“
发布于 2019-01-23 00:18:31
我向conf.py添加了以下属性
html_copy_source = False使用此属性,Sphinx不会将源文件复制到输出(默认情况下,它将源文件复制到"_sources")。
这没有加快建设,但我有一个SSD驱动器。如果您有一个常规的文件,这个过程可能会更快,因为Sphinx必须复制更少的文件。
https://stackoverflow.com/questions/51986357
复制相似问题