Add new tutorials to how to page in docs

docs/demos-template.rst

@@ -1,5 +1,20 @@
 Tutorials
 *********
 
+Load and visualise data
+=======================
+
+.. nbgallery::
+${notebooks_load}
+
+Geometry
+=======================
+
+.. nbgallery::
+${notebooks_geometry}
+
+Advanced topics
+===============
+
 .. nbgallery::
-${notebooks}
+${notebooks_advanced}

docs/mkdemos.py

@@ -11,26 +11,46 @@
 from tqdm import tqdm
 
 # URLS of the notebooks to render
-NOTEBOOKS = (
-    "https://github.com/TomographicImaging/CIL-Demos/raw/main/demos/1_Introduction/00_CIL_geometry.ipynb",
+NOTEBOOKS_load = [
+    "https://tomography.stfc.ac.uk/how-tos/ZeissDataReader.ipynb",
+    "https://tomography.stfc.ac.uk/how-tos/NikonDataReader.ipynb"
+]
+
+NOTEBOOKS_geometry = [
+    "https://github.com/TomographicImaging/CIL-Demos/raw/main/demos/1_Introduction/00_CIL_geometry.ipynb"
+]
+
+NOTEBOOKS_advanced = [
     "https://github.com/TomographicImaging/CIL-User-Showcase/raw/main/003_1D_integral_inverse_problem/deriv2_cgls.ipynb",
     "https://github.com/TomographicImaging/CIL-Demos/raw/main/misc/callback_demonstration.ipynb"
-)
+]
+
 SOURCE = Path(__file__).parent / "source" # sphinx documentation dir
 NBDIR = "demos" # notebook subdir to create
 (SOURCE / NBDIR).mkdir(parents=True, exist_ok=True)
 
 # download the notebooks
-notebooks = []
-with tqdm(NOTEBOOKS, unit="ipynb") as urls:
-    for url in urls:
-        notebook = Path(urlparse(url).path)
-        urls.set_description(notebook.stem)
-        with urlopen(url) as response:
-            (SOURCE / NBDIR / notebook.name).write_bytes(response.read())
-        notebooks.append(f"    {NBDIR}/{notebook.stem}")
+def download_notebooks(urls):
+    notebooks = []
+    with tqdm(urls, unit="ipynb") as nb_urls:
+        for url in nb_urls :
+            notebook = Path(urlparse(url).path)
+            print(notebook)
+            nb_urls.set_description(notebook.stem)
+            with urlopen(url) as response:
+                (SOURCE / NBDIR / notebook.name).write_bytes(response.read())
+            notebooks.append(f"    {NBDIR}/{notebook.stem}")
+    return "\n".join(notebooks)
+
+notebooks_load = download_notebooks(NOTEBOOKS_load)
+notebooks_geometry = download_notebooks(NOTEBOOKS_geometry)
+notebooks_advanced = download_notebooks(NOTEBOOKS_advanced)
 
 # load template
 tmp = Template((SOURCE / '..' / 'demos-template.rst').read_text())
 # write to demos.rst
-(SOURCE / 'demos.rst').write_text(tmp.safe_substitute(notebooks="\n".join(notebooks)))
+(SOURCE / 'demos.rst').write_text(tmp.safe_substitute(
+    notebooks_load=notebooks_load,
+    notebooks_geometry=notebooks_geometry,
+    notebooks_advanced=notebooks_advanced
+))