From 5628b7b88709df424eefb9fd0d11f06f704ec89a Mon Sep 17 00:00:00 2001 From: Max Date: Tue, 3 Feb 2026 15:25:06 +0100 Subject: [PATCH 1/7] Auto list tutorials with glob --- docs/source/tutorials.rst | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/docs/source/tutorials.rst b/docs/source/tutorials.rst index 4b448a9..c172c90 100644 --- a/docs/source/tutorials.rst +++ b/docs/source/tutorials.rst @@ -5,5 +5,6 @@ Here are a few tutorials to help you get started. .. toctree:: :maxdepth: 1 + :glob: - tutorials/example_tutorial.ipynb + tutorials/*.ipynb From c9d354e211d04fd5c785d3170fb8810cf7c7073f Mon Sep 17 00:00:00 2001 From: Max Date: Tue, 3 Feb 2026 15:31:01 +0100 Subject: [PATCH 2/7] Fixed tutorials path --- docs/source/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/conf.py b/docs/source/conf.py index a687be3..17933eb 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -10,7 +10,7 @@ sys.path.insert(0, os.path.abspath("../src")) # Copy tutorial notebooks from project root to docs/source/tutorials/ -tutorials_source = Path(__file__).parent.parent.parent / "tutorials" +tutorials_source = Path(__file__).parent.parent / "tutorials" tutorials_dest = Path(__file__).parent / "tutorials" if tutorials_source.exists(): From 4fa3a5ad66dc837db203f18283f603fc21f0de98 Mon Sep 17 00:00:00 2001 From: Max Date: Tue, 3 Feb 2026 15:33:09 +0100 Subject: [PATCH 3/7] Execute tutorials --- docs/source/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/conf.py b/docs/source/conf.py index 17933eb..c7f099b 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -50,7 +50,7 @@ exclude_patterns = ["_build", "Thumbs.db", ".DS_Store", "**/.ipynb_checkpoints"] # nbsphinx configuration -nbsphinx_execute = "never" # Don't execute notebooks during build +nbsphinx_execute = "always" # Execute notebooks during build # -- Options for HTML output ------------------------------------------------- From 5c38ebdc799af8aba3568bc81559d6da9fd2f2a6 Mon Sep 17 00:00:00 2001 From: Max Date: Tue, 3 Feb 2026 15:37:52 +0100 Subject: [PATCH 4/7] List tutorials with /* --- docs/source/tutorials.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/tutorials.rst b/docs/source/tutorials.rst index c172c90..fed41de 100644 --- a/docs/source/tutorials.rst +++ b/docs/source/tutorials.rst @@ -7,4 +7,4 @@ Here are a few tutorials to help you get started. :maxdepth: 1 :glob: - tutorials/*.ipynb + tutorials/* From ad8eddc7af7645887b38f87fa4419f668fdb9105 Mon Sep 17 00:00:00 2001 From: Max Date: Tue, 3 Feb 2026 15:51:05 +0100 Subject: [PATCH 5/7] FIxed parent --- docs/source/conf.py | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/source/conf.py b/docs/source/conf.py index c7f099b..406c718 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -10,7 +10,7 @@ sys.path.insert(0, os.path.abspath("../src")) # Copy tutorial notebooks from project root to docs/source/tutorials/ -tutorials_source = Path(__file__).parent.parent / "tutorials" +tutorials_source = Path(__file__).parent.parent.parent / "tutorials" tutorials_dest = Path(__file__).parent / "tutorials" if tutorials_source.exists(): From 1c3b3f44f7e114ee42b311dadd33f2c6bf8d990b Mon Sep 17 00:00:00 2001 From: Max Date: Tue, 3 Feb 2026 16:03:12 +0100 Subject: [PATCH 6/7] Build docs in action with make html --- .github/actions/build-docs/action.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/actions/build-docs/action.yml b/.github/actions/build-docs/action.yml index ca4822e..c11ac59 100644 --- a/.github/actions/build-docs/action.yml +++ b/.github/actions/build-docs/action.yml @@ -34,7 +34,7 @@ runs: run: | cd docs if [ "${{ inputs.treat-warnings-as-errors }}" = "true" ]; then - sphinx-build -b html -W --keep-going source build/html + make html SPHINXOPTS="-W --keep-going" else - sphinx-build -b html source build/html + make html fi From 21e04c738fa06e25325e7b6f3657cfbf366817f6 Mon Sep 17 00:00:00 2001 From: Max Date: Tue, 3 Feb 2026 16:03:32 +0100 Subject: [PATCH 7/7] make html --- .github/actions/build-docs/action.yml | 6 +----- 1 file changed, 1 insertion(+), 5 deletions(-) diff --git a/.github/actions/build-docs/action.yml b/.github/actions/build-docs/action.yml index c11ac59..8400c21 100644 --- a/.github/actions/build-docs/action.yml +++ b/.github/actions/build-docs/action.yml @@ -33,8 +33,4 @@ runs: shell: bash run: | cd docs - if [ "${{ inputs.treat-warnings-as-errors }}" = "true" ]; then - make html SPHINXOPTS="-W --keep-going" - else - make html - fi + make html