Add docs for :execute: and replite_auto_execute

Author: agriyakhetarpal

docs/configuration.md

@@ -85,6 +85,12 @@ voici_new_tab_button_text = "My custom Voici button text"
 You can override this text on a per-directive basis by passing the `:new_tab_button_text:` option
 to the directive. Note that this is compatible only if `:new_tab:` is also provided.
 
+## REPL code auto-execution with the `Replite` directive
+
+It is possible to control whether code snippets in REPL environments automatically executeswhen loaded.
+For this, you may set `replite_auto_execute = False` globally in `conf.py` with  (defaults to `True` if
+not present), or override it on a per-directive basis  with `:execute: true` or `:execute: false`.
+
 ## Strip particular tagged cells from IPython Notebooks
 
 When using the `NotebookLite`, `JupyterLite`, or `Voici` directives with a notebook passed to them, you can

docs/directives/replite.md

@@ -110,3 +110,44 @@ global value using an additional `:new_tab_button_text:` parameter:
    ax.plot(x, y)
    plt.show()
 ```
+
+It is also possible to disable the execution of the code in the Replite console by setting the `:execute:` option to `False`:
+
+```rst
+.. replite::
+   :kernel: xeus-python
+   :new_tab: True # False works too
+   :new_tab_button_text: Open REPL with the code execution disabled
+   :execute: False
+
+   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()
+```
+
+```{eval-rst}
+.. replite::
+   :kernel: xeus-python
+   :new_tab: True # False works too
+   :new_tab_button_text: Open REPL with the code execution disabled
+   :execute: False
+
+   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()
+```
+
+The behaviour can also be [configured globally](../configuration.md#replite-auto-execution-with-the-replite-directive)
+and then overridden in individual directives.