将执行的 Jupyter Notebook 嵌入到基于 rst 的文档中

Question

我想将 Jupyter 笔记本嵌入 RST 文件中。最好，这个笔记本可以是交互式的，但至少可以看到。如果这些笔记本可以在文档构建中执行，那就太好了，但我不知道这是否可能。

我不是在寻找一种不涉及将笔记本嵌入到第一个文件中的解决方案——我知道 nbsphinx 可以从 ipynb 文件构建文档，但这不是我想要的。

谢谢！

Answer 1

这对我有用：

要将 .ipynb 笔记本文件渲染为 .rst，您可以使用“myst_nb”扩展名。

pip install myst-nb

在conf.py中添加'myst_nb'扩展

extensions = [..., 'myst_nb']

在您的 .rst 文件中，您可以添加以下代码：

.. include:: my_notebook.ipynb
   :parser: myst_nb.docutils_

参考：https://myst-nb.readthedocs.io/en/latest/docutils.html