是否有可能将图片嵌入到Python的docstring中?

时间:2017-08-17 15:37:47

标签: python image docstring

是否有可能将图片嵌入到Python的docstring中?

我在某个地方看到了docpicture个关键字,但无法在其上找到文档。它是否被刺激了?

图片应该放在哪里?

更新

我试过Sphinx符号,但是我的PyCharm显示了

enter image description here

即。它看到它应该是一个图像,但没有看到图像文件。

如果使用Sphinx我会放在哪里?

1 个答案:

答案 0 :(得分:5)

这取决于您用于处理文档字符串的工具。查看工具的文档以了解如何嵌入图像。

例如,如果您使用的是Sphinx,则可以使用image指令,如this StackOverflow answer中所述:

.. image:: example.png

关于图像的位置,documentation状态:

  

在Sphinx中使用时,给定的文件名必须相对于源文件,或者绝对意味着它们相对于顶级源目录。例如,文件sketch / spam.rst可以将图像images / spam.png称为../images/spam.png或/images/spam.png。