mkdocs2confluence 0.7.9__tar.gz → 0.7.10__tar.gz

{mkdocs2confluence-0.7.9/src/mkdocs2confluence.egg-info → mkdocs2confluence-0.7.10}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocs2confluence
-Version: 0.7.9
+Version: 0.7.10
 Summary: Publish MkDocs Material pages to Confluence Cloud — admonitions, Mermaid diagrams, tabs, page properties and more
 Author: Anders Hybertz
 License: GPL-3.0-or-later
@@ -355,7 +355,7 @@ If `repo_url` + `edit_uri` are set in `mkdocs.yml`, an **Edit Source** row links
 
 ### Abbreviation expansion
 
-MkDocs abbreviation definitions (`*[ABBR]: Full term`) are expanded inline — Confluence has no native `<abbr>` tooltip. The **first occurrence** in body text is expanded as `IAM (Identity and Access Management)`; subsequent occurrences are left as-is. Abbreviations that only appear in headings or code are collected into an auto-appended **Glossary** section.
+MkDocs abbreviation definitions (`*[ABBR]: Full term`) are rendered as inline Confluence **footnotes**. The **first occurrence** of each abbreviation in body text is annotated with a footnote macro — Confluence renders it as a superscript number and collects all definitions at the bottom of the page. Subsequent occurrences are left as plain text. Abbreviations that only appear in headings or other non-expandable contexts are collected into an auto-appended **Glossary** section as a fallback.
 
 ---
 
@@ -364,7 +364,7 @@ MkDocs abbreviation definitions (`*[ABBR]: Full term`) are expanded inline — C
 | Feature | Behaviour |
 |---|---|
 | **Admonition styling** | `tip`, `info`, `warning`, `note` use Confluence's fixed native macro colours. `danger`, `error`, `bug` use a custom red `panel` macro with 🚨 prefix. All other types are mapped to the nearest native macro. |
-| **Abbreviation tooltips** | No native tooltip support. First occurrence expanded inline; remainder left as-is. |
+| **Abbreviation tooltips** | No native tooltip support. First occurrence annotated with an inline Confluence footnote; definition collected at the bottom of the page. |
 | **Page ordering** | Confluence sorts child pages alphabetically; the v2 REST API has no write endpoint for ordering. |
 | **Code language aliases** | Short aliases (`py`, `js`, `yml`, `ts`, `sh`) are passed through as-is; Confluence requires full language names for syntax highlighting. |
 | **Unrecognised blocks** | Preserved as a visible `warning` macro — no content is silently lost. |

{mkdocs2confluence-0.7.9 → mkdocs2confluence-0.7.10}/README.md

@@ -315,7 +315,7 @@ If `repo_url` + `edit_uri` are set in `mkdocs.yml`, an **Edit Source** row links
 
 ### Abbreviation expansion
 
-MkDocs abbreviation definitions (`*[ABBR]: Full term`) are expanded inline — Confluence has no native `<abbr>` tooltip. The **first occurrence** in body text is expanded as `IAM (Identity and Access Management)`; subsequent occurrences are left as-is. Abbreviations that only appear in headings or code are collected into an auto-appended **Glossary** section.
+MkDocs abbreviation definitions (`*[ABBR]: Full term`) are rendered as inline Confluence **footnotes**. The **first occurrence** of each abbreviation in body text is annotated with a footnote macro — Confluence renders it as a superscript number and collects all definitions at the bottom of the page. Subsequent occurrences are left as plain text. Abbreviations that only appear in headings or other non-expandable contexts are collected into an auto-appended **Glossary** section as a fallback.
 
 ---
 
@@ -324,7 +324,7 @@ MkDocs abbreviation definitions (`*[ABBR]: Full term`) are expanded inline — C
 | Feature | Behaviour |
 |---|---|
 | **Admonition styling** | `tip`, `info`, `warning`, `note` use Confluence's fixed native macro colours. `danger`, `error`, `bug` use a custom red `panel` macro with 🚨 prefix. All other types are mapped to the nearest native macro. |
