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

Question

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

.. admonition:: John

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

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

Answer 1

您的图像指令中有两个错误。首先，您需要一个额外的冒号 ( :) 跟随.. image。'其次，图像文件路径不需要引号 ( )。如果文档中的其他地方有有效的facebook参考，则以下代码适用于我：

.. admonition:: John

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

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