Define mainversion substitution as part of rst_prolog

python · hugovk · Jun 24, 2025 · Jun 19, 2025 · Jun 19, 2025 · Jun 19, 2025
commit 3064c16c689c77e4acad4aa4bf989edbe461b9f5
diff --git a/conf.py b/conf.py
@@ -167,8 +167,18 @@
 # sphinx-notfound-page
 notfound_urls_prefix = "/"
 
+# Dynamically expose the Python version associated with the "main" branch.
+# The release cycle data may not be ordered, so choose the numerically highest
+# version key instead of relying on a specific entry's position.
+with open("include/release-cycle.json", encoding="UTF-8") as _f:
+    _cycle = json.load(_f)
+_main_version = max(
+    _cycle,
+    key=lambda v: tuple(int(part) for part in v.split(".")),
+)
+
 # prolog and epilogs
-rst_prolog = """
+rst_prolog = f"""
 .. |draft| replace::
     This is part of a **Draft** of the Python Contributor's Guide.
     Text in square brackets are notes about content to fill in.
@@ -185,18 +195,9 @@
 
 .. _Refactoring the DevGuide: https://discuss.python.org/t/refactoring-the-devguide-into-a-contribution-guide/63409
 
-"""
+.. |mainversion| replace:: {_main_version}
 
-# Dynamically expose the Python version associated with the "main" branch.
-# The release cycle data may not be ordered, so choose the numerically highest
-# version key instead of relying on a specific entry's position.
-with open("include/release-cycle.json", encoding="UTF-8") as _f:
-    _cycle = json.load(_f)
-_main_version = max(
-    _cycle,
-    key=lambda v: tuple(int(part) for part in v.split(".")),
-)
-rst_prolog += f"\n.. |mainversion| replace:: {_main_version}\n"
+"""
 
 # sphinx.ext.extlinks
 # This config is a dictionary of external sites,