[3.12] gh-126609: Allow translating the availability directive (GH-129549) (#129585)

gh-126609: Allow translating the ``availability`` directive (GH-129549)
(cherry picked from commit 0612a89)

Co-authored-by: Adam Turner <[email protected]>

Author: miss-islington

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"]),

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 %}