bep / gallerydeluxe

Fast Hugo gallery theme/module suitable for lots of images.
MIT License
146 stars 31 forks source link
gallery hugo hugo-theme

Note 1: See this Gallery Deluxe Starter for a fast route to get this up and running.

Note 2: If you need multiple galleries, see Galleries Deluxe.


A Hugo Module to show a photo gallery. It's very fast/effective, especially if you have lots of images on display.

This theme is what you see on staticbattery.com which, at the time of writing this, scores 100 at Google PageSpeed for both mobile and desktop.

Configuration

The recommended way to add this to your site is to include it as a Hugo Module. See Gallery Deluxe Starter for a starter template. Another example is staticbattery.com.

Params

[params]
    [params.gallerydeluxe]
        # Shuffle the images in the gallery to give the impression of a new gallery each time.
        shuffle = false

        # Reverse the order of the images in the gallery.
        reverse = false

         # Enable Exif data in the gallery.
         # See https://gohugo.io/content-management/image-processing/#exif-data for how to filter tags.
        enable_exif = false

          # Optional watermark file for the large images.
        [params.gallerydeluxe.watermark]
            image = "images/gopher-hero8.png" # relative to /assets
            posx  = "left"                    # one of "left", "center", "right"
            posy  = "bottom"                  # one of "top", "center", "bottom"

If you want full control over how your images gets created, create and adjust a copy of layouts/partials/gallerydeluxe/create-thumbs.html into your own project.

Credits

Credit to Dan Schlosser for the Pig JS library.