From 064d013efb0c22462990082f9500e091114032d3 Mon Sep 17 00:00:00 2001
From: Pingu Carsti <ehbrecht@dkrz.de>
Date: Fri, 12 Apr 2024 14:47:20 +0200
Subject: [PATCH] update docs

---
 docs/source/conf.py | 54 ++++++++++++++++++++++++++++++++++-----------
 1 file changed, 41 insertions(+), 13 deletions(-)

diff --git a/docs/source/conf.py b/docs/source/conf.py
index 1f36816..e866f47 100755
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -41,7 +41,7 @@
     "sphinx.ext.todo",
     "sphinx.ext.viewcode",
     "IPython.sphinxext.ipython_console_highlighting",
-    "nbsphinx",
+    # "nbsphinx",
     "pywps.ext_autodoc",
 ]
 
@@ -49,23 +49,51 @@
 # List of all tested working mock imports from all birds so new birds can
 # inherit without having to test which work which do not.
 autodoc_mock_imports = [
-    "numpy", "xarray", "fiona", "rasterio", "shapely",
-    "osgeo", "geopandas", "pandas", "statsmodels",
-    "affine", "rasterstats", "spotpy", "matplotlib",
-    "scipy", "unidecode", "gdal", "sentry_sdk", "dask",
-    "numba", "parse", "siphon", "sklearn", "cftime",
-    "netCDF4", "bottleneck", "ocgis", "geotiff", "geos",
-    "hdf4", "hdf5", "zlib", "pyproj", "proj", "cartopy",
-    "scikit-learn", "cairo"
+    "numpy",
+    "xarray",
+    "fiona",
+    "rasterio",
+    "shapely",
+    "osgeo",
+    "geopandas",
+    "pandas",
+    "statsmodels",
+    "affine",
+    "rasterstats",
+    "spotpy",
+    "matplotlib",
+    "scipy",
+    "unidecode",
+    "gdal",
+    "sentry_sdk",
+    "dask",
+    "numba",
+    "parse",
+    "siphon",
+    "sklearn",
+    "cftime",
+    "netCDF4",
+    "bottleneck",
+    "ocgis",
+    "geotiff",
+    "geos",
+    "hdf4",
+    "hdf5",
+    "zlib",
+    "pyproj",
+    "proj",
+    "cartopy",
+    "scikit-learn",
+    "cairo",
 ]
 
 # Monkeypatch constant because the following are mock imports.
 # Only works if numpy is actually installed and at the same time being mocked.
-#import numpy
-#numpy.pi = 3.1416
+# import numpy
+# numpy.pi = 3.1416
 
 # We are using mock imports in readthedocs, so probably safer to not run the notebooks
-nbsphinx_execute = 'never'
+nbsphinx_execute = "never"
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ["_templates"]
@@ -112,7 +140,7 @@
 todo_include_todos = False
 
 # Suppress "WARNING: unknown mimetype for ..." when building EPUB.
-suppress_warnings = ['epub.unknown_project_files']
+suppress_warnings = ["epub.unknown_project_files"]
 
 # Avoid "configuration.rst:4:duplicate label configuration, other instance in configuration.rst"
 autosectionlabel_prefix_document = True