Ensure deterministic resolution of toctree

sphinx-doc · Sep 15, 2024 · ec51d9a · ec51d9a
1 parent 0438178
commit ec51d9a
Showing 1 changed file with 3 additions and 0 deletions.
diff --git a/sphinx/builders/__init__.py b/sphinx/builders/__init__.py
@@ -613,6 +613,9 @@ def write(
                     docnames.add(tocdocname)
         docnames.add(self.config.root_doc)
 
+        # sort to ensure deterministic toctree generation
+        self.env.toctree_includes = dict(sorted(self.env.toctree_includes.items()))
+
         with progress_message(__('preparing documents')):
             self.prepare_writing(docnames)