build: fix missing nbsphinx configuration [ci skip]

Author: martibosch

docs/conf.py

@@ -12,7 +12,12 @@
 version = ".".join(release.split(".")[:2])
 
 
-extensions = ["sphinx.ext.autodoc", "sphinx.ext.napoleon", "myst_parser"]
+extensions = [
+    "myst_parser",
+    "nbsphinx",
+    "sphinx.ext.autodoc",
+    "sphinx.ext.napoleon",
+]
 
 autodoc_typehints = "description"
 html_theme = "pydata_sphinx_theme"
@@ -22,3 +27,6 @@
 
 # add module to path
 sys.path.insert(0, os.path.abspath(".."))
+
+# do NOT execute notebooks
+nbsphinx_execute = "never"

docs/environment.yml

@@ -5,8 +5,10 @@ dependencies:
   - python=3.13
   - gdal=3.10.2
   - myst-parser=4.0.1
-  - sphinx=8.2.3
+  - nbsphinx=0.9.7
+  - pandoc=3.6.4
   - pdal=2.8.4
   - pip=25.0.1
   - pydata-sphinx-theme=0.16.1
   - setuptools=75.8.2
+  - sphinx=8.2.3