狮身人面像添加图像或图形的链接

Question

我在Sphinx尝试一些相当基本的东西。我有一些图像，但我更喜欢让它们保持很小，我想让用户点击它们来获得更大的图像。 我找不到将image:或figure:与ref:或link:合并的语法方法。

.. image:: _static/my_image_small.png

我在同一个文件夹my_image_large.png。

如果你想出一个解决方案，那么较大的图像应该是一个带有显式链接的文件，还是我创建一个带有image:标签的reSt文件？ 另一种方法是使用reSt文件中的图像大小，但后来我仍然不知道如何创建从小图像到大图像的链接。

感谢您帮助我。

Answer 1

只需使用target指令即可。你最终会得到类似的东西：

.. image:: _static/my_image_small.png
   :target: _static/my_image_large.png

在源中使用对静态文件夹的引用并不是绝对必要的。在构建文档时，它们将被复制到_images文件夹（因此您将在构建中使用它们两次，而不需要它们）。

我总是在我管理图像的源文件夹旁边使用一个名为figures的文件夹。但是，my_image_large.png文件要放在_static文件夹中，因为内容将在构建时复制。