docs: strip citekey labels from references page with post-transform

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: anevolbap

docs/source/_extensions/strip_citation_labels.py

@@ -0,0 +1,21 @@
+"""Strip citation labels ([Aba21]) from bibliography entries."""
+
+import docutils.nodes
+from sphinx.transforms.post_transforms import SphinxPostTransform
+
+
+class StripCitationLabels(SphinxPostTransform):
+    default_priority = 6  # runs right after BibliographyTransform (priority 5)
+
+    def run(self):
+        for node in self.document.findall(docutils.nodes.citation):
+            for label in node.findall(docutils.nodes.label):
+                label.parent.remove(label)
+            for para in node.findall(docutils.nodes.paragraph):
+                para.insert(0, docutils.nodes.Text("\u2022 "))
+                break
+
+
+def setup(app):
+    app.add_post_transform(StripCitationLabels)
+    return {"version": "0.1", "parallel_read_safe": True, "parallel_write_safe": True}

docs/source/_static/custom.css

@@ -0,0 +1,5 @@
+/* Hanging indent for bibliography entries with bullet markers */
+.citation[role="doc-biblioentry"] p {
+    padding-left: 1em;
+    text-indent: -1em;
+}

docs/source/conf.py

@@ -15,6 +15,7 @@
 from causalpy.version import __version__
 
 sys.path.insert(0, os.path.abspath("../"))
+sys.path.insert(0, os.path.join(os.path.dirname(__file__), "_extensions"))
 
 # autodoc_mock_imports
 # This avoids autodoc breaking when it can't find packages imported in the code.
@@ -74,6 +75,7 @@
     "sphinx_design",
     "sphinx_sitemap",
     "sphinx_togglebutton",
+    "strip_citation_labels",
 ]
 
 nb_execution_mode = "off"
@@ -154,6 +156,7 @@
 
 html_theme = "labs_sphinx_theme"
 html_static_path = ["_static"]
+html_css_files = ["custom.css"]
 html_extra_path = ["robots.txt"]
 html_favicon = "_static/favicon_logo.png"
 # Theme options are theme-specific and customize the look and feel of a theme