-| **Abbreviation tooltips** | No native tooltip support. First occurrence expanded inline; remainder left as-is. |
+| **Abbreviation tooltips** | No native tooltip support. First occurrence annotated with an inline Confluence footnote; definition collected at the bottom of the page. |
 | **Page ordering** | Confluence sorts child pages alphabetically; the v2 REST API has no write endpoint for ordering. |
 | **Code language aliases** | Short aliases (`py`, `js`, `yml`, `ts`, `sh`) are passed through as-is; Confluence requires full language names for syntax highlighting. |
 | **Unrecognised blocks** | Preserved as a visible `warning` macro — no content is silently lost. |

{mkdocs2confluence-0.7.9 → mkdocs2confluence-0.7.10}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "mkdocs2confluence"
-version = "0.7.9"
+version = "0.7.10"
 description = "Publish MkDocs Material pages to Confluence Cloud — admonitions, Mermaid diagrams, tabs, page properties and more"
 readme = "README.md"
 license = { text = "GPL-3.0-or-later" }

{mkdocs2confluence-0.7.9 → mkdocs2confluence-0.7.10/src/mkdocs2confluence.egg-info}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: mkdocs2confluence
-Version: 0.7.9
+Version: 0.7.10
 Summary: Publish MkDocs Material pages to Confluence Cloud — admonitions, Mermaid diagrams, tabs, page properties and more
 Author: Anders Hybertz
 License: GPL-3.0-or-later
@@ -355,7 +355,7 @@ If `repo_url` + `edit_uri` are set in `mkdocs.yml`, an **Edit Source** row links
 
 ### Abbreviation expansion
 
-MkDocs abbreviation definitions (`*[ABBR]: Full term`) are expanded inline — Confluence has no native `<abbr>` tooltip. The **first occurrence** in body text is expanded as `IAM (Identity and Access Management)`; subsequent occurrences are left as-is. Abbreviations that only appear in headings or code are collected into an auto-appended **Glossary** section.
+MkDocs abbreviation definitions (`*[ABBR]: Full term`) are rendered as inline Confluence **footnotes**. The **first occurrence** of each abbreviation in body text is annotated with a footnote macro — Confluence renders it as a superscript number and collects all definitions at the bottom of the page. Subsequent occurrences are left as plain text. Abbreviations that only appear in headings or other non-expandable contexts are collected into an auto-appended **Glossary** section as a fallback.
 
 ---
 
@@ -364,7 +364,7 @@ MkDocs abbreviation definitions (`*[ABBR]: Full term`) are expanded inline — C
 | Feature | Behaviour |
 |---|---|
 | **Admonition styling** | `tip`, `info`, `warning`, `note` use Confluence's fixed native macro colours. `danger`, `error`, `bug` use a custom red `panel` macro with 🚨 prefix. All other types are mapped to the nearest native macro. |
-| **Abbreviation tooltips** | No native tooltip support. First occurrence expanded inline; remainder left as-is. |
+| **Abbreviation tooltips** | No native tooltip support. First occurrence annotated with an inline Confluence footnote; definition collected at the bottom of the page. |
 | **Page ordering** | Confluence sorts child pages alphabetically; the v2 REST API has no write endpoint for ordering. |
 | **Code language aliases** | Short aliases (`py`, `js`, `yml`, `ts`, `sh`) are passed through as-is; Confluence requires full language names for syntax highlighting. |
 | **Unrecognised blocks** | Preserved as a visible `warning` macro — no content is silently lost. |

{mkdocs2confluence-0.7.9 → mkdocs2confluence-0.7.10}/src/mkdocs_to_confluence/emitter/xhtml.py

@@ -22,6 +22,7 @@ from typing import Sequence
 from urllib.parse import urlparse
 
 from mkdocs_to_confluence.ir.nodes import (
+    AbbrevFootnoteNode,
     Admonition,
     BlockQuote,
     BoldNode,
@@ -555,6 +556,18 @@ def _emit_footnote_ref(node: FootnoteRef) -> str:
     )
 
 
+def _emit_abbrev_footnote(node: AbbrevFootnoteNode) -> str:
+    """Abbreviation term + inline Confluence footnote macro with its definition."""
+    term = html.escape(node.abbr)
+    defn = html.escape(node.definition)
+    return (
+        f"{term}"
+        f'<ac:structured-macro ac:name="footnote" ac:schema-version="1">'
+        f"<ac:rich-text-body><p>{defn}</p></ac:rich-text-body>"
+        f"</ac:structured-macro>"
+    )
+
+
 def _emit_footnote_block(node: FootnoteBlock) -> str:
     """Footnotes section: heading + ordered list with anchor targets."""
     items: list[str] = []
