🧪 TEST: normalize translatable attrs, add issue extlink

- add 'translatable'/'translated' to the boolean-attribute
  normalization list, so regressions are stable across docutils
  0.22 (1/0) and earlier (True/False) serializations
- define an 'issue' extlink for changelog references

Author: claude

docs/conf.py

@@ -23,6 +23,10 @@
 
 extlinks = {
     "pr": ("https://github.com/executablebooks/sphinx-design/pull/%s", "PR #%s"),
+    "issue": (
+        "https://github.com/executablebooks/sphinx-design/issues/%s",
+        "#%s",
+    ),
     "user": ("https://github.com/%s", "@%s"),
 }
 

tests/conftest.py

@@ -122,6 +122,8 @@ def _normalize(text: str) -> str:
                 "refexplicit",
                 "refwarn",
                 "selected",
+                "translatable",
+                "translated",
             ]
             text = re.sub(rf' ({"|".join(attrs)})="1"', r' \1="True"', text)
             text = re.sub(rf' ({"|".join(attrs)})="0"', r' \1="False"', text)

tests/test_misc.py

@@ -345,8 +345,11 @@ def test_tab_set_with_paragraph_warns(sphinx_builder):
     builder.build(assert_pass=False)
     assert "All children of a 'tab-set' should be 'tab-item'" in builder.warnings
     assert "[design.tab]" in builder.warnings
+
+
 I18N_INDEX_RST = """\
 Heading
+=======
 
 .. _target-section:
 

tests/test_snippets/snippet_post_button-link.xml

@@ -2,27 +2,27 @@
     <section ids="heading" names="heading">
         <title>
             Heading
-        <paragraph translatable="0">
+        <paragraph translatable="False">
             <reference classes="sd-sphinx-override sd-btn sd-text-wrap" refuri="https://example.com">
                 <inline>
                     https://example.com
-        <paragraph translatable="0">
+        <paragraph translatable="False">
             <reference classes="sd-sphinx-override sd-btn sd-text-wrap" refuri="https://example.com">
                 <inline>
                     Button text
-        <paragraph translatable="0">
+        <paragraph translatable="False">
             <reference classes="sd-sphinx-override sd-btn sd-text-wrap sd-btn-primary" refuri="https://example.com">
                 <inline>
                     Button text with options
-        <paragraph translatable="0">
+        <paragraph translatable="False">
             <reference classes="sd-sphinx-override sd-btn sd-text-wrap sd-btn-primary sd-shadow-sm" refuri="https://example.com">
                 <inline>
                     https://example.com
-        <paragraph translatable="0">
+        <paragraph translatable="False">
             <reference classes="sd-sphinx-override sd-btn sd-text-wrap sd-btn-outline-primary" refuri="https://example.com">
                 <inline>
                     https://example.com
-        <paragraph translatable="0">
+        <paragraph translatable="False">
             <inline classes="sd-d-grid">
                 <reference classes="sd-sphinx-override sd-btn sd-text-wrap sd-btn-secondary" refuri="https://example.com">
                     <inline>

tests/test_snippets/snippet_pre_button-link.xml

@@ -2,27 +2,27 @@
     <section ids="heading" names="heading">
         <title>
             Heading
-        <paragraph translatable="0">
+        <paragraph translatable="False">
             <reference classes="sd-sphinx-override sd-btn sd-text-wrap" refuri="https://example.com">
                 <inline>
                     https://example.com
-        <paragraph translatable="0">
+        <paragraph translatable="False">
             <reference classes="sd-sphinx-override sd-btn sd-text-wrap" refuri="https://example.com">
                 <inline>
                     Button text
-        <paragraph translatable="0">
+        <paragraph translatable="False">
             <reference classes="sd-sphinx-override sd-btn sd-text-wrap sd-btn-primary" refuri="https://example.com">
                 <inline>
                     Button text with options
-        <paragraph translatable="0">
+        <paragraph translatable="False">
             <reference classes="sd-sphinx-override sd-btn sd-text-wrap sd-btn-primary sd-shadow-sm" refuri="https://example.com">
                 <inline>
                     https://example.com
-        <paragraph translatable="0">
+        <paragraph translatable="False">
             <reference classes="sd-sphinx-override sd-btn sd-text-wrap sd-btn-outline-primary" refuri="https://example.com">
                 <inline>
                     https://example.com
-        <paragraph translatable="0">
+        <paragraph translatable="False">
             <inline classes="sd-d-grid">
                 <reference classes="sd-sphinx-override sd-btn sd-text-wrap sd-btn-secondary" refuri="https://example.com">
                     <inline>