docs: Add intersphinx linkage to dependencies

For any references that go back into those, they're not reachable for doc rendering without this. Use seed_intersphinx_mapping to derive those urls from pyproject.toml sources. Signed-off-by: Brian Harring <[email protected]>
pkgcore · Jan 26, 2024 · 6ba2aca · 6ba2aca
1 parent 2b66a5a
commit 6ba2aca
Show file tree

Hide file tree

Showing 2 changed files with 8 additions and 0 deletions.
diff --git a/doc/conf.py b/doc/conf.py
@@ -33,6 +33,7 @@
     "sphinx.ext.ifconfig",
     "sphinx.ext.viewcode",
     "snakeoil.dist.sphinxext",
+    "seed_intersphinx_mapping",
 ]
 
 # Add any paths that contain templates here, relative to this directory.
@@ -324,3 +325,9 @@
 
 # If false, no index is generated.
 # epub_use_index = True
+
+intersphinx_mapping = {
+    "python": ("https://docs.python.org/3", None),
+}
+
+pkg_requirements_source = 'pyproject'
diff --git a/pyproject.toml b/pyproject.toml
@@ -54,6 +54,7 @@ test = [
 ]
 doc = [
 	"sphinx",
+	"seed_intersphinx_mapping",
 	"tomli; python_version < '3.11'",
 	"snakeoil~=0.10.4",
 ]