@@ -613,6 +626,8 @@ def _emit_inline(node: IRNode) -> str:
         return _emit_image(node)
     if isinstance(node, FootnoteRef):
         return _emit_footnote_ref(node)
+    if isinstance(node, AbbrevFootnoteNode):
+        return _emit_abbrev_footnote(node)
     if isinstance(node, LineBreakNode):
         return "<br />"
     if isinstance(node, InlineHtmlNode):

{mkdocs2confluence-0.7.9 → mkdocs2confluence-0.7.10}/src/mkdocs_to_confluence/ir/nodes.py

@@ -428,6 +428,22 @@ class FrontMatter(IRNode):
     site_url: str | None = None
 
 
+# ── Abbreviation footnotes ────────────────────────────────────────────────────
+
+
+@dataclass(frozen=True)
+class AbbrevFootnoteNode(IRNode):
+    """An abbreviation annotated with an inline Confluence footnote.
+
+    The emitter outputs the abbreviated term immediately followed by a
+    ``footnote`` macro containing the full definition.  Confluence collects
+    all footnote macros and renders their bodies at the bottom of the page.
+    """
+
+    abbr: str
+    definition: str
+
+
 # ── Footnotes ────────────────────────────────────────────────────────────────
 
 

{mkdocs2confluence-0.7.9 → mkdocs2confluence-0.7.10}/src/mkdocs_to_confluence/transforms/abbrevs.py

@@ -3,17 +3,19 @@
 Collects ``*[ABBR]: definition`` pairs (extracted by
 :mod:`mkdocs_to_confluence.preprocess.abbrevs`) and walks the IR tree to:
 
-1. **Expand** the first occurrence of each abbreviation in *safe* body nodes —
-   paragraphs, list items, table body cells, blockquotes — by rewriting it to
-   ``ABBR (definition)``.
+1. **Annotate** the first occurrence of each abbreviation in *safe* body nodes —
+   paragraphs, list items, table body cells, blockquotes — by inserting an
+   inline Confluence ``footnote`` macro immediately after the term.  Confluence
+   renders this as a superscript number and collects all definitions at the
+   bottom of the page.
 
 2. **Skip** structural/title nodes where expansion would look odd:
    section headings, table header cells, admonition/panel titles, code spans,
    and link text.
 
 3. **Append a Glossary section** at the end of the page for any abbreviation
-   that was detected in the page text but could not be expanded inline because
-   it only appeared in skipped contexts.
+   that was detected in the page text but could not be footnoted because it
+   only appeared in skipped contexts (headings, table headers, etc.).
 
 Entry point
 -----------
@@ -27,6 +29,7 @@ import re
 from dataclasses import replace
 
 from mkdocs_to_confluence.ir.nodes import (
+    AbbrevFootnoteNode,
     Admonition,
     BlockQuote,
     BoldNode,
@@ -64,21 +67,31 @@ class _State:
             for abbr in abbrevs
         }
 
-    def expand_text(self, text: str) -> str:
-        """Return *text* with first-occurrence abbreviations expanded.
+    def expand_to_nodes(self, text: str) -> tuple[IRNode, ...]:
+        """Split *text* around the first unexpanded abbreviation.
 
