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.jpg
for thumbnail and lightbox{{< figure src="thumb.jpg" link="image.jpg" >}}
will usethumb.jpg
for thumbnail andimage.jpg
for lightbox{{< figure thumb="-small" link="image.jpg" >}}
will useimage-small.jpg
for thumbnail andimage.jpg
for lightbox- All the features/parameters of Hugo’s built-in
figure
shortcode 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
Get the latest from Planet Easy Peasy
Make a donation
Donations help me cover infrastructure costs and supplement my 9-to-5 job.
Thank you for your kindness!