链接到斯芬克斯的数字

joh*_*han 3 restructuredtext python-sphinx

我的文档中有一些图像是作为Sphinx中的一组reST文件创建的.我更喜欢让它们保持很小,我希望用户点击它们以获得更大的图像.较小的图像不是出于文件大小的原因,而是出于演示原因.我没有找到一种语法方法来组合标签image:或figure:与ref:或link:.

.. image:: _static/my_image_small.png
Run Code Online (Sandbox Code Playgroud)

我在同一个文件夹中有一个更大的版本:my_image_large.png.

如果您想出一个解决方案,那么较大的图像应该是一个带有显式链接的文件,还是我创建一个带有附加图像的reST文件:tag?另一种方法是使用reST文件中的图像大小,但后来我仍然不知道如何创建从小图像到大图像的链接.有没有办法绕过Sphinx生成器,只提供我想要的HTML?

Rei*_*ees 8

有两种方法可以做到.

首先是插入一些"原始"HTML:

.. raw:: html

    <a href=....><img src=....
Run Code Online (Sandbox Code Playgroud)

第二是使图像可点击.这样你可以将它链接到更大的图像:

.. image:: _static/my_image_small.png
   :target: _static/my_image_large.png
Run Code Online (Sandbox Code Playgroud)

你可以提供更多选择,顺便说一句.请参阅重新构建的文本文档中的完整列表.