Post: Gallery

1 minute read

These are gallery tests for image wrapped in <figure> elements.

To place a gallery add the necessary YAML Front Matter:

gallery:
  - url: /assets/images/unsplash-gallery-image-1.jpg
    image_path: /assets/images/unsplash-gallery-image-1-th.jpg
    alt: "placeholder image 1"
    title: "Image 1 title caption"
  - url: /assets/images/unsplash-gallery-image-2.jpg
    image_path: /assets/images/unsplash-gallery-image-2-th.jpg
    alt: "placeholder image 2"
    title: "Image 2 title caption"
  - url: /assets/images/unsplash-gallery-image-3.jpg
    image_path: /assets/images/unsplash-gallery-image-3-th.jpg
    alt: "placeholder image 3"
    title: "Image 3 title caption"
  - url: /assets/images/unsplash-gallery-image-4.jpg
    image_path: /assets/images/unsplash-gallery-image-4-th.jpg
    alt: "placeholder image 4"
    title: "Image 4 title caption"

And then drop-in the gallery include — gallery caption is optional.

{% include gallery caption="This is a sample gallery with **Markdown support**." %}
placeholder image 1 placeholder image 2 placeholder image 3 placeholder image 4 placeholder image 5 placeholder image 6 placeholder image 7 placeholder image 8 placeholder image 9 placeholder image 10 placeholder image 11 placeholder image 12
This is a sample gallery with Markdown support.

This is some text after the gallery just to make sure that everything aligns properly.

Here comes another gallery, this time set the id to match 2nd gallery hash in YAML Front Matter.

gallery2:
  - url: https://flic.kr/p/8a6Ven
    image_path: https://farm2.staticflickr.com/1272/4697500467_8294dac099_q.jpg
    alt: "Black and grays with a hint of green"
  - url: https://flic.kr/p/8a738X
    image_path: https://farm5.staticflickr.com/4029/4697523701_249e93ba23_q.jpg
    alt: "Made for open text placement"
  - url: https://flic.kr/p/8a6VXP
    image_path: https://farm5.staticflickr.com/4046/4697502929_72c612c636_q.jpg
    alt: "Fog in the trees"

And place it like so:

{% include gallery id="gallery2" caption="This is a second gallery example with images hosted externally." %}
Black and grays with a hint of green Made for open text placement Fog in the trees
This is a second gallery example with images hosted externally.

And for giggles one more gallery just to make sure this works. To fill page content container add class="full".

placeholder image 2 placeholder image 4
This is a third gallery example with two images and fills the entire content container.

Gallery column layout can be overrided by setting a layout.

{% include gallery id="gallery" layout="half" caption="This is a half gallery layout example." %}
placeholder image 1 placeholder image 2 placeholder image 3 placeholder image 4 placeholder image 5 placeholder image 6 placeholder image 7 placeholder image 8 placeholder image 9 placeholder image 10 placeholder image 11 placeholder image 12
This is a half gallery layout example.