-        Each abbreviation is expanded at most once across the entire page.
-        Once an abbreviation has been expanded, subsequent occurrences are left
-        as plain text.
+        Returns a mix of :class:`TextNode` and :class:`AbbrevFootnoteNode`.
+        Each abbreviation is footnoted at most once per page.
         """
-        for abbr, defn in self.abbrevs.items():
+        best: tuple[int, int, str] | None = None
+        for abbr in self.abbrevs:
             if abbr in self.expanded:
                 continue
-            pattern = self._patterns[abbr]
-            if pattern.search(text):
-                text = pattern.sub(f"{abbr} ({defn})", text, count=1)
-                self.expanded.add(abbr)
-        return text
+            m = self._patterns[abbr].search(text)
+            if m and (best is None or m.start() < best[0]):
+                best = (m.start(), m.end(), abbr)
+
+        if best is None:
+            return (TextNode(text),) if text else ()
+
+        start, end, abbr = best
+        self.expanded.add(abbr)
+        nodes: list[IRNode] = []
+        if text[:start]:
+            nodes.append(TextNode(text[:start]))
+        nodes.append(AbbrevFootnoteNode(abbr=abbr, definition=self.abbrevs[abbr]))
+        nodes.extend(self.expand_to_nodes(text[end:]))
+        return tuple(nodes)
 
 
 # ── Block-level transform ─────────────────────────────────────────────────────
@@ -151,22 +164,25 @@ def _transform_table_cell(cell: TableCell, state: _State) -> TableCell:
 
 
 def _inline(nodes: tuple[IRNode, ...], state: _State, safe: bool) -> tuple[IRNode, ...]:
-    return tuple(_transform_inline(n, state, safe) for n in nodes)
+    result: list[IRNode] = []
+    for n in nodes:
+        result.extend(_transform_inline(n, state, safe))
+    return tuple(result)
 
 
-def _transform_inline(node: IRNode, state: _State, safe: bool) -> IRNode:
+def _transform_inline(node: IRNode, state: _State, safe: bool) -> tuple[IRNode, ...]:
     if isinstance(node, TextNode):
-        return TextNode(state.expand_text(node.text)) if safe else node
+        return state.expand_to_nodes(node.text) if safe else (node,)
 
     if isinstance(node, (BoldNode, ItalicNode, StrikethroughNode)):
-        return replace(node, children=_inline(node.children, state, safe))
+        return (replace(node, children=_inline(node.children, state, safe)),)
 
     if isinstance(node, LinkNode):
         # Expanding inside link text could break the anchor label — skip.
-        return replace(node, children=_inline(node.children, state, safe=False))
+        return (replace(node, children=_inline(node.children, state, safe=False)),)
 
     # CodeInlineNode, ImageNode — never expand.
-    return node
+    return (node,)
 
 
 # ── Glossary builder ──────────────────────────────────────────────────────────
@@ -182,7 +198,7 @@ def _find_mentioned(text: str, abbrevs: dict[str, str]) -> set[str]:
 
 
 def _build_glossary_section(terms: dict[str, str]) -> tuple[IRNode, ...]:
-    """Return an HR + h6 ``Section`` listing abbreviations that could not be expanded inline."""
+    """Return an HR + h6 ``Section`` listing abbreviations that could not be footnoted."""
     items = tuple(
         ListItem(children=(Paragraph(children=(TextNode(f"{abbr} — {defn}"),)),))
         for abbr, defn in sorted(terms.items())
@@ -217,9 +233,11 @@ def apply_abbreviations(
                     abbreviations need a glossary entry.
 
     Returns:
-        Modified node tuple.  A ``Glossary`` section is appended if any
-        abbreviation was detected in *page_text* but could not be expanded
-        inline (e.g. it only appeared in headings or table headers).
+        Modified node tuple.  Abbreviations in body text are replaced with an
+        :class:`~mkdocs_to_confluence.ir.nodes.AbbrevFootnoteNode` on first
+        occurrence.  A ``Glossary`` section is appended only for abbreviations
+        that were detected in *page_text* but never footnoted (e.g. they only
+        appeared in headings or table headers).
     """
     if not abbrevs:
         return nodes
