How to Install and Customize Hugo Easy Gallery

Hongtao Hao / 2021-05-16

Thanks to Li-Wen Yip ’s hugo-easy-gallery , it’s relatively easy to create galleries inside a hugo post.

Please follow the instructions regarding Installation and Theme integration .

For me, I added the codes in Theme integration to layouts/partials/foot_custom.html

  1. figure.html

First, there is something to change in the shortcode of figure.html if you want to add the width parameter when inserting a figure.


<img itemprop="thumbnail" src="{{ $thumb | relURL }}" {{ with .Get "alt" | default (.Get "caption") }}alt="{{.}}"{{ end }}/>


<img itemprop="thumbnail" {{ with .Get "width" }}width="{{.}}"{{ end }} src="{{ $thumb | relURL }}" {{ with .Get "alt" | default (.Get "caption") }}alt="{{.}}"{{ end }}/>

Basically, we added { with .Get "width" }}width="{{.}}"{{ end }}.

  1. hugo-easy-gallery.css

First, if you want to delete the horizontal line beneath each figure you inserted with the <figure> shortcode, comment out the part of figure a.

Second, if you want change the size of each figure within the gallery, edit @media only screen and (min-width : 480px). Tweak the wdith and padding-bottom parameter. For example, try changing them to 25% and 25%, respectively.

Third, if you want to decrease the white space between figures when you use the <gallery> shortocde, add margin-left and margin-right within .gallery .box {}.

Fourth, if you want the gallery to be fullwidth or simply become wider. Comment out max-width: 768px; within .gallery{} and add

  width: 100vw;
  position: relative;
  left: 50%;
  right: 50%;
  margin-left: -50vw;
  margin-right: -50vw;

Tweak width, margin-left and margin-right as you would like.

Last modified on 2021-05-20