22 Jun 2024

Switched from Jekyll to Bridgetown

Category updates
Tags #dev #tools

Long story short, - I’ve decided to switch from Jekyll to Bridgetown. First of all I have enough with Jekyll, I am using it for about 10 years, and its became stiff to change. Last time I’ve tried to do something new with Jekyll I got struggle with simple tasks, maybe I do something wrongway (highly unlikely) but I have no patience to continue with Jekyll and research too much to solve simple things which can be written from scratch in about hour.

I’ve started to looking for substituion and came across Bridgetown.rb in about 2 minutes of searching.

So here it is Bridgetown.rb - So it is not only static site generator, its feature rich lightweight framework, which allow you to generate your site statically. It uses Puma as sever, Roda as main routing library. It is also utilizes tools like Rake, and it has integrated deployment feature. All of it makes bridgetownrb highly customizable, friendly to programmers solution for “fast and hacky” projects.


How to migrate from Jekyll

So how to migrate ? FrontMatter is a small YAML snippet with metadata for each post on top of the post. It is the same format as Jekyll, Hugo, and many others. All you need to do is copy all posts into the _posts directory.

And because of this YAML snippet on top of the post file, Bridgetown generator will understand everthing and generate same structure as I have in Jekyll

layout: post
title: "Switched from Jekyll to Bridgetown"
categories: howto
tags: [dev]
date:   2024-06-22 12:00:00 +0000

As you might have noticed earlier, I have a photography gallery on the site, so I have to migrate it from Jekyll too. Previously, I utilized gallery generation code that I wrote (which I may share if you want to). Migrating the gallery to Bridgetown took about an hour to implement using plain Ruby, similar to what I had in Jekyll.

Bridgetown even have more detailed guide to migraion from Jekyll

For the comments I am still using isso-comments. I had jekyll-mail-comments, but didn’t migrate it yet, will rewrite it for bridgetownrb soon.

I also love Makefile so I do a little file for working with bridgetown commands and deployment to gh-pages without github actions as it offers official Bridgetown way of deployment to gh-pages.

Thats it for now, if you’re interested in details let me know in the comment section below.