docs(gallery): derive the gallery from the notebook sources

[timtreis]

Fixes#746.

Problem

The Gallery page (docs/gallery.md) duplicated the per-notebook grid cards that also live in the notebooks submodule's section index pages (notebooks/tutorials/index, notebooks/examples/index). Because the two lists are maintained independently in separate repos, they drift: adding a notebook requires editing both, and when gallery.md is missed the Gallery silently omits the notebook.

That's exactly what happened with "Interactive region annotation" — present on the Examples index page but missing from the Gallery on stable (v0.4.0). #689 patched that one card on main, but the structural drift remained.

Fix

Make the section index pages (which live next to the notebooks) the single source. docs/gallery.md keeps its intro and a visible {toctree} to those pages instead of re-listing cards, so every notebook appears automatically and the Gallery can never fall out of sync. Removed the now-orphaned card images under _static/gallery/ (the section cards use _static/img/).

Verification

Built the docs (nb_execution_mode = "off"): the generated gallery.html links all notebooks — including a WIP normalization_and_contrast tutorial that has nogallery.md card, proving a new notebook now shows up with zero gallery.md edits. No new gallery/toctree warnings.

Notes

• Docs-only; no code or public-API change.
• Trade-off: the Gallery landing page shows a nested notebook list rather than inline image cards; the cards remain one click away on the section index pages. If inline cards are preferred, a follow-up could {include} the section card blocks instead — but the toctree is the drift-proof, single-repo change.

[timtreis]

Fixes#746.

Problem

The Gallery page (docs/gallery.md) duplicated the per-notebook grid cards that also live in the notebooks submodule's section index pages (notebooks/tutorials/index, notebooks/examples/index). Because the two lists are maintained independently in separate repos, they drift: adding a notebook requires editing both, and when gallery.md is missed the Gallery silently omits the notebook.

That's exactly what happened with "Interactive region annotation" — present on the Examples index page but missing from the Gallery on stable (v0.4.0). #689 patched that one card on main, but the structural drift remained.

Fix

Make the section index pages (which live next to the notebooks) the single source. docs/gallery.md keeps its intro and a visible {toctree} to those pages instead of re-listing cards, so every notebook appears automatically and the Gallery can never fall out of sync. Removed the now-orphaned card images under _static/gallery/ (the section cards use _static/img/).

Verification

Built the docs (nb_execution_mode = "off"): the generated gallery.html links all notebooks — including a WIP normalization_and_contrast tutorial that has nogallery.md card, proving a new notebook now shows up with zero gallery.md edits. No new gallery/toctree warnings.

Notes

• Docs-only; no code or public-API change.
• Trade-off: the Gallery landing page shows a nested notebook list rather than inline image cards; the cards remain one click away on the section index pages. If inline cards are preferred, a follow-up could {include} the section card blocks instead — but the toctree is the drift-proof, single-repo change.

[timtreis]

Fixes#746.

Problem

The Gallery page (docs/gallery.md) duplicated the per-notebook grid cards that also live in the notebooks submodule's section index pages (notebooks/tutorials/index, notebooks/examples/index). Because the two lists are maintained independently in separate repos, they drift: adding a notebook requires editing both, and when gallery.md is missed the Gallery silently omits the notebook.

That's exactly what happened with "Interactive region annotation" — present on the Examples index page but missing from the Gallery on stable (v0.4.0). #689 patched that one card on main, but the structural drift remained.

Fix

Make the section index pages (which live next to the notebooks) the single source. docs/gallery.md keeps its intro and a visible {toctree} to those pages instead of re-listing cards, so every notebook appears automatically and the Gallery can never fall out of sync. Removed the now-orphaned card images under _static/gallery/ (the section cards use _static/img/).

Verification

Built the docs (nb_execution_mode = "off"): the generated gallery.html links all notebooks — including a WIP normalization_and_contrast tutorial that has nogallery.md card, proving a new notebook now shows up with zero gallery.md edits. No new gallery/toctree warnings.

Notes

• Docs-only; no code or public-API change.
• Trade-off: the Gallery landing page shows a nested notebook list rather than inline image cards; the cards remain one click away on the section index pages. If inline cards are preferred, a follow-up could {include} the section card blocks instead — but the toctree is the drift-proof, single-repo change.

[timtreis]

Fixes#746.

Problem

The Gallery page (docs/gallery.md) duplicated the per-notebook grid cards that also live in the notebooks submodule's section index pages (notebooks/tutorials/index, notebooks/examples/index). Because the two lists are maintained independently in separate repos, they drift: adding a notebook requires editing both, and when gallery.md is missed the Gallery silently omits the notebook.

That's exactly what happened with "Interactive region annotation" — present on the Examples index page but missing from the Gallery on stable (v0.4.0). #689 patched that one card on main, but the structural drift remained.

Fix

Make the section index pages (which live next to the notebooks) the single source. docs/gallery.md keeps its intro and a visible {toctree} to those pages instead of re-listing cards, so every notebook appears automatically and the Gallery can never fall out of sync. Removed the now-orphaned card images under _static/gallery/ (the section cards use _static/img/).

Verification

Built the docs (nb_execution_mode = "off"): the generated gallery.html links all notebooks — including a WIP normalization_and_contrast tutorial that has nogallery.md card, proving a new notebook now shows up with zero gallery.md edits. No new gallery/toctree warnings.

Notes

• Docs-only; no code or public-API change.
• Trade-off: the Gallery landing page shows a nested notebook list rather than inline image cards; the cards remain one click away on the section index pages. If inline cards are preferred, a follow-up could {include} the section card blocks instead — but the toctree is the drift-proof, single-repo change.

