在狮身人面像d中嵌入绘图仪

Question

我试着用nbsphinx嵌入一个包含绘图的Jupyter笔记本，但是这些绘图没有出现在文档中，即使它们在Jupyter笔记本上看起来很好。在

如何在Sphinx中嵌入绘图？我可以把它们作为图像，但是有更好的方法吗？有交互性就好了！在

我要做的是复制this page。它有Jupyter笔记本风格的输入和输出块，并显示了使用绘图制作的交互式绘图。我怎么能做到呢？在

引发了GitHub问题here.

Answer 1

在Python中，您可以生成HTML代码来嵌入带有plotly.tools.get_嵌入功能。在

import plotly.tools as tls

tls.get_embed('https://plot.ly/~chris/1638')

Answer 2

我可以看到两个解决方案，以嵌入您的笔记本电脑细胞与绘图数字斯芬克斯文件。在

1. 使用nbconvert或nbsphinx将笔记本转换为html。一定要使用notebook渲染器来包含plotly javascript捆绑包（也许这就是您的图形没有显示的原因）：请参见https://plot.ly/python/renderers/以获取有关绘图渲染器的文档。然后您可以在sphinx文档中包含html和各种解决方案（请参见Include standalone HTML page in sphinx document）。在
2. 使用斯芬克斯画廊（https://sphinx-gallery.github.io/）及其绘图刮刀。使用sphinx gallery，您可以将文档页面编写为python脚本，该脚本由sphinx的sphinx gallery扩展转换为rest。要配置刮板，请参见https://sphinx-gallery.github.io/advanced.html#integrate-custom-scrapers-with-sphinx-gallery。我们还有一个最小的存储库，展示了如何在https://github.com/plotly/plotly-sphinx-gallery中一起使用plotly和sphinx gallery。 https://github.com/plotly/plotly-sphinx-gallery

Answer 3

图形本身是jupyter笔记本文件中的一个HTML。 你可以打开笔记本.ipnb在任何文本编辑器中，找到图形的HTML的起始位置，将所有这些HTML复制到HTML文件并保存，比如a.HTML，然后在RST doc中插入原始HTML。在

.. raw:: 
    :file: a.html