Add replite console to the users docs

martinRenou · martinRenou · commit 60f8ca980ef0 · 2022-03-10T17:53:19.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/index.rst b/doc/index.rst
@@ -36,7 +36,6 @@ Installation
 
 Further details are available in the :doc:`Installation Guide <users/installing/index>`.
 
-
 ******************
 Learning resources
 ******************
diff --git a/doc/users/index.rst b/doc/users/index.rst
@@ -19,6 +19,25 @@ General
    faq/index.rst
    resources/index.rst
 
+Live example
+############
+
+Try Matplotlib directly in this documentation!
+
+.. replite::
+   :kernel: python
+   :height: 600px
+
+    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()
+
 Tutorials and examples
 ######################
 
@@ -29,7 +48,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
+git+https://github.com/martinRenou/jupyterlite-sphinx@bail_if_error

Original file line number	Diff line number	Diff line change
`@@ -73,6 +73,7 @@`
`73`	`73`	`'sphinxext.redirect_from',`
`74`	`74`	`'sphinx_copybutton',`
`75`	`75`	`'sphinx_panels',`
	`76`	`+ 'jupyterlite_sphinx',`
`76`	`77`	`]`
`77`	`78`
`78`	`79`	`exclude_patterns = [`