..重组文本中的plot指令

Question

我在看this site。具体来说，source。它似乎创建了一个情节（完整的源代码！）非常容易：

.. plot: somefile.py

但是，当我尝试时，狮身人面像对我大喊大叫。 "ERROR: Unknown directive type "plot".所以问题是如何教授sphinx plot指令？

Answer 1

您需要激活sphinx的绘图扩展（请参阅this explanation）。我没试过，但这可能就足够了：

extensions = ['matplotlib.sphinxext.plot_directive']

将此添加到conf.py以激活.. plot::。

注意：Sphinx指令以两个冒号开头：

.. plot::

    ...

Answer 2

matplotlib包含plot指令的Sphinx指令;查看他们的sample doc for Sphinx和documenting matplotlib chapter。