Update recipes-docs conf.py esp. to separate source & gallery

Author: sadielbartholomew

recipes-docs/source/conf.py

@@ -1,8 +1,11 @@
+import faulthandler
 import os
 import sys
 
 from sphinx_gallery.sorting import FileNameSortKey
 
+faulthandler.enable()  # seg fault detection - as recipes prone to seg faulting
+
 # Make main 'docs' conf.py importable
 sys.path.insert(0, os.path.abspath("../../docs/source"))
 
@@ -19,8 +22,9 @@
 
 # sphinx-gallery configuration
 sphinx_gallery_conf = {
-    "examples_dirs": "recipes",  # path to recipe files
+    "examples_dirs": "recipes-source",  # path to recipe files
     "gallery_dirs": "recipes",  # path to save gallery generated output
+    "ignore_pattern": "/exclusions/",
     "run_stale_examples": False,
     # Below setting can be buggy: see:
     # https://github.com/sphinx-gallery/sphinx-gallery/issues/967
@@ -29,15 +33,22 @@
     "doc_module": ("cf",),
     "inspect_global_variables": True,
     "within_subsection_order": FileNameSortKey,
-    "default_thumb_file": "_static/cf-recipe-placeholder-squarecrop.png",
+    "default_thumb_file": "../../docs/source/_static/cf-recipe-placeholder-squarecrop.png",
     "image_scrapers": (
         "matplotlib",
     ),  # Ensures Matplotlib images are captured
     "plot_gallery": True,  # Enables plot rendering
     "reset_modules": ("matplotlib",),  # Helps with memory management
     "capture_repr": (),
+    # "filename_pattern": r"plot",
 }
 
+exclude_patterns = [
+    "exclusions/**",
+]
+
 html_static_path = ["../../docs/source/_static"]
 html_logo = "../../docs/source/images/logo.svg"
 html_favicon = "../../docs/source/_static/favicon.ico"
+
+templates_path = ["../../docs/_templates"]