Third party directive example

docs/requirements.txt

@@ -1,3 +1,4 @@
 sphinx==4.2.0
 sphinx-rtd-theme==1.0.0
 docutils==0.16
+matplotlib==3.4.3

docs/src/conf.py

@@ -21,6 +21,7 @@
     "sphinx.ext.extlinks",
     "sphinx_rtd_theme",
     "sphinx_codeautolink",
+    "matplotlib.sphinxext.plot_directive"
 ]
 
 # Builtin options
@@ -40,6 +41,12 @@
 extlinks = {
     'issue': ('https://github.com/felix-hilden/sphinx-codeautolink/issues/%s', '#'),
 }
+# Copy plot directive options from Seaborn
+# Include the example source for plots in API docs
+plot_include_source = True
+plot_formats = [("png", 90)]
+plot_html_show_formats = False
+plot_html_show_source_link = False
 
 
 def setup(app):

docs/src/examples.rst

@@ -190,3 +190,18 @@ Please specify a ``type`` in :rst:dir:`autolink-examples`::
 
    .. autolink-examples:: numpy.linspace
       :type: func
+
+Third-party code blocks
+-----------------------
+It also integrates with third-party code blocks.
+The code block below uses matplotlib's
+:mod:`~matplotlib.sphinxext.plot_directive` to automatically
+run the code and include the output plot in the documentation:
+
+.. plot::
+
+   import numpy as np
+   from matplotlib import pyplot as plt
+
+   x = np.linspace(0, 2 * np.pi, 100)
+   plt.plot(x, np.cos(x))

setup.py

@@ -13,6 +13,7 @@
     ],
     "docs": [
         "sphinx-rtd-theme",
+        "matplotlib"
     ],
     "tests": [
         "pytest>=6",