Как я могу сделать сборку sphinx-build быстрее?

Question

Документация sphinx-build говорит, что он перестраивает только измененные файлы. Но в этом проекте он перестраивает все выходные файлы для каждого модуля. Этап "Подсветка кода модуля" занимает особенно много времени. Исходные файлы Python вообще не изменились, равно как и файлы.rst, созданные sphinx-apidoc - Я только отредактировал некоторые другие.rst файлы.

В этом проекте более 700 модулей, так что sphinx-build, даже с -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_depth может привести к тому, что проекты с большим количеством файлов и глубокой структурой файлов будут генерировать файлы HTML, размер которых значительно больше, а время компиляции значительно больше ".

Answer 2

Я добавил следующее свойство conf.py:

html_copy_source = False

С этим свойством Sphinx не копирует исходные файлы в выходные данные (по умолчанию он копирует исходные файлы в "_sources").

Это не ускорило сборку, но у меня есть SSD-накопитель. Может быть, если у вас есть обычный, процесс быстрее, потому что Sphinx должен копировать меньше файлов.