Beautiful Hugo adds a few custom shortcodes created by Li-Wen Yip and Gert-Jan van den Berg for making galleries with PhotoSwipe .
Example
The above gallery was created using the following shortcodes:
{{< gallery caption-effect="fade" >}}
{{< figure thumb="-thumb" link="/img/hexagon.jpg" >}}
{{< figure thumb="-thumb" link="/img/sphere.jpg" caption="Sphere" >}}
{{< figure thumb="-thumb" link="/img/triangle.jpg" caption="Triangle" alt="This is a long comment about a triangle" >}}
{{< /gallery >}}
Usage
For full details please see the hugo-easy-gallery GitHub page. Basic usages from above are:
- Create a gallery with open and close tags
{{< gallery >}}and{{< /gallery >}} {{< figure src="image.jpg" >}}will useimage.jpgfor thumbnail and lightbox{{< figure src="thumb.jpg" link="image.jpg" >}}will usethumb.jpgfor thumbnail andimage.jpgfor lightbox{{< figure thumb="-small" link="image.jpg" >}}will useimage-small.jpgfor thumbnail andimage.jpgfor lightbox- All the features/parameters of Hugo’s built-in
figureshortcode work as normal, i.e. src, link, title, caption, class, attr (attribution), attrlink, alt {{< gallery caption-effect="fade" >}}will fade in captions for all figures in this gallery instead of the default slide-up behavior- Many gallery styles for captions and hover effects exist; view the hugo-easy-gallery GitHub for all options
- Note that this theme will load the photoswipe gallery theme and scripts by default, no need to load photoswipe on your individual pages