Merge pull request #7128 from readthedocs/humitos/sphinx-j-auto

Author: humitos

readthedocs/doc_builder/backends/sphinx.py

@@ -234,6 +234,7 @@ def build(self):
         build_command = [
             *self.get_sphinx_cmd(),
             '-T',
+            *self.sphinx_parallel_arg(),
         ]
         if self._force:
             build_command.append('-E')
@@ -270,6 +271,11 @@ def get_sphinx_cmd(self):
             self.python_env.venv_bin(filename='sphinx-build'),
         )
 
+    def sphinx_parallel_arg(self):
+        if self.project.has_feature(Feature.SPHINX_PARALLEL):
+            return ['-j', 'auto']
+        return []
+
     def venv_sphinx_supports_latexmk(self):
         """
         Check if ``sphinx`` from the user's venv supports ``latexmk``.
@@ -448,6 +454,7 @@ def build(self):
             *self.get_sphinx_cmd(),
             '-b',
             'latex',
+            *self.sphinx_parallel_arg(),
             '-D',
             'language={lang}'.format(lang=self.project.language),
             '-d',

readthedocs/projects/models.py

@@ -1594,6 +1594,7 @@ def add_features(sender, **kwargs):
     LIST_PACKAGES_INSTALLED_ENV = 'list_packages_installed_env'
     VCS_REMOTE_LISTING = 'vcs_remote_listing'
     STORE_PAGEVIEWS = 'store_pageviews'
+    SPHINX_PARALLEL = 'sphinx_parallel'
 
     FEATURES = (
         (USE_SPHINX_LATEST, _('Use latest version of Sphinx')),
@@ -1687,6 +1688,10 @@ def add_features(sender, **kwargs):
             STORE_PAGEVIEWS,
             _('Store pageviews for this project'),
         ),
+        (
+            SPHINX_PARALLEL,
+            _('Use "-j auto" when calling sphinx-build'),
+        ),
     )
 
     projects = models.ManyToManyField(