Merge pull request #2589 from cta-observatory/fix_intersphinx_warning

Fix docs build

docs/conf.py

@@ -26,7 +26,7 @@
 import sys
 from pathlib import Path
 
-from sphinx_gallery.sorting import ExplicitOrder, FileNameSortKey
+from sphinx_gallery.sorting import ExplicitOrder
 
 import ctapipe
 
@@ -177,7 +177,7 @@ def setup(app):
             "../examples/visualization",
         ]
     ),
-    "within_subsection_order": FileNameSortKey,
+    "within_subsection_order": "FileNameSortKey",
     "nested_sections": False,
     "filename_pattern": r".*\.py",
     "copyfile_regex": r".*\.png",
@@ -205,7 +205,6 @@ def setup(app):
 # have all links automatically associated with the right domain.
 default_role = "py:obj"
 
-suppress_warnings = ["ref.citation"]  # ignore citation not referenced warnings
 
 # General information about the project.
 
@@ -414,8 +413,10 @@ def setup(app):
 }
 
 
-# workaround for sphinx-gallery-conf not being cacheable and warning resulting in docs failure
-suppress_warnings = ["config.cache"]
+# workaround for ipywidgets and sklearn having duplicate definitions in intersphinx
+suppress_warnings = [
+    "intersphinx.external",
+]
 
 bibtex_bibfiles = ["references.bib"]
 bibtex_encoding = "utf8"

pyproject.toml

@@ -68,7 +68,7 @@ docs = [
     "nbsphinx",
     "numpydoc",
     "sphinx-design",
-    "sphinx-gallery",
+    "sphinx-gallery >= 0.16.0",
     "sphinxcontrib-bibtex",
     "jupyter",
     "notebook",