我的文档中有一些图像是作为Sphinx中的一组reST文件创建的。我更喜欢让它们保持很小，我希望用户点击它们以获得更大的图像。较小的图像不是出于文件大小的原因，而是出于演示原因。我没有找到将标记image:或figure:与ref:或link:合并的语法方法。
.. image:: _static/my_image_small.png
我在同一个文件夹中有一个更大的版本：my_image_large.png。
如果你想出一个解决方案，那么较大的图像应该只是一个带有显式链接的文件，还是我创建一个带有附加图像的reST文件：tag？另一种方法是使用reST文件中的图像大小，但后来我仍然不知道如何创建从小图像到大图像的链接。有没有办法绕过Sphinx生成器，只提供我想要的HTML？
答案 0 :(得分：8)
有两种方法可以做到。
首先是插入一些“原始”HTML：
.. raw:: html
<a href=....><img src=....
第二个是使图像可点击。这样你可以将它链接到更大的图像：
.. image:: _static/my_image_small.png
:target: _static/my_image_large.png
您可以提供更多选项，顺便说一句。请参阅restructured text documentation。
中的完整列表