How to sort categories alphabetically with Jekyll
When I created my blog using Jekyll, I forked the Tale theme, but I have since customized it to fit my needs. Among other things, I added a categories page. Jekyll provides support for displaying categories, but it doesn’t sort them alphabetically. For instance, as of the date of this post, my categories are Books, Documentation, GitHub, Lessons, Life, and Writing. When I initially used the code that Jekyll provided, GitHub ended up at the bottom of my categories list because Jekyll sorted my posts (and the categories they belonged to) in ascending order.
While exploring GitHub Gist, I came across Phlow’s Jekyll loop gist that allows me to sort my categories alphabetically or by any other variable. This is why GitHub’s community is amazing. Developers all over the world openly share their code for anyone to use and modify.
How sort categories alphabetically with Jekyll
Note: Everyone has their own way of displaying their categories in the Jekyll themes. This is the method I used based on the theme I forked.
- In the
_pagesfolder, create a file called
- Set the layout, title, and permalink in the front matter.
--- layout: post title: Categories permalink: /categories/ ---
- Paste Phlow’s gist in the body of
Modifying this Jekyll theme is one of my favourite activities. It gives me the chance to learn more about this static site generator and then document what I’ve discovered.