try fix

Author: juanitorduz

.gitignore

@@ -15,3 +15,4 @@ docs/build/
 docs/jupyter_execute/
 docs/source/api/generated/
 docs/source/_static/thumbnails/
+# Note: thumbnails are generated during build (see .readthedocs.yaml)

.readthedocs.yaml

@@ -14,6 +14,9 @@ build:
     # nodejs: "16"
     # rust: "1.55"
     # golang: "1.17"
+  commands:
+    # Generate gallery before building docs
+    - python scripts/generate_gallery.py
 
 # Build documentation in the docs/ directory with Sphinx
 sphinx:

docs/source/notebooks/index.md

@@ -1,12 +1,12 @@
 # Example Gallery
-## Regression Kink Design
+## ANCOVA
 ::::{grid} 1 2 3 3
 :gutter: 3
 
-:::{grid-item-card} Regression kink design with `pymc` models
+:::{grid-item-card} ANCOVA for pre/post treatment nonequivalent group designs
 :class-card: sd-card-h-100
-:img-top: ../_static/thumbnails/rkink_pymc.png
-:link: rkink_pymc
+:img-top: ../_static/thumbnails/ancova_pymc.png
+:link: ancova_pymc
 :link-type: doc
 :::
 ::::
@@ -35,32 +35,74 @@
 :::
 ::::
 
-## Inverse Propensity Score Weighting
+## Interrupted Time Series
 ::::{grid} 1 2 3 3
 :gutter: 3
 
-:::{grid-item-card} The Paradox of Propensity Scores in Bayesian Inference
+:::{grid-item-card} Excess deaths due to COVID-19
 :class-card: sd-card-h-100
-:img-top: ../_static/thumbnails/inv_prop_latent.png
-:link: inv_prop_latent
+:img-top: ../_static/thumbnails/its_covid.png
+:link: its_covid
 :link-type: doc
 :::
-:::{grid-item-card} Inverse Propensity Score Weighting with `pymc`
+:::{grid-item-card} Bayesian Interrupted Time Series
 :class-card: sd-card-h-100
-:img-top: ../_static/thumbnails/inv_prop_pymc.png
-:link: inv_prop_pymc
+:img-top: ../_static/thumbnails/its_pymc.png
+:link: its_pymc
+:link-type: doc
+:::
+:::{grid-item-card} Interrupted Time Series (ITS) with scikit-learn models
+:class-card: sd-card-h-100
+:img-top: ../_static/thumbnails/its_skl.png
+:link: its_skl
 :link-type: doc
 :::
 ::::
 
-## ANCOVA
+## Geographical lift testing
 ::::{grid} 1 2 3 3
 :gutter: 3
 
-:::{grid-item-card} ANCOVA for pre/post treatment nonequivalent group designs
+:::{grid-item-card} Bayesian geolift with CausalPy
 :class-card: sd-card-h-100
-:img-top: ../_static/thumbnails/ancova_pymc.png
-:link: ancova_pymc
+:img-top: ../_static/thumbnails/geolift1.png
+:link: geolift1
+:link-type: doc
+:::
+:::{grid-item-card} Multi-cell geolift analysis
+:class-card: sd-card-h-100
+:img-top: ../_static/thumbnails/multi_cell_geolift.png
+:link: multi_cell_geolift
+:link-type: doc
+:::
+::::
+
+## Regression Discontinuity
+::::{grid} 1 2 3 3
+:gutter: 3
+
+:::{grid-item-card} Sharp regression discontinuity with `pymc` models
+:class-card: sd-card-h-100
+:img-top: ../_static/thumbnails/rd_pymc.png
+:link: rd_pymc
+:link-type: doc
+:::
+:::{grid-item-card} Drinking age - Bayesian analysis
+:class-card: sd-card-h-100
+:img-top: ../_static/thumbnails/rd_pymc_drinking.png
+:link: rd_pymc_drinking
+:link-type: doc
+:::
+:::{grid-item-card} Sharp regression discontinuity with scikit-learn models
+:class-card: sd-card-h-100
+:img-top: ../_static/thumbnails/rd_skl.png
+:link: rd_skl
+:link-type: doc
+:::
+:::{grid-item-card} Drinking age with a scikit-learn model
+:class-card: sd-card-h-100
+:img-top: ../_static/thumbnails/rd_skl_drinking.png
+:link: rd_skl_drinking
 :link-type: doc
 :::
 ::::
