使用image指令的target属性的类似缩略图的行为

Question

我使用Sphinx生成一些文档.我有一个reStructuredText文档,我想把图像放入其中.情况是图像应该是可点击的,以便在用户点击图像后,应该以完整尺寸显示该图像.我使用image指令及其目标选项,如下所示:

.. image:: /images/some_image.png
   :alt: Image descripion
   :align: center
   :target: `big_some_image`_

.. _big_some_image: /images/some_image.png

问题是在渲染页面中我得到:

<a href="/images/some_image.png"><img src="../../../_images/some_image.png"></a>

因此src,image指令中有正确的但href超链接的属性不正确.

问题:

• 有没有办法以image指令的方式生成链接？我的意思是相对于文件.

• 有没有其他(内置)方式有"缩略图 - >点击 - >大图像"行为？

Answer 1

只需使用比例选项:

.. image:: large_image.png
    :scale: 20%

单击缩放图像时,完整图像将加载到其自己的窗口中.所以这不会增加页面上的图像大小,但无论如何这都会很麻烦.

Answer 2

image当您在 Sphinx 中使用指令时，Sphinx 会执行一些特殊处理来查找图像文件并将其复制到您的项目（如您的_images目录）中，然后呈现 HTML 以指向该位置。

但该target选项仅采用 URL 作为参数。它对您的 Sphinx 项目一无所知，也不知道您的图像是如何布局的，并且不会尝试猜测。

如果您想让它指向同一文件的较大版本，您可能需要执行一些手动步骤（例如将文件复制到特定位置），或者可能提供大文件的相对 URL，而不是您的示例中的绝对 URL。

如果您想采用完全不同的方式，您还可以尝试覆盖和修改项目的 HTML 模板，以添加一些 JavaScript 来获得您想要的点击放大图像效果。