dirty fix to avoid attrs.pop("backrefs") # Crashes when backrefs doesn't exist!

selmanozleyen · selmanozleyen · commit e0cb6e12bb3d · 2026-01-21T18:06:22.000+01:00
diff --git a/docs/conf.py b/docs/conf.py
@@ -151,6 +151,7 @@
     ("py:class", "squidpy._constants._constants.SpatialAutocorr"),
     ("py:class", "squidpy._constants._constants.CoordType"),
     ("py:class", "squidpy._constants._constants.Transform"),
+    ("py:class", "pandas.core.frame.DataFrame"),
 ]
 # see the solution from: https://github.com/sphinx-doc/sphinx/issues/7369
 linkcheck_ignore = [
diff --git a/pyproject.toml b/pyproject.toml
@@ -101,6 +101,7 @@ optional-dependencies.docs = [
   "sphinx-tabs",
   "sphinxcontrib-bibtex>=2.3",
   "sphinxcontrib-spelling>=7.6.2",
+  "docutils<0.22",  # Pin to avoid sphinx-tabs KeyError with backrefs
 ]
 optional-dependencies.leiden = [
   "leidenalg",

Original file line number	Diff line number	Diff line change
`@@ -151,6 +151,7 @@`
`151`	`151`	`("py:class", "squidpy._constants._constants.SpatialAutocorr"),`
`152`	`152`	`("py:class", "squidpy._constants._constants.CoordType"),`
`153`	`153`	`("py:class", "squidpy._constants._constants.Transform"),`
	`154`	`+ ("py:class", "pandas.core.frame.DataFrame"),`
`154`	`155`	`]`
`155`	`156`	`# see the solution from: https://github.com/sphinx-doc/sphinx/issues/7369`
`156`	`157`	`linkcheck_ignore = [`
Original file line number	Diff line number	Diff line change
`@@ -101,6 +101,7 @@ optional-dependencies.docs = [`
`101`	`101`	`"sphinx-tabs",`
`102`	`102`	`"sphinxcontrib-bibtex>=2.3",`
`103`	`103`	`"sphinxcontrib-spelling>=7.6.2",`
	`104`	`+ "docutils<0.22", # Pin to avoid sphinx-tabs KeyError with backrefs`
`104`	`105`	`]`
`105`	`106`	`optional-dependencies.leiden = [`
`106`	`107`	`"leidenalg",`