Python 在Sphinx中嵌入matplotlib绘图:如何显示文档

Python 在Sphinx中嵌入matplotlib绘图:如何显示文档,python,matplotlib,ipython,python-sphinx,Python,Matplotlib,Ipython,Python Sphinx,我有一些带有matplotlib指令内联显示的matplotlib绘图的ipynb文档 当我试图用内联绘图显示我的笔记本时,我有我的斯芬克斯文档。我试着用 ipython nbconvert shalom.ipynb --to rst 但是,唉,它确实给了我一个没有任何内联图形的RST。只有代码列表 您不能告诉我,如何使用已渲染的绘图生成Sphinx文档。 我知道这是可能的。您需要使用 Sphinx是用python编写的,支持编写自定义 扩展。我们已经为matplotlib文档编写了一些,一些

我有一些带有
matplotlib
指令内联显示的
matplotlib
绘图的
ipynb
文档

当我试图用内联绘图显示我的笔记本时,我有我的斯芬克斯文档。我试着用

ipython nbconvert shalom.ipynb --to rst
但是,唉,它确实给了我一个没有任何内联图形的RST。只有代码列表

您不能告诉我,如何使用已渲染的绘图生成Sphinx文档。

我知道这是可能的。

您需要使用

Sphinx是用python编写的,支持编写自定义 扩展。我们已经为matplotlib文档编写了一些,一些 其中一个是matplotlib.sphinxext中matplotlib本身的一部分 模块,其中一些仅包含在sphinx文档目录中, 还有其他组编写的其他扩展,例如numpy和 伊皮顿。我们将在本教程中收集这些信息,并向您展示如何使用它们 安装并将其用于您自己的项目。首先,让我们抓住 git中sphinxext目录中的python扩展文件(请参阅 获取数据),并将它们安装到我们的sampledoc项目中 sphinxext目录:

您需要修改
conf.py
以包括:

extensions = [
          'matplotlib.sphinxext.mathmpl',
          'matplotlib.sphinxext.only_directives',
          'matplotlib.sphinxext.plot_directive',
          'matplotlib.sphinxext.ipython_directive',
          'sphinx.ext.autodoc',
          'sphinx.ext.doctest',
          'ipython_console_highlighting',
          'inheritance_diagram',
          'numpydoc']

如果你知道这是可能的,你为什么要问我们如果我现在知道怎么做,我早就做了。但是,唉,我太笨了,猜不出该如何应对。哈哈,没关系:)幸运的是,我们中的一些人擅长谷歌,我们中的一些人对斯芬克斯非常熟悉:)或者/或者/和:)如果我已经有了一个ipynb,只想告诉斯芬克斯把它做成一个页面呢?好问题;让我们看看是否能找到答案;)<代码>sphinx构建-b html-d_构建/文档树_build/html您的_filename.rst像这样的东西会奏效吗?