是否有Sphinx的灯箱扩展？

Question

我在Sphinx有一个静态网站和大量的插图。有没有一种简单的方法来集成灯箱并自动生成缩略图？

 .. image:: picture.jpeg
    :lightbox: true
    :width: 200 px
    :alt: alternate text
    :align: right

Answer 1

我不知道，尽管它可能是创建新扩展程序的好选择。

此外，您可以通过修改模板来包含您最喜爱的javascript lightbox-y图像查看器来执行类似的操作，但这不会处理生成缩略图。

Answer 2

我制作了一个肮脏的黑客解决方案并将其粘贴到此处，因为我不确定是否需要/有时间维护它。它扩展Figure类（以添加下面的文本）并滥用download_reference节点。它还以非文档方式覆盖了app.add_node方法（birkinfeld应该命名为set_node）

它生成一个缩略图，让Sphinx将原始图像放入下载中。

你还需要添加jQuery＆amp;

中的FancyBox

享受

http://pastebin.com/pMhKnTkv

用法：

.. fancyimage:: img/exit_jam.jpg
    :fitwidth: 100
    :fitheight: 100
    :alt: cool
    :rel: tst

Answer 3

将sphinxcontrib-images扩展名添加到您的conf.py文件中：

extensions = [
      …
      'sphinxcontrib.images',
      …
]

然后使用此设置告知扩展程序将灯箱添加到标准.. image::来电：

images_config = {
    'override_image_directive': True,
}

或使用缩略图选项.. thumbnail:: picture.png

请务必先安装扩展程序：pip install sphinxcontrib-images

有关详细信息，请参阅https://github.com/spinus/sphinxcontrib-images

上的sphinxcontrib-images主页