lightbox - Sphinx 有灯箱扩展吗？

Question

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

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

Answer 1

将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 主页

Answer 2

我做了一个肮脏的黑客解决方案并将其粘贴在这里，因为我不确定我是否想要/有时间来维护它。它扩展Figure类（在下面添加文本）并滥用download_reference节点。它还以未记录的方式覆盖app.add_node方法（伯金菲尔德应该命名的set_node）

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

您仍然需要在模板中添加 jQuery 和FancyBox。

享受

http://pastebin.com/pMhKnTkv

用法：

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

Answer 3

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

此外，您可以通过修改模板以包含您最喜欢的 javascript lightbox-y 图像查看器来做类似的事情，尽管这不会处理生成缩略图。