Add notebooks section on website (#1495)

* Initial infrasctructure for notebooks page

* migrate two notebooks

* add readme notification for notebook dir

* override 'text' prism language to add basic syntactical structure to autogens output

* Rework to retain existing directory and not expose front matter to consumers of the notebook

* improve error handling of process notebooks

* format, ruff and type fixes

* undo changes to navbar

* update readme, CI

* whitespace

* spelling mistakes

* spelling

* Add contributing guide for notebooks

* update notebook

* formatting

.github/workflows/deploy-website.yml

@@ -37,7 +37,7 @@ jobs:
       - name: pydoc-markdown install
         run: |
           python -m pip install --upgrade pip
-          pip install pydoc-markdown
+          pip install pydoc-markdown pyyaml colored
       - name: pydoc-markdown run
         run: |
           pydoc-markdown
@@ -50,6 +50,9 @@ jobs:
       - name: quarto run
         run: |
           quarto render .
+      - name: Process notebooks
+        run: |
+          python process_notebooks.py
       - name: Test Build
         run: |
           if [ -e yarn.lock ]; then
@@ -80,7 +83,7 @@ jobs:
       - name: pydoc-markdown install
         run: |
           python -m pip install --upgrade pip
-          pip install pydoc-markdown
+          pip install pydoc-markdown pyyaml colored
       - name: pydoc-markdown run
         run: |
           pydoc-markdown
@@ -93,6 +96,9 @@ jobs:
       - name: quarto run
         run: |
           quarto render .
+      - name: Process notebooks
+        run: |
+          python process_notebooks.py
       - name: Build website
         run: |
           if [ -e yarn.lock ]; then