From 8fca4392bf55abfc8e244cf80d73f9dcbc109545 Mon Sep 17 00:00:00 2001
From: Maciej Olko <maciej.olko@affirm.com>
Date: Sun, 13 Sep 2026 21:16:11 +0200
Subject: [PATCH 1/4] Do not copy docs source to html build

---
 Doc/conf.py                               | 3 +++
 Doc/tools/templates/customsourcelink.html | 2 +-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/Doc/conf.py b/Doc/conf.py
index c768e6fd676a5a..053c14b708f750 100644
--- a/Doc/conf.py
+++ b/Doc/conf.py
@@ -306,6 +306,9 @@
 # Path to find HTML templates to override theme
 templates_path = ['tools/templates']
 
+# Link to sources on GitHub instead of copying them into the HTML output.
+html_copy_source = False
+
 # Custom sidebar templates, filenames relative to this file.
 html_sidebars = {
     # Defaults taken from https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-html_sidebars
diff --git a/Doc/tools/templates/customsourcelink.html b/Doc/tools/templates/customsourcelink.html
index 8feeed2fee3650..c44b8774a0831b 100644
--- a/Doc/tools/templates/customsourcelink.html
+++ b/Doc/tools/templates/customsourcelink.html
@@ -1,4 +1,4 @@
-{%- if show_source and has_source and sourcename %}
+{%- if show_source and page_source_suffix is defined %}
   <script>
     document.addEventListener('DOMContentLoaded', () => {
         const title = document.querySelector('meta[property="og:title"]').content;

From 06321b863737bc4c69ebcd70e2b25f0ef4e3c8dd Mon Sep 17 00:00:00 2001
From: Maciej Olko <maciej.olko@affirm.com>
Date: Mon, 14 Sep 2026 21:23:26 +0200
Subject: [PATCH 2/4] Fix sources links

Hide translation links on dev version.
---
 Doc/conf.py                               | 6 +++---
 Doc/tools/templates/customsourcelink.html | 6 +++---
 2 files changed, 6 insertions(+), 6 deletions(-)

diff --git a/Doc/conf.py b/Doc/conf.py
index 053c14b708f750..d2f35e8b699d1a 100644
--- a/Doc/conf.py
+++ b/Doc/conf.py
@@ -77,6 +77,8 @@
 # and replace the values accordingly.
 # See Doc/tools/extensions/patchlevel.py
 version, release = get_version_info()
+v = get_header_version_info()
+branch = "main" if v.releaselevel == "alpha" else f"{v.major}.{v.minor}"
 
 rst_epilog = f"""
 .. |python_version_literal| replace:: ``Python {version}``
@@ -297,6 +299,7 @@
     "repository_url": repository_url or None,
     "pr_id": os.getenv("READTHEDOCS_VERSION"),
     "enable_analytics": os.getenv("PYTHON_DOCS_ENABLE_ANALYTICS"),
+    "source_branch": branch,
 }
 
 # This 'Last updated on:' timestamp is inserted at the bottom of every page.
@@ -560,9 +563,6 @@
 # Options for sphinx.ext.extlinks
 # -------------------------------
 
-v = get_header_version_info()
-branch = "main" if v.releaselevel == "alpha" else f"{v.major}.{v.minor}"
-
 # This config is a dictionary of external sites,
 # mapping unique short aliases to a base URL and a prefix.
 # https://www.sphinx-doc.org/en/master/usage/extensions/extlinks.html
diff --git a/Doc/tools/templates/customsourcelink.html b/Doc/tools/templates/customsourcelink.html
index c44b8774a0831b..9bfd502553a7c3 100644
--- a/Doc/tools/templates/customsourcelink.html
+++ b/Doc/tools/templates/customsourcelink.html
@@ -19,13 +19,13 @@ <h3>{{ _('This page') }}</h3>
       <li><a href="{{ pathto('bugs') }}">{% trans %}Report a bug{% endtrans %}</a></li>
       <li><a class="improvepage" href="{{ pathto('improve-page-nojs') }}">{% trans %}Improve this page{% endtrans %}</a></li>
       <li>
-        <a href="https://github.com/python/cpython/blob/main/Doc/{{ pagename }}.rst?plain=1"
+        <a href="https://github.com/python/cpython/blob/{{ source_branch }}/Doc/{{ pagename }}.rst?plain=1"
             rel="nofollow">{{ _('Show source') }}
         </a>
       </li>
-      {% if language != "en" %}
+      {% if language != "en" and source_branch != "main" %}
       <li>
-        <a href="https://github.com/python/python-docs-{{ language }}/blob/{{ version }}/{{ pagename }}.po?plain=1"
+        <a href="https://github.com/python/python-docs-{{ language | replace('_', '-') | lower }}/blob/{{ source_branch }}/{{ pagename }}.po?plain=1"
            rel="nofollow">{{ _('Show translation source') }}</a>
       </li>
       {% endif %}

From 5c343932427fcd9e7b7ee2dd5a265a0ece21290d Mon Sep 17 00:00:00 2001
From: Maciej Olko <maciej.olko@affirm.com>
Date: Mon, 14 Sep 2026 22:31:51 +0200
Subject: [PATCH 3/4] Update Doc/conf.py: comment wording

Co-authored-by: Stan Ulbrych <stan@python.org>
---
 Doc/conf.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Doc/conf.py b/Doc/conf.py
index ca72148666660f..084906ac17cf94 100644
--- a/Doc/conf.py
+++ b/Doc/conf.py
@@ -310,7 +310,7 @@
 # Path to find HTML templates to override theme
 templates_path = ['tools/templates']
 
-# Link to sources on GitHub instead of copying them into the HTML output.
+# We link to sources on GitHub, so don't copy them into the HTML output.
 html_copy_source = False
 
 # Custom sidebar templates, filenames relative to this file.

From 3d5218137203f95b4a200fcb6e8ffc709d340edd Mon Sep 17 00:00:00 2001
From: Maciej Olko <maciej.olko@affirm.com>
Date: Tue, 15 Sep 2026 09:29:06 +0200
Subject: [PATCH 4/4] Show documentation page actions when source exists

Simplification, there's no need to rely on html_show_sourcelink Sphinx configuration
---
 Doc/tools/templates/customsourcelink.html | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/Doc/tools/templates/customsourcelink.html b/Doc/tools/templates/customsourcelink.html
index 9bfd502553a7c3..eb194aa038c1be 100644
--- a/Doc/tools/templates/customsourcelink.html
+++ b/Doc/tools/templates/customsourcelink.html
@@ -1,4 +1,4 @@
-{%- if show_source and page_source_suffix is defined %}
+{%- if page_source_suffix is defined %}
   <script>
     document.addEventListener('DOMContentLoaded', () => {
         const title = document.querySelector('meta[property="og:title"]').content;