From cf839057b3b2cadd578136278e134d8f40ca05ac Mon Sep 17 00:00:00 2001 From: Peter Corke Date: Tue, 13 Oct 2026 18:06:28 +1000 Subject: [PATCH 1/3] docs: troubleshooting note for Jupyter lite failing to start A browser holding files from an earlier deploy of the Jupyter lite site shows many 'Plugin failed to activate / Invalid response: 404' errors and a broken UI. Document the fixes: private window, clearing site data (Safari, Chrome/Edge, Firefox), hard reload, or another browser. Co-Authored-By: Claude Sonnet 5.5 --- docs/source/jupyter-notebooks.rst | 20 ++++++++++++++++++++ 1 file changed, 20 insertions(+) diff --git a/docs/source/jupyter-notebooks.rst b/docs/source/jupyter-notebooks.rst index 3d09ec82..de034ed0 100644 --- a/docs/source/jupyter-notebooks.rst +++ b/docs/source/jupyter-notebooks.rst @@ -89,10 +89,30 @@ installing anything on your local machine. To use it, just click the "Launch in Lite" button at the top of each notebook page, and it will open the notebook in a new browser tab running Jupyter lite. +.. admonition:: If Jupyter lite does not start + + If the page loads but the JupyterLab interface is broken, or the console shows many + ``Plugin '...' failed to activate`` / ``Invalid response: 404`` errors, your browser is + most likely holding files from an earlier version of the site. Any one of these fixes + it, quickest first: + + * Open the link in a **private / incognito window**, which starts with no stored site data. + * **Clear the site's data** for ``petercorke.github.io`` and reload. In Safari this is + *Settings* |rarr| *Privacy* |rarr| *Manage Website Data*; in Chrome and Edge it is the + icon at the left of the address bar |rarr| *Site settings* |rarr| *Clear data*; in + Firefox it is the padlock |rarr| *Clear cookies and site data*. + * Do a **hard reload** (Shift-click the reload button, or Ctrl/Cmd-Shift-R). + * Try another browser, or use Colab or a local install instead. + + Your own notebooks in Jupyter lite are stored in the same browser data, so clearing the site's data + deletes them. Download any notebooks you want to keep first. + In the cloud using Google Colab ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ +.. |rarr| unicode:: U+2192 + .. |colab_image| image:: https://colab.research.google.com/img/colab_favicon_256px.png :height: 30px :alt: Open In Colab From 3ad1bd9aed581bb563902a1136cd5c552e59efda Mon Sep 17 00:00:00 2001 From: Peter Corke Date: Tue, 13 Oct 2026 18:10:19 +1000 Subject: [PATCH 2/3] docs: make the JupyterLite troubleshooting a section and link it from the README An admonition buried in the docs would not be found. Make it a 'Troubleshooting JupyterLite' subsection (so it has a stable anchor) and link it in small text under the Try it Now badges in the README. Co-Authored-By: Claude Sonnet 5.5 --- README.md | 2 ++ docs/source/jupyter-notebooks.rst | 35 ++++++++++++++++--------------- 2 files changed, 20 insertions(+), 17 deletions(-) diff --git a/README.md b/README.md index 92cc38ef..73c096b3 100644 --- a/README.md +++ b/README.md @@ -10,6 +10,8 @@ [![JupyterLite](https://img.shields.io/badge/Try_it_Now-JupyterLite-orange?style=for-the-badge&logo=jupyter)](https://petercorke.github.io/machinevision-toolbox-python/lite/lab?path=index.ipynb) [![PyPI version](https://img.shields.io/pypi/v/machinevision-toolbox-python?style=for-the-badge&color=blue)](https://pypi.org/project/machinevision-toolbox-python/) [![Documentation](https://img.shields.io/badge/Docs-View_Online-blue?style=for-the-badge)](https://petercorke.github.io/machinevision-toolbox-python/) +
+ Troubleshooting JupyterLite

GitHub • diff --git a/docs/source/jupyter-notebooks.rst b/docs/source/jupyter-notebooks.rst index de034ed0..8bd9fbd5 100644 --- a/docs/source/jupyter-notebooks.rst +++ b/docs/source/jupyter-notebooks.rst @@ -89,23 +89,24 @@ installing anything on your local machine. To use it, just click the "Launch in Lite" button at the top of each notebook page, and it will open the notebook in a new browser tab running Jupyter lite. -.. admonition:: If Jupyter lite does not start - - If the page loads but the JupyterLab interface is broken, or the console shows many - ``Plugin '...' failed to activate`` / ``Invalid response: 404`` errors, your browser is - most likely holding files from an earlier version of the site. Any one of these fixes - it, quickest first: - - * Open the link in a **private / incognito window**, which starts with no stored site data. - * **Clear the site's data** for ``petercorke.github.io`` and reload. In Safari this is - *Settings* |rarr| *Privacy* |rarr| *Manage Website Data*; in Chrome and Edge it is the - icon at the left of the address bar |rarr| *Site settings* |rarr| *Clear data*; in - Firefox it is the padlock |rarr| *Clear cookies and site data*. - * Do a **hard reload** (Shift-click the reload button, or Ctrl/Cmd-Shift-R). - * Try another browser, or use Colab or a local install instead. - - Your own notebooks in Jupyter lite are stored in the same browser data, so clearing the site's data - deletes them. Download any notebooks you want to keep first. +Troubleshooting JupyterLite +^^^^^^^^^^^^^^^^^^^^^^^^^^^ + +If the page loads but the JupyterLab interface is broken, or the console shows many +``Plugin '...' failed to activate`` / ``Invalid response: 404`` errors, your browser is +most likely holding files from an earlier version of the site. Any one of these fixes +it, quickest first: + +* Open the link in a **private / incognito window**, which starts with no stored site data. +* **Clear the site's data** for ``petercorke.github.io`` and reload. In Safari this is + *Settings* |rarr| *Privacy* |rarr| *Manage Website Data*; in Chrome and Edge it is the + icon at the left of the address bar |rarr| *Site settings* |rarr| *Clear data*; in + Firefox it is the padlock |rarr| *Clear cookies and site data*. +* Do a **hard reload** (Shift-click the reload button, or Ctrl/Cmd-Shift-R). +* Try another browser, or use Colab or a local install instead. + +Your own notebooks in Jupyter lite are stored in the same browser data, so clearing the site's data +deletes them. Download any notebooks you want to keep first. In the cloud using Google Colab From c978ed74edcabfe41d7c109817ef0bcf66e276d4 Mon Sep 17 00:00:00 2001 From: Peter Corke Date: Tue, 13 Oct 2026 18:12:09 +1000 Subject: [PATCH 3/3] docs: add an introductory sentence to the JupyterLite troubleshooting section Co-Authored-By: Claude Sonnet 5.5 --- docs/source/jupyter-notebooks.rst | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/source/jupyter-notebooks.rst b/docs/source/jupyter-notebooks.rst index 8bd9fbd5..0144715f 100644 --- a/docs/source/jupyter-notebooks.rst +++ b/docs/source/jupyter-notebooks.rst @@ -92,6 +92,10 @@ browser tab running Jupyter lite. Troubleshooting JupyterLite ^^^^^^^^^^^^^^^^^^^^^^^^^^^ +JupyterLite is a powerful capability, running a full Python environment inside your +browser, but it can sometimes get tripped up by what the browser has stored from +an earlier visit. + If the page loads but the JupyterLab interface is broken, or the console shows many ``Plugin '...' failed to activate`` / ``Invalid response: 404`` errors, your browser is most likely holding files from an earlier version of the site. Any one of these fixes