Add replite console to the users docs

martinRenou · martinRenou · commit ac6e3049d70e · 2022-03-10T11:01:29.000+01:00
diff --git a/doc/conf.py b/doc/conf.py
@@ -73,6 +73,7 @@
     'sphinxext.redirect_from',
     'sphinx_copybutton',
     'sphinx_panels',
+    'jupyterlite_sphinx',
 ]
 
 exclude_patterns = [
diff --git a/doc/users/index.rst b/doc/users/index.rst
@@ -7,6 +7,22 @@
 Users guide
 ###########
 
+Try Matplotlib directly in this documentation!
+
+.. replite::
+   :kernel: python
+   :height: 500px
+
+    import matplotlib.pyplot as plt
+    import numpy as np
+
+    x = np.linspace(0, 2 * np.pi, 200)
+    y = np.sin(x)
+
+    fig, ax = plt.subplots()
+    ax.plot(x, y)
+    plt.show()
+
 General
 #######
 
@@ -29,7 +45,7 @@ Tutorials and examples
    ../tutorials/index.rst
    ../gallery/index.rst
 
-Reference 
+Reference
 #########
 
 .. toctree::
diff --git a/environment.yml b/environment.yml
@@ -37,6 +37,7 @@ dependencies:
   - pip:
       - mpl-sphinx-theme
       - sphinxcontrib-svg2pdfconverter
+      - jupyterlite-sphinx
   # testing
   - coverage
   - flake8>=3.8
diff --git a/requirements/doc/doc-requirements.txt b/requirements/doc/doc-requirements.txt
@@ -19,3 +19,4 @@ sphinxcontrib-svg2pdfconverter>=1.1.0
 sphinx-gallery>=0.10
 sphinx-copybutton
 sphinx-panels
+jupyterlite-sphinx
