Add sphinx-tippy (#1000)

Let's make it pretty 🙂.

There is also
[sphinx-hoverxref](https://github.com/readthedocs/sphinx-hoverxref), but
I forgot what the issue was with that and markdown support

Signed-off-by: Cristian Le <[email protected]>

Author: LecrisUT

docs/conf.py

@@ -67,6 +67,7 @@
     "sphinx_autodoc_typehints",
     "conftabs",
     "sphinx-jsonschema",
+    "sphinx_tippy",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -94,6 +95,12 @@
     "setuptools": ("https://setuptools.pypa.io/en/latest", None),
     "hatchling": ("https://hatch.pypa.io/latest", None),
 }
+tippy_rtd_urls = [
+    val[0]
+    for key, val in intersphinx_mapping.items()
+    # Only works with RTD hosted intersphinx
+    if key not in ("hatchling", "python")
+]
 
 nitpick_ignore = [
     ("py:class", "setuptools.dist.Distribution"),

pyproject.toml

@@ -97,6 +97,7 @@ docs = [
     "sphinx-copybutton",
     "sphinx-inline-tabs",
     "sphinx-jsonschema",
+    "sphinx-tippy",
 ]
 wheel-free-setuptools = [
     'setuptools>=70.1; python_version>="3.8"',