From fa00f66bd677957cb09d8d1e9b4ae3311b9eacf6 Mon Sep 17 00:00:00 2001
From: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
Date: Sun, 2 Feb 2025 16:12:01 +0000
Subject: [PATCH] gh-126609: Allow translating the ``availability`` directive
 (GH-129549) (cherry picked from commit
 0612a89ffcf0bb52b1750a3466671ba8daad1d87)

Co-authored-by: Adam Turner <9087854+AA-Turner@users.noreply.github.com>
---
 Doc/tools/extensions/availability.py | 3 ++-
 Doc/tools/templates/dummy.html       | 4 ++++
 2 files changed, 6 insertions(+), 1 deletion(-)

diff --git a/Doc/tools/extensions/availability.py b/Doc/tools/extensions/availability.py
index 897af70a9f4b40..225b3438b943f3 100644
--- a/Doc/tools/extensions/availability.py
+++ b/Doc/tools/extensions/availability.py
@@ -6,6 +6,7 @@
 
 from docutils import nodes
 from sphinx import addnodes
+from sphinx.locale import _ as sphinx_gettext
 from sphinx.util import logging
 from sphinx.util.docutils import SphinxDirective
 
@@ -53,7 +54,7 @@ class Availability(SphinxDirective):
     final_argument_whitespace = True
 
     def run(self) -> list[nodes.container]:
-        title = "Availability"
+        title = sphinx_gettext("Availability")
         refnode = addnodes.pending_xref(
             title,
             nodes.inline(title, title, classes=["xref", "std", "std-ref"]),
diff --git a/Doc/tools/templates/dummy.html b/Doc/tools/templates/dummy.html
index 49c2a71a5e40cf..4f0f6f91436a87 100644
--- a/Doc/tools/templates/dummy.html
+++ b/Doc/tools/templates/dummy.html
@@ -7,6 +7,10 @@
 {% trans %}Deprecated since version {deprecated}, will be removed in version {removed}{% endtrans %}
 {% trans %}Deprecated since version {deprecated}, removed in version {removed}{% endtrans %}
 
+In extensions/availability.py:
+
+{% trans %}Availability{% endtrans %}
+
 In extensions/c_annotations.py:
 
 {% trans %}Part of the{% endtrans %}