Remove dead notebook/gallery infrastructure from master (#693)

Author: waltsims

.github/workflows/generate-notebooks.yml

@@ -12,11 +12,7 @@ jobs:
       with:
         python-version: '3.10'
         cache: 'pip'
-    - name: Install pandoc
-      run: sudo apt-get update && sudo apt-get install -y pandoc
-    - name: Install dependencies and generate notebooks
-      run: |
-        pip install '.[docs]'
-        python docs/generate_example_notebooks.py
     - name: Build and Commit
       uses: waltsims/pages@pyproject.toml-support
+      with:
+        pyproject_toml_deps: ".[docs]"

.github/workflows/test_pages.yml

@@ -21,7 +21,6 @@ build/
 src/
 transfer_temp/
 docs/_build/
-docs/_examples/
 kwave/bin/
 
 # Package manager files

.gitignore

@@ -26,7 +26,6 @@
     "sphinx.ext.viewcode",
     "sphinx_mdinclude",
     "sphinx.ext.extlinks",  # Enables :ghfile: external links
-    "nbsphinx",
 ]
 
 # Provide a simple GitHub branch/sha fallback for linking to example files.
@@ -66,26 +65,6 @@ def _detect_current_branch() -> str:
     ),
 }
 
-# -- Options for nbsphinx ----------------------------------------------------
-# Do not execute notebooks during the Sphinx build; they are pre-rendered.
-nbsphinx_execute = "never"
-
-# Add an "Open in Colab" badge at the top of every notebook page.
-nbsphinx_prolog = r"""
-{% set docname = env.doc2path(env.docname, base=None) %}
-{% set nb_basename = docname.split('/')[-1].replace('.ipynb', '') %}
-
-.. raw:: html
-
-    <p>
-      <a href="https://colab.research.google.com/github/waltsims/k-wave-python/blob/master/notebooks/{{ nb_basename }}.ipynb">
-        <img alt="Open In Colab"
-             src="https://colab.research.google.com/assets/colab-badge.svg"
-             style="vertical-align:text-bottom">
-      </a>
-    </p>
-"""
-
 source_suffix = [".rst", ".md"]
 templates_path = ["_templates"]
 exclude_patterns = ["README.md", "_build", "Thumbs.db", ".DS_Store"]

Makefile

@@ -20,7 +20,6 @@ k-Wave is an open source acoustics toolbox for MATLAB and C++ developed by Bradl
    get_started/source_overview
    get_started/sensor_overview
    get_started/examples_guide
-   examples
 
 .. toctree::
    :caption: k-Wave-python API