pydata · jhamman · May 31, 2022 · Apr 27, 2022 · Apr 27, 2022 · Apr 30, 2022
diff --git a/ci/requirements/doc.yml b/ci/requirements/doc.yml
@@ -32,7 +32,7 @@ dependencies:
   - sphinx-autosummary-accessors
   - sphinx-book-theme >= 0.0.38
   - sphinx-copybutton
-  - sphinx-panels
+  - sphinx-design
   - sphinx!=4.4.0
   - zarr>=2.4
   - pip:

diff --git a/doc/_static/index_api.svg b/doc/_static/index_api.svg
diff --git a/doc/_static/index_contribute.svg b/doc/_static/index_contribute.svg
diff --git a/doc/_static/index_getting_started.svg b/doc/_static/index_getting_started.svg
diff --git a/doc/_static/index_user_guide.svg b/doc/_static/index_user_guide.svg
diff --git a/doc/_static/style.css b/doc/_static/style.css
@@ -261,3 +261,13 @@ body {
 .bd-toc .nav > .active > ul {
   display: block;
 }
+
+/* Main index page overview cards */
+
+.sd-card-img-top {
+  width: 33% !important;
+  display: block;
+  margin-left: auto;
+  margin-right: auto;
+  margin-top: 10px;
+}
diff --git a/doc/conf.py b/doc/conf.py
@@ -20,6 +20,7 @@
 from contextlib import suppress
 
 import sphinx_autosummary_accessors
+from sphinx.domains.python import PythonDomain
 
 import xarray
 
@@ -60,6 +61,8 @@
         ]
     )
 
+nbsphinx_allow_errors = True
+
 # -- General configuration ------------------------------------------------
 
 # If your documentation needs a minimal Sphinx version, state it here.
@@ -80,12 +83,13 @@
     "nbsphinx",
     "sphinx_autosummary_accessors",
     "sphinx.ext.linkcode",
-    "sphinx_panels",
     "sphinxext.opengraph",
     "sphinx_copybutton",
     "sphinxext.rediraffe",
+    "sphinx_design",
 ]
 
+
 extlinks = {
     "issue": ("https://github.com/pydata/xarray/issues/%s", "GH"),
     "pull": ("https://github.com/pydata/xarray/pull/%s", "PR"),
@@ -383,5 +387,21 @@ def html_page_context(app, pagename, templatename, context, doctree):
         context["theme_use_edit_page_button"] = False
 
 
+class PatchedPythonDomain(PythonDomain):
+    """
+    Workaround for `WARNING: more than one target found for 'any' cross-reference`
+
+    source: https://github.com/sphinx-doc/sphinx/issues/3866
+    """
+
+    def resolve_xref(self, env, fromdocname, builder, typ, target, node, contnode):
+        if "refspecific" in node:
+            del node["refspecific"]
+        return super().resolve_xref(
+            env, fromdocname, builder, typ, target, node, contnode
+        )
+
+
 def setup(app):
     app.connect("html-page-context", html_page_context)
+    app.add_domain(PatchedPythonDomain, override=True)