add lightbox plugin and customise to avoid slideshow behavior

docs/_extra/css/extra.css

@@ -185,6 +185,11 @@
   .md-typeset :is(.emojione,.twemoji,.gemoji) svg {
   border: none;
   }
+
+  /* remove lightbox controls so users can't slideshow */
+  .gnext, .gprev {
+	display: none !important;
+  }
   
   /* reduce padding between title and breadcrumbs */
   

mkdocs.yml

@@ -122,6 +122,18 @@ plugins:
   # - info
   # Search is built in, but must be enabled when you add other plugins
   - search
+  # https://squidfunk.github.io/mkdocs-material/reference/images/#lightbox
+  - glightbox:
+      touchNavigation: false
+      loop: false
+      effect: zoom
+      slide_effect: none
+      width: auto
+      height: auto
+      zoomable: false
+      draggable: false
+      auto_caption: false
+      caption_position: bottom
   # https://mkdocs-macros-plugin.readthedocs.io/en/latest/
   - macros:
       # https://mkdocs-macros-plugin.readthedocs.io/en/latest/advanced/#including-external-yaml-files

requirements.txt

@@ -1 +1,2 @@
+mkdocs-glightbox
 mkdocs-macros-plugin==1.0.4