Moving to Hugo
The house of cards was just a little too brittle
As a far too occaisional blogger the thing about your blog is that it has to require minimal work to maintain. With Jekyll that's mostly been true. As I host on github pages I can easily merge in the occasional dependabot alert and for the most part it does what I need. However the one wrinkle is that as an emacs user I prefer org as my text file format. Markdown's good. Org mode is better. In order to facilitate that I've used the package org2jekyll. So I wrote org files, ran org2jekyll's publish and it spat out HTML for Jekyll. Easy 😄. The problem I eventually ran into was that org2jekyll has a configuration that is relatively complex. And eventually one update too many upset the apple cart and caused a bug in org2jekyll that stopped it working.
Is there another way?
So I had two options, lean enough emacs LISP to debug the issue or see if there was an alternative. I'd heard a few people discuss Hugo. After a quick look I got very excited, native support for org files. Pretty much a killer feature right there. So I decided to see if I could convert the blog to Hugo. And I could, and it was quick.
The basic action was to run a
hugo import
. Cracking outcome. Working Hugo blog in under a minute with my old blog posts all intact. But they're HTML files. So could I convert them to the org source files? Yes again. I moved the org file from static/org to content and there I had it. i did need to tweak a couple of things:- The format of dates with times is a little off. Your options are to remove the timestamp or remove the spaces and add a separator of
T
between your data and time. I also added the timezone by adding+11:00
to the end of the time. - I needed to reintegrate utterances as my comment engine
#+TAGS:
became#+TAGS[]:
- A bunch of the front matter became redundant as it was for org2jekyll
- I needed a github action to publish my blog
- The format of dates with times is a little off. Your options are to remove the timestamp or remove the spaces and add a separator of
Thanks
I think I owe a debt of gratitude to ardumont for org2jekyll and to the Jekyll community in general. But so far I'm happy with the move.