[3.14] Standardize translation of `Doc/bugs.rst` (GH-137449) (#140275)

Standardize translation of `Doc/bugs.rst` (GH-137449)
(cherry picked from commit 869bb6948eb501b19db53cb27c523c3203a5ab11)

Co-authored-by: Stan Ulbrych <89152624+StanFromIreland@users.noreply.github.com>

diff --git a/Doc/bugs.rst b/Doc/bugs.rst
index 5d0f68ca69675e5a51abefa73e209e00cbbe0586..1d27579e53f4ef5b395b2b366df6a817f375677a 100644 (file)
--- a/Doc/bugs.rst
+++ b/Doc/bugs.rst
@@ -19,6 +19,12 @@ If you find a bug in this documentation or would like to propose an improvement,
 please submit a bug report on the :ref:`issue tracker <using-the-tracker>`.  If you
 have a suggestion on how to fix it, include that as well.
 
+.. only:: translation
+
+   If the bug or suggested improvement concerns the translation of this
+   documentation, submit the report to the
+   `translation’s repository <TRANSLATION_REPO_>`_ instead.
+
 You can also open a discussion item on our
 `Documentation Discourse forum <https://discuss.python.org/c/documentation/26>`_.
 

diff --git a/Doc/conf.py b/Doc/conf.py
index c1b07df08b1782ed2e002725fe8ec2cba2f7c798..a8e376c0ae44fe6dae8a802e6c3f05041ae80183 100644 (file)
--- a/Doc/conf.py
+++ b/Doc/conf.py
@@ -444,6 +444,25 @@ epub_exclude_files = ('index.xhtml', 'download.xhtml')
 # https://github.com/sphinx-doc/sphinx/issues/12359
 epub_use_index = False
 
+# translation tag
+# ---------------
+
+language_code = None
+for arg in sys.argv:
+    if arg.startswith('language='):
+        language_code = arg.split('=', 1)[1]
+
+if language_code:
+    tags.add('translation')  # noqa: F821
+
+    rst_epilog += f"""\
+.. _TRANSLATION_REPO: https://github.com/python/python-docs-{language_code.replace("_", "-").lower()}
+"""  # noqa: F821
+else:
+    rst_epilog += """\
+.. _TRANSLATION_REPO: https://github.com/python
+"""
+
 # Options for the coverage checker
 # --------------------------------