Jekyll Collections are amazing. They allow you to create different types of content beyond the traditional blog post. You can create collections of people, items on a todo list, anything. This feature was the tipping point that made me use Jekyll for this site over a dynamic database driven CMS like Drupal. This article will show you how to use collections by example, from the basics to advanced techniques.
I use collections all over this site. In the Voices in Colour section each voice is an item in a ‘voices’ collection. Each item in the collection is a YAML file with keys and values:
This file can be called anything and is put in the collections folder, in my case called
You then print out the items in the collection with:
_config.yml the final configuration that glues it all together is:
This tells Jekyll to look in the
_voices folder and exposes the collections as the
Pretty nifty yeah? You can make almost anything with these simple building blocks.
You can filter collections by a key in the YAML file. Here my key is
type and my value is
Then loop through the resulting filtered array like you would any other.
A collection can have nested keys and values. The structure is like this:
Here each voice has many “modes”. By using dashes we can store multiple items inside a key. Each item has a key and a value. You output the values with the usual for loop on the desired page:
Currently all collections have to be in the root of your Jekyll site. I have 6 collections on this site and the top level folder can start to get messy. One day you’ll be able to put them into a
A stop gap solution is to move the site building folders of Jekyll to a sub directory instead. In your
Or you can put all your ‘source’ files into a subfolder:
Well there you have it! Collections are a great way to manage different types of content on your site. Who needs a CMS?