docs(conf): Tolerate offline intersphinx

tony · tony · commit b81336aba28e · 2025-12-06T07:03:20.000-06:00
why: avoid noisy intersphinx fetch warnings when inventories are unreachable.

what:
- add short timeout and suppress intersphinx warnings
diff --git a/docs/conf.py b/docs/conf.py
@@ -151,6 +151,10 @@
     "gp-libs": ("https://gp-libs.git-pull.com/", None),
 }
 
+# Keep network lookups fast and quiet when inventories are slow or unreachable.
+intersphinx_timeout = 1
+suppress_warnings = ["intersphinx", "intersphinx.inventory"]
+
 
 def linkcode_resolve(domain: str, info: dict[str, str]) -> None | str:
     """

Original file line number	Diff line number	Diff line change
`@@ -151,6 +151,10 @@`
`151`	`151`	`"gp-libs": ("https://gp-libs.git-pull.com/", None),`
`152`	`152`	`}`
`153`	`153`
	`154`	`+# Keep network lookups fast and quiet when inventories are slow or unreachable.`
	`155`	`+intersphinx_timeout = 1`
	`156`	`+suppress_warnings = ["intersphinx", "intersphinx.inventory"]`
	`157`	`+`
`154`	`158`
`155`	`159`	`def linkcode_resolve(domain: str, info: dict[str, str]) -> None \| str:`
`156`	`160`	`"""`