[timtreis]

Fixes#746.

Problem

The Gallery page (docs/gallery.md) duplicated the per-notebook grid cards that also live in the notebooks submodule's section index pages (notebooks/tutorials/index, notebooks/examples/index). Because the two lists are maintained independently in separate repos, they drift: adding a notebook requires editing both, and when gallery.md is missed the Gallery silently omits the notebook.

That's exactly what happened with "Interactive region annotation" — present on the Examples index page but missing from the Gallery on stable (v0.4.0). #689 patched that one card on main, but the structural drift remained.

Fix

Make the section index pages (which live next to the notebooks) the single source. docs/gallery.md keeps its intro and a visible {toctree} to those pages instead of re-listing cards, so every notebook appears automatically and the Gallery can never fall out of sync. Removed the now-orphaned card images under _static/gallery/ (the section cards use _static/img/).

Verification

Built the docs (nb_execution_mode = "off"): the generated gallery.html links all notebooks — including a WIP normalization_and_contrast tutorial that has nogallery.md card, proving a new notebook now shows up with zero gallery.md edits. No new gallery/toctree warnings.

Notes

• Docs-only; no code or public-API change.
• Trade-off: the Gallery landing page shows a nested notebook list rather than inline image cards; the cards remain one click away on the section index pages. If inline cards are preferred, a follow-up could {include} the section card blocks instead — but the toctree is the drift-proof, single-repo change.

[timtreis]

Fixes#746.

Problem

The Gallery page (docs/gallery.md) duplicated the per-notebook grid cards that also live in the notebooks submodule's section index pages (notebooks/tutorials/index, notebooks/examples/index). Because the two lists are maintained independently in separate repos, they drift: adding a notebook requires editing both, and when gallery.md is missed the Gallery silently omits the notebook.

That's exactly what happened with "Interactive region annotation" — present on the Examples index page but missing from the Gallery on stable (v0.4.0). #689 patched that one card on main, but the structural drift remained.

Fix

Make the section index pages (which live next to the notebooks) the single source. docs/gallery.md keeps its intro and a visible {toctree} to those pages instead of re-listing cards, so every notebook appears automatically and the Gallery can never fall out of sync. Removed the now-orphaned card images under _static/gallery/ (the section cards use _static/img/).

Verification

Built the docs (nb_execution_mode = "off"): the generated gallery.html links all notebooks — including a WIP normalization_and_contrast tutorial that has nogallery.md card, proving a new notebook now shows up with zero gallery.md edits. No new gallery/toctree warnings.

Notes

• Docs-only; no code or public-API change.
• Trade-off: the Gallery landing page shows a nested notebook list rather than inline image cards; the cards remain one click away on the section index pages. If inline cards are preferred, a follow-up could {include} the section card blocks instead — but the toctree is the drift-proof, single-repo change.

[timtreis]

Fixes#746.

Problem

The Gallery page (docs/gallery.md) duplicated the per-notebook grid cards that also live in the notebooks submodule's section index pages (notebooks/tutorials/index, notebooks/examples/index). Because the two lists are maintained independently in separate repos, they drift: adding a notebook requires editing both, and when gallery.md is missed the Gallery silently omits the notebook.

That's exactly what happened with "Interactive region annotation" — present on the Examples index page but missing from the Gallery on stable (v0.4.0). #689 patched that one card on main, but the structural drift remained.

Fix

Make the section index pages (which live next to the notebooks) the single source. docs/gallery.md keeps its intro and a visible {toctree} to those pages instead of re-listing cards, so every notebook appears automatically and the Gallery can never fall out of sync. Removed the now-orphaned card images under _static/gallery/ (the section cards use _static/img/).

Verification

Built the docs (nb_execution_mode = "off"): the generated gallery.html links all notebooks — including a WIP normalization_and_contrast tutorial that has nogallery.md card, proving a new notebook now shows up with zero gallery.md edits. No new gallery/toctree warnings.

Notes

• Docs-only; no code or public-API change.
• Trade-off: the Gallery landing page shows a nested notebook list rather than inline image cards; the cards remain one click away on the section index pages. If inline cards are preferred, a follow-up could {include} the section card blocks instead — but the toctree is the drift-proof, single-repo change.

[timtreis]

Fixes#746.

Problem

The Gallery page (docs/gallery.md) duplicated the per-notebook grid cards that also live in the notebooks submodule's section index pages (notebooks/tutorials/index, notebooks/examples/index). Because the two lists are maintained independently in separate repos, they drift: adding a notebook requires editing both, and when gallery.md is missed the Gallery silently omits the notebook.

That's exactly what happened with "Interactive region annotation" — present on the Examples index page but missing from the Gallery on stable (v0.4.0). #689 patched that one card on main, but the structural drift remained.

Fix

Make the section index pages (which live next to the notebooks) the single source. docs/gallery.md keeps its intro and a visible {toctree} to those pages instead of re-listing cards, so every notebook appears automatically and the Gallery can never fall out of sync. Removed the now-orphaned card images under _static/gallery/ (the section cards use _static/img/).

Verification

Built the docs (nb_execution_mode = "off"): the generated gallery.html links all notebooks — including a WIP normalization_and_contrast tutorial that has nogallery.md card, proving a new notebook now shows up with zero gallery.md edits. No new gallery/toctree warnings.

Notes

• Docs-only; no code or public-API change.
• Trade-off: the Gallery landing page shows a nested notebook list rather than inline image cards; the cards remain one click away on the section index pages. If inline cards are preferred, a follow-up could {include} the section card blocks instead — but the toctree is the drift-proof, single-repo change.