fastplotlib
diff --git a/‎docs/source/conf.py
Copy file name to clipboardExpand all lines: docs/source/conf.py
+51-3Lines changed: 51 additions & 3 deletions b/‎docs/source/conf.py
Copy file name to clipboardExpand all lines: docs/source/conf.py
+51-3Lines changed: 51 additions & 3 deletions
diff --git a/‎docs/source/user_guide/guide.rst
Copy file name to clipboardExpand all lines: docs/source/user_guide/guide.rst
+2Lines changed: 2 additions & 0 deletions b/‎docs/source/user_guide/guide.rst
Copy file name to clipboardExpand all lines: docs/source/user_guide/guide.rst
+2Lines changed: 2 additions & 0 deletions
@@ -2,7 +2,24 @@
 #
 # For the full list of built-in configuration values, see the documentation:
 # https://www.sphinx-doc.org/en/master/usage/configuration.html
+
+import os
+
+# need to force offscreen rendering before importing fpl
+# otherwise fpl tries to select glfw canvas
+os.environ["WGPU_FORCE_OFFSCREEN"] = "1"
+
 import fastplotlib
+from pygfx.utils.gallery_scraper import find_examples_for_gallery
+from pathlib import Path
+import sys
+from sphinx_gallery.sorting import ExplicitOrder
+import imageio.v3 as iio
+
+ROOT_DIR = Path(__file__).parents[1].parents[0]  # repo root
+EXAMPLES_DIR = Path.joinpath(ROOT_DIR, "examples", "desktop")
+
+sys.path.insert(0, str(ROOT_DIR))
 
 # -- Project information -----------------------------------------------------
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#project-information
@@ -23,9 +40,40 @@
     "sphinx.ext.viewcode",
     "sphinx_copybutton",
     "sphinx_design",
-    "nbsphinx",
+    "sphinx_gallery.gen_gallery"
 ]
 
+sphinx_gallery_conf = {
+    "gallery_dirs": "_gallery",
+    "backreferences_dir": "_gallery/backreferences",
+    "doc_module": ("fastplotlib",),
+    "image_scrapers": ("pygfx",),
+    "remove_config_comments": True,
+    "subsection_order": ExplicitOrder(
+        [
+            "../../examples/desktop/image",
+            "../../examples/desktop/gridplot",
+            "../../examples/desktop/line",
+            "../../examples/desktop/line_collection",
+            "../../examples/desktop/scatter",
+            "../../examples/desktop/heatmap",
+            "../../examples/desktop/misc"
+        ]
+    ),
+    "ignore_pattern": r'__init__\.py',
+    "nested_sections": False,
+    "thumbnail_size": (250, 250)
+}
+
+extra_conf = find_examples_for_gallery(EXAMPLES_DIR)
+sphinx_gallery_conf.update(extra_conf)
+
+# download imageio examples for the gallery
+iio.imread("imageio:clock.png")
+iio.imread("imageio:astronaut.png")
+iio.imread("imageio:coffee.png")
+iio.imread("imageio:hubble_deep_field.png")
+
 autosummary_generate = True
 
 templates_path = ["_templates"]
@@ -52,12 +100,12 @@
 intersphinx_mapping = {
     "python": ("https://docs.python.org/3", None),
     "numpy": ("https://numpy.org/doc/stable/", None),
-    "pygfx": ("https://pygfx.com/stable/", None),
+    "pygfx": ("https://pygfx.com/stable", None),
     "wgpu": ("https://wgpu-py.readthedocs.io/en/latest", None),
 }
 
 html_theme_options = {
-    "source_repository": "https://github.com/kushalkolar/fastplotlib",
+    "source_repository": "https://github.com/fastplotlib/fastplotlib",
     "source_branch": "main",
     "source_directory": "docs/",
 }
@@ -80,6 +80,7 @@ to be easily accessed from figures::
     fig[0, 0]["astronaut"]
 ..
 
+
 Graphics also have mutable properties that can be linked to events. Some of these properties, such as the `data` or `colors` of a line can even be indexed,
 allowing for the creation of very powerful visualizations.
 
@@ -197,6 +198,7 @@ PYGFX_EVENTS = [
     "resize",
 ]
 
+
 adding events (2 methods)
 
 attributes of all events (table)