Sphinx gallery

.gitignore

@@ -108,3 +108,9 @@ info/
 
 # Cython generated C code
 *.c
+
+
+docs/source/examples/
+
+
+*.DS_Store

docs/requirements.txt

@@ -2,4 +2,7 @@
 cython>=0.28.3
 numpydoc
 # https://stackoverflow.com/a/11704396/6696397
--r ../requirements.txt
+-r ../requirements.txt
+sphinx-gallery
+matplotlib
+pykrige

docs/source/conf.py

@@ -59,6 +59,7 @@ def setup(app):
     "sphinx.ext.autosummary",
     "sphinx.ext.napoleon",  # parameters look better than with numpydoc only
     "numpydoc",
+    'sphinx_gallery.gen_gallery',
 ]
 
 # autosummaries from source-files
@@ -247,3 +248,47 @@ def setup(app):
     "hankel": ("https://hankel.readthedocs.io/en/latest/", None),
     "emcee": ("https://emcee.readthedocs.io/en/latest/", None),
 }
+
+
+
+# -- Sphinx Gallery Options
+from sphinx_gallery.sorting import FileNameSortKey
+
+sphinx_gallery_conf = {
+    # path to your examples scripts
+    "examples_dirs": [
+        "../../examples/00_intro/",
+        "../../examples/01_random_field/",
+        "../../examples/02_cov_model/",
+        "../../examples/03_variogram/",
+        "../../examples/04_vector_field/",
+        "../../examples/05_kriging/",
+        "../../examples/06_conditioned_fields/",
+        "../../examples/07_transformations/",
+    ],
+    # path where to save gallery generated examples
+    "gallery_dirs": [
+        "examples/00_intro/",
+        "examples/01_random_field/",
+        "examples/02_cov_model/",
+        "examples/03_variogram/",
+        "examples/04_vector_field/",
+        "examples/05_kriging/",
+        "examples/06_conditioned_fields/",
+        "examples/07_transformations/",
+    ],
+    # Patter to search for example files
+    "filename_pattern": r"\.py",
+    # Remove the "Download all examples" button from the top level gallery
+    "download_all_examples": False,
+    # Sort gallery example by file name instead of number of lines (default)
+    "within_subsection_order": FileNameSortKey,
+    # directory where function granular galleries are stored
+    "backreferences_dir": None,
+    # Modules for which function level galleries are created.  In
+    "doc_module": "gstools",
+    #"image_scrapers": ('pyvista', 'matplotlib'),
+    # 'first_notebook_cell': ("%matplotlib inline\n"
+    #                         "from pyvista import set_plot_theme\n"
+    #                         "set_plot_theme('document')"),
+}