Site transitioned from Jekyll to 11ty

3 minute read

After numerous hours / days of hacking (much more than I care to admit), I have moved the blog from Jekyll to the static site generator 11ty. All the while maintaining using the Jekyll theme Minimal Mistakes Theme.

TIP: Unless you are wed to the theme, don't try porting it. Really. Headaches await. 🤯

There was a surprising amount of hacking needed to get the liquid calls to work properly. The main issue is that main of the required variables don't contain the data expected by Minimal Mistakes. So this mean debugging to find what is where. For instance the post variable doesn't contain a posts title, that is usually a global variable. (Same with many others) HOWEVER, there are instances where the title might actually be in a passed in variable at, or for the RSS feed file.

Not everything is in place; specifically site search is currently disabled as is the archive of posts by year, and finally comments aren't working though in theory they should (they had also stopped working on the Jekyll version of the site). All will be returned at some point.

All that said, despite the change to keep the theme ... I will ultimately be moving away from it. While I like it, I can't easily do some of the things I'd like to do and going my own way will be a way to hopefully show my improving HTML/CSS/JS skills.

Also todo: add mappings from old urls to new. Most are the same, but a handful have been fixed to remove a space.

Before I finish I should give some thanks / hat tips so various blog posts / git hub repos for bits I've cribbed.

First and foremost is a blog / repo by Quinn Dombrowski. Her post was what led me to realise that I could actually get Minimal Mistakes theme running on 11ty. I spent a little time with her blog repo, initially mostly going through the steps to get it to build with 11ty 1.0.x or 2.0.0beta1.

Once I got it building, I started trying to port Minimal Mistakes myself, only cribbing bits out of .eleventy.js. I figured the best way to understand how it was to work with 11ty was to do the changes to the templates myself. Although in the end I did wholesale rip Quinn's code for pagination on the front page because I couldn't get the original paginatior code to work.

Also of use was in no particular order:

I'm sure there might be something else I'm forgetting, and I will update the post if I remember.

Tags: , ,



Leave a comment