我可以在另一个指令中插入一个指令 - reStructuredText / Sphinx

Question

我想在我的admonition指令中插入一个图像：

.. admonition:: John

   Social Network
     .. image: './_static/images/social/facebook.png'
        :target: `facebook`_

但这不起作用。页面内没有显示图片。我该如何解决这个问题？

Answer 1

image指令中有两个错误。首先，您需要在:之后添加一个冒号（.. image）。其次，图像文件路径周围不需要引号（'）。如果文档中的其他地方有一个有效的facebook引用，则以下代码适用于我：

.. admonition:: John

   Social Network
     .. image:: /path/to/facebook.png
        :target: `facebook`_

如果没有第二个冒号，则图像只是一个注释（例如，可能在HTML输出中显示）。有关详细信息，请参阅image directive文档。