From Octopress to Forever-Jekyll

When I decided to move from Blogger to Octopress back in 2015 I didn’t foresee that Octopress would stop receiving updates that year!

It’s not like I can’t use Octopress 3.0 in 2026, I still can, but I have to use Ruby 2.6 and all its Gems from 11 years ago.

This is some serious technical debt, the list of dependencies includes OpenSSL, which needs to be updated due to security issues. I remember last year building my own Ruby 2.6 with a set of patches just to get Octopress 3.0 compiling.

Looking after a new Jekyll theme can be a daunting task. jekyllrb has a collection of links for Jekyll Theme collections.

I stumbled upon Forever-Jekyll at this reddit post.

I have used Qwen 3.8 27B with llama.qtcreator to migrate my Octopress Blog to Forever-Jekyll.

There were some issues that Qwen addressed:

Octopress Forever-Jekyll
{% coderay %} code highlight Markdown triple tick fenced code blocks
{% blockquote %} Markdown blockquotes
{% img %} Markdown images
:emoji: shortcodes Unicode emoji
No table support GitHub flavored Markdown tables

This makes my life as a blog author much easier, since I can use normal Markdown to write the blog posts!

The new theme came with a Light / Dark button at the bottom right page. This does a bit of CSS magic that inverts the colors on the page except images.

But this affected the emojis in the post. The solution is to exclude the emojis like the images, they need to be wrapped as HTML tags <span class="emoji">Emoji</span>.

Bringing the styling of the old blog to Forever-Jekyll took the bulk of the time of the conversion.

Forever-Jekyll brings these two new features:

KaTeX support

The Pythagorean theorem states that in a right-angled triangle, the square of the hypotenuse is equal to the sum of the squares of the other two sides:

\[a^2 + b^2 = c^2\]

Mermaid support

Here’s a Mermaid class diagram showcasing C++ OOP concepts - inheritance, polymorphism, and a virtual say() method:

classDiagram direction TB class Animal { <<abstract>> #string name +Animal(name) +Animal() +say() void *0* +getName() string } class Dog { +Dog(name) +Dog() +say() void +fetch() void } class Cat { +Cat(name) +Cat() +say() void +purr() void } Animal <|-- Dog : inherits Animal <|-- Cat : inherits Animal ..> Animal : virtual say() enables Dog ..> Animal : overrides say() Cat ..> Animal : overrides say()

The migration was a success! I ❤️ it!


 Date: November 18, 2026
 Tags:  jekyll

Previous:
⏪ From React to Qt Widgets using AI