fix widget rendering on docs

Author: ianhi

docs/conf.py

@@ -36,9 +36,6 @@
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
-    #'sphinx.ext.autodoc',
-    #'sphinx.ext.autosummary',
-    "nbsphinx",
     "sphinx.ext.mathjax",
     "sphinx.ext.linkcode",
     "sphinx.ext.napoleon",
@@ -65,11 +62,7 @@
     "members": True,
     "show-inheritance": True,
 }
-nbsphinx_execute = "always"
-nbsphinx_execute_arguments = [
-    "--InlineBackend.figure_formats={'svg', 'pdf'}",
-    "--InlineBackend.rc={'figure.dpi': 96}",
-]
+
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".

mpl_interactions/pyplot.py

@@ -427,6 +427,7 @@ def _gogogo_display(ipympl, use_ipywidgets, display, controls, fig):
         if display:
             fig.show()
             controls[0].show()
+    return controls
 
 
 def interactive_plot(
@@ -523,7 +524,7 @@ def f(x, tau):
         use_ipywidgets=use_ipywidgets,
         **kwargs,
     )
-    _gogogo_display(ipympl, use_ipywidgets, display, controls, fig)
+    controls = _gogogo_display(ipympl, use_ipywidgets, display, controls, fig)
     return fig, ax, controls
 
 
@@ -675,7 +676,7 @@ def update(change, key, label):
     ax.set_xlim(new_x)
     ax.set_ylim(new_y)
 
-    _gogogo_display(ipympl, use_ipywidgets, display, controls, fig)
+    controls = _gogogo_display(ipympl, use_ipywidgets, display, controls, fig)
     return fig, ax, controls
 
 
@@ -913,10 +914,12 @@ def eval_xy(x_, y_, params):
             ax.set_title(title.format(**params))
 
     cache.clear()
-    _gogogo_display(ipympl, use_ipywidgets, display, controls, fig)
+    controls = _gogogo_display(ipympl, use_ipywidgets, display, controls, fig)
     return fig, ax, controls
 
 
+# portions of this docstring were copied directly from the docsting
+# of `matplotlib.pyplot.imshow`
 def interactive_imshow(
     X,
     cmap=None,
@@ -949,7 +952,7 @@ def interactive_imshow(
     X : function or image like
         If a function it must return an image-like object. See matplotlib.pyplot.imshow for the
         full set of valid options.
-    cmap : str or `~matplotlib.colors.Colormap`, default: :rc:`image.cmap`
+    cmap : str or `~matplotlib.colors.Colormap`
         The Colormap instance or registered colormap name used to map
         scalar data to colors. This parameter is ignored for RGB(A) data.
         forwarded to matplotlib
@@ -963,7 +966,7 @@ def interactive_imshow(
         If True rescale the colormap for every function update. Will not update
         if vmin and vmax are provided or if the returned image is RGB(A) like.
         forwarded to matplotlib
-    aspect : {'equal', 'auto'} or float, default: :rc:`image.aspect`
+    aspect : {'equal', 'auto'} or float
         forwarded to matplotlib
     interpolation : str
         forwarded to matplotlib
@@ -1053,6 +1056,6 @@ def update(change, label, key):
     if title is not None:
         ax.set_title(title.format(**params))
 
-    _gogogo_display(ipympl, use_ipywidgets, display, controls, fig)
+    controls = _gogogo_display(ipympl, use_ipywidgets, display, controls, fig)
 
     return fig, ax, controls