@@ -228,12 +246,15 @@ def apply_abbreviations(
     transformed = tuple(_transform_block(n, state) for n in nodes)
 
     mentioned = _find_mentioned(page_text, abbrevs)
+    # Only add a glossary entry for abbreviations that were never footnoted.
     glossary_needed = {
         abbr: abbrevs[abbr]
         for abbr in mentioned
+        if abbr not in state.expanded
     }
 
     if glossary_needed:
         transformed = transformed + _build_glossary_section(glossary_needed)
 
     return transformed
+

{mkdocs2confluence-0.7.9 → mkdocs2confluence-0.7.10}/tests/test_abbrevs.py

@@ -3,6 +3,7 @@
 from __future__ import annotations
 
 from mkdocs_to_confluence.ir.nodes import (
+    AbbrevFootnoteNode,
     Admonition,
     BoldNode,
     BulletList,
@@ -81,26 +82,36 @@ def _para(text: str) -> Paragraph:
     return Paragraph(children=(TextNode(text),))
 
 
-def test_expands_first_occurrence_in_paragraph():
+def test_expands_first_occurrence_as_footnote():
     abbrevs = {"IAM": "Identity and Access Management"}
     nodes = (_para("The IAM platform handles IAM requests."),)
     result = apply_abbreviations(nodes, abbrevs, page_text="The IAM platform handles IAM requests.")
     para = result[0]
     assert isinstance(para, Paragraph)
-    text = para.children[0].text  # type: ignore[union-attr]
-    assert "IAM (Identity and Access Management)" in text
-    # Second occurrence not expanded
-    assert text.count("IAM (Identity and Access Management)") == 1
-    assert text.endswith("IAM requests.")
+    children = para.children
+    # Should be: TextNode("The ") + AbbrevFootnoteNode + TextNode(" platform handles IAM requests.")
+    assert len(children) == 3
+    assert isinstance(children[0], TextNode)
+    assert children[0].text == "The "
+    assert isinstance(children[1], AbbrevFootnoteNode)
+    assert children[1].abbr == "IAM"
+    assert children[1].definition == "Identity and Access Management"
+    # Second occurrence left as plain text
+    assert isinstance(children[2], TextNode)
+    assert "IAM requests." in children[2].text
+    assert "Identity and Access Management" not in children[2].text
 
 
 def test_expands_multiple_different_abbrevs():
     abbrevs = {"IAM": "Identity and Access Management", "RBAC": "Role-Based Access Control"}
     nodes = (_para("Use IAM and RBAC for access control."),)
     result = apply_abbreviations(nodes, abbrevs, page_text="Use IAM and RBAC for access control.")
-    text = result[0].children[0].text  # type: ignore[union-attr]
-    assert "IAM (Identity and Access Management)" in text
-    assert "RBAC (Role-Based Access Control)" in text
+    para = result[0]
+    assert isinstance(para, Paragraph)
+    footnotes = [c for c in para.children if isinstance(c, AbbrevFootnoteNode)]
+    abbrs = {fn.abbr for fn in footnotes}
+    assert "IAM" in abbrs
+    assert "RBAC" in abbrs
 
 
 def test_no_expand_when_no_abbrevs():
@@ -131,14 +142,13 @@ def test_glossary_appended_for_heading_only_abbrev():
         children=(),
     )
     result = apply_abbreviations((section,), abbrevs, page_text="IAM Platform")
-    # An HR separator and a Glossary section should be appended
+    # IAM only in heading (unsafe) → no footnote → glossary fallback appended
     assert len(result) == 3
     assert isinstance(result[1], HorizontalRule)
     glossary = result[2]
     assert isinstance(glossary, Section)
     assert glossary.anchor == "glossary"
     assert glossary.level == 6
-    # Glossary should list the term
     bullet_list = glossary.children[0]
     assert isinstance(bullet_list, BulletList)
     item_text = bullet_list.items[0].children[0].children[0].text  # type: ignore[union-attr]
@@ -146,16 +156,13 @@ def test_glossary_appended_for_heading_only_abbrev():
     assert "Identity and Access Management" in item_text
 
 
-def test_no_glossary_when_abbrev_expanded_inline():
+def test_no_glossary_when_abbrev_footnoted_inline():
     abbrevs = {"IAM": "Identity and Access Management"}
     nodes = (_para("The IAM platform."),)
     result = apply_abbreviations(nodes, abbrevs, page_text="The IAM platform.")
-    # Expanded inline, but also added to glossary for bottom-of-page reference
-    assert len(result) == 3
-    assert isinstance(result[1], HorizontalRule)
-    glossary = result[-1]
-    assert isinstance(glossary, Section)
-    assert glossary.anchor == "glossary"
+    # Footnoted inline → no glossary needed
+    assert len(result) == 1
+    assert isinstance(result[0], Paragraph)
 
 
 def test_no_expand_in_table_header_cell():
@@ -173,9 +180,9 @@ def test_no_expand_in_table_header_cell():
     header_text = result[0].header.cells[0].children[0].text  # type: ignore[union-attr]
     assert header_text == "API Endpoint"
 
-    # Body cell: first occurrence expanded
-    body_text = result[0].rows[0].cells[0].children[0].text  # type: ignore[union-attr]
-    assert "API (Application Programming Interface)" in body_text
+    # Body cell: first occurrence footnoted
+    body_children = result[0].rows[0].cells[0].children  # type: ignore[union-attr]
+    assert any(isinstance(c, AbbrevFootnoteNode) and c.abbr == "API" for c in body_children)
 
 
 def test_no_expand_in_admonition_title():
@@ -188,9 +195,9 @@ def test_no_expand_in_admonition_title():
     result = apply_abbreviations((admonition,), abbrevs, page_text="TLS Configuration Use TLS for encryption.")
     # Title is str, unchanged
     assert result[0].title == "TLS Configuration"  # type: ignore[union-attr]
-    # Body paragraph: expanded
-    body_text = result[0].children[0].children[0].text  # type: ignore[union-attr]
-    assert "TLS (Transport Layer Security)" in body_text
+    # Body paragraph: TLS footnoted
+    body_children = result[0].children[0].children  # type: ignore[union-attr]
+    assert any(isinstance(c, AbbrevFootnoteNode) and c.abbr == "TLS" for c in body_children)
 
 
 def test_no_expand_in_code_block():
@@ -218,42 +225,37 @@ def test_expands_inside_bold():
     bold = BoldNode(children=(TextNode("CI pipeline"),))
     para = Paragraph(children=(bold,))
     result = apply_abbreviations((para,), abbrevs, page_text="CI pipeline")
-    bold_text = result[0].children[0].children[0].text  # type: ignore[union-attr]
-    assert "CI (Continuous Integration)" in bold_text
+    bold_children = result[0].children[0].children  # type: ignore[union-attr]
+    assert any(isinstance(c, AbbrevFootnoteNode) and c.abbr == "CI" for c in bold_children)
 
 
 def test_word_boundary_not_partial_match():
     abbrevs = {"API": "Application Programming Interface"}
     nodes = (_para("The RAPID response via API."),)
     result = apply_abbreviations(nodes, abbrevs, page_text="The RAPID response via API.")
-    text = result[0].children[0].text  # type: ignore[union-attr]
-    # RAPID should not be touched; API should be expanded
-    assert "RAPID" in text
-    assert "API (Application Programming Interface)" in text
+    para = result[0]
+    assert isinstance(para, Paragraph)
+    # RAPID should be untouched; API should be footnoted
+    all_text = "".join(c.text for c in para.children if isinstance(c, TextNode))
+    assert "RAPID" in all_text
+    footnotes = [c for c in para.children if isinstance(c, AbbrevFootnoteNode)]
+    assert any(fn.abbr == "API" for fn in footnotes)
 
 
-def test_glossary_includes_inline_expanded_abbrevs():
-    # Abbreviations expanded inline should ALSO appear in the glossary,
-    # so readers who jump directly to the bottom have a full reference.
+def test_footnoted_abbrevs_not_in_glossary():
+    # Abbreviations expanded inline via footnote should NOT also appear in a glossary.
     abbrevs = {"API": "Application Programming Interface", "IAM": "Identity and Access Management"}
     nodes = (_para("Use the API and IAM to authenticate."),)
     result = apply_abbreviations(
         nodes, abbrevs,
         page_text="Use the API and IAM to authenticate."
     )
-    # Both should be expanded inline...
-    body_text = result[0].children[0].text  # type: ignore[union-attr]
-    assert "API (Application Programming Interface)" in body_text
-    assert "IAM (Identity and Access Management)" in body_text
-    # ...AND both should appear in the glossary at the bottom.
-    assert len(result) == 3
-    assert isinstance(result[1], HorizontalRule)
-    glossary = result[-1]
-    assert isinstance(glossary, Section)
-    items = glossary.children[0].items  # type: ignore[union-attr]
-    labels = " ".join(item.children[0].children[0].text for item in items)  # type: ignore[union-attr]
-    assert "API" in labels
-    assert "IAM" in labels
+    # Both footnoted inline → no glossary
+    assert len(result) == 1
+    para = result[0]
+    assert isinstance(para, Paragraph)
+    footnotes = [c for c in para.children if isinstance(c, AbbrevFootnoteNode)]
+    assert {fn.abbr for fn in footnotes} == {"API", "IAM"}
 
 
 def test_abbrev_not_in_text_produces_no_glossary():
@@ -281,3 +283,4 @@ def test_glossary_entries_sorted_alphabetically():
     items = glossary.children[0].items  # type: ignore[union-attr]
     labels = [item.children[0].children[0].text for item in items]  # type: ignore[union-attr]
     assert labels == sorted(labels)
+