@@ -83,26 +125,14 @@
 :::
 ::::
 
-## Interrupted Time Series
+## Regression Kink Design
 ::::{grid} 1 2 3 3
 :gutter: 3
 
-:::{grid-item-card} Excess deaths due to COVID-19
-:class-card: sd-card-h-100
-:img-top: ../_static/thumbnails/its_covid.png
-:link: its_covid
-:link-type: doc
-:::
-:::{grid-item-card} Bayesian Interrupted Time Series
-:class-card: sd-card-h-100
-:img-top: ../_static/thumbnails/its_pymc.png
-:link: its_pymc
-:link-type: doc
-:::
-:::{grid-item-card} Interrupted Time Series (ITS) with scikit-learn models
+:::{grid-item-card} Regression kink design with `pymc` models
 :class-card: sd-card-h-100
-:img-top: ../_static/thumbnails/its_skl.png
-:link: its_skl
+:img-top: ../_static/thumbnails/rkink_pymc.png
+:link: rkink_pymc
 :link-type: doc
 :::
 ::::
@@ -131,50 +161,20 @@
 :::
 ::::
 
-## Regression Discontinuity
-::::{grid} 1 2 3 3
-:gutter: 3
-
-:::{grid-item-card} Sharp regression discontinuity with `pymc` models
-:class-card: sd-card-h-100
-:img-top: ../_static/thumbnails/rd_pymc.png
-:link: rd_pymc
-:link-type: doc
-:::
-:::{grid-item-card} Drinking age - Bayesian analysis
-:class-card: sd-card-h-100
-:img-top: ../_static/thumbnails/rd_pymc_drinking.png
-:link: rd_pymc_drinking
-:link-type: doc
-:::
-:::{grid-item-card} Sharp regression discontinuity with scikit-learn models
-:class-card: sd-card-h-100
-:img-top: ../_static/thumbnails/rd_skl.png
-:link: rd_skl
-:link-type: doc
-:::
-:::{grid-item-card} Drinking age with a scikit-learn model
-:class-card: sd-card-h-100
-:img-top: ../_static/thumbnails/rd_skl_drinking.png
-:link: rd_skl_drinking
-:link-type: doc
-:::
-::::
-
-## Geographical lift testing
+## Inverse Propensity Score Weighting
 ::::{grid} 1 2 3 3
 :gutter: 3
 
-:::{grid-item-card} Bayesian geolift with CausalPy
+:::{grid-item-card} The Paradox of Propensity Scores in Bayesian Inference
 :class-card: sd-card-h-100
-:img-top: ../_static/thumbnails/geolift1.png
-:link: geolift1
+:img-top: ../_static/thumbnails/inv_prop_latent.png
+:link: inv_prop_latent
 :link-type: doc
 :::
-:::{grid-item-card} Multi-cell geolift analysis
+:::{grid-item-card} Inverse Propensity Score Weighting with `pymc`
 :class-card: sd-card-h-100
-:img-top: ../_static/thumbnails/multi_cell_geolift.png
-:link: multi_cell_geolift
+:img-top: ../_static/thumbnails/inv_prop_pymc.png
+:link: inv_prop_pymc
 :link-type: doc
 :::
 ::::

pyproject.toml

@@ -78,6 +78,9 @@ docs = [
     "ipywidgets",
     "sphinx-design",
     "sphinx-togglebutton",
+    "nbformat",
+    "nbconvert",
+    "Pillow",
 ]
 lint = ["interrogate", "pre-commit", "ruff", "mypy"]
 test = ["pytest", "pytest-cov", "codespell", "nbformat", "nbconvert"]

scripts/generate_gallery.py

@@ -153,6 +153,8 @@ def _save_thumbnail(
         )
         new_img.save(thumbnail_path)
 
+        # Path relative to document location (notebooks/)
+        # Need to go up one level to source/, then into _static/thumbnails/
         return f"../_static/thumbnails/{thumbnail_name}"
     except Exception as e:
         print(f"Warning: Could not save thumbnail for {notebook_path.name}: {e}")