All About the Move to Hugo

feedback@janusworx.com (Mario Jason Braganza) — Fri, 13 May 2022 20:00:00 +0530

I finally got done, moving the blog from Nikola to Hugo today.
I already wrote about why I did it.
These are a few more thoughts about what went into the endeavour; and some colophonesque details.

One, really small hope, is that it will help me learn Go.
The DevOps world that I now seek to enter, speaks Go.
I also, now run two Go programs that are indispensible to me, Hugo and Miniflux.
And being the control freak, that I am, I’d love to tweak them to just how I like it.
Nikola did help learn me Python, after all.

Speaking of Nikola, I’ve used it for close to four years now, until I moved.
I was a refugee from a self hosted Ghost install. ¹
I love it to death.
It’s done all I’ve asked of it … and more.
And it’s been fast and stable all these years.
The community (primarily Chris) have been kind and patient and really helpful.
Chris and Roberto and the rest of the gang, have built something rugged and enduring.

So other than having something fun to do while I was down in the dumps, why did I move to Hugo?
I like to learn by reading.
So other than practicing Go, the best way to learn it would be to read code.
And what better place to read code, than that of the tool I use to write? ²

Another point, is that I probably outgrew what Nikola gave me out of the box, and customizing it (and learning how to) was something that I just couldn’t quite wrap my head around.
While Hugo is probably the same way and its documentation is not quite as structured as Nikola’s, it is pretty popular and I can get answers to what I want to do, really, really quickly. ³
And Hugo has an awesome book, to learn from.

So, how did the move go?

I wrote a tiny bespoke Python script, ⁴ to convert all my Nikola front matter to Hugo front matter.
That took me half a day, but it converted 677 posts, that I was dreading, I’d have to do by hand and would take me weeks.
I wrote another bespoke script to convert some gnarly tags that Hugo choked on.
And just like that, my biggest boulder just fell into place.
That left me free to write a couple of what Hugo calls, Shortcodes, to ease my writing.
I started with shortcode (a custom horizontal rule) and ended up with four! ⁵
I customised the base as well as the theme’s config to make the site look like I wanted it; (from its various options.)
And I added some custom CSS, to have custom horizontal rule and footnote styles, change the look of the links in the menu up top, style my subscribe form, and
Included the beautiful font you are reading this in.

In a word, slow, steady, iterative progress until I was done.

And who and what inspired me and who do I owe gratitude to?

Priyanka Saggu, for egging me on to do this project.
Bhavin Gandhi turned me onto the awesomeness that was Hugo.
Pradyun Gedam for making me green with envy, with his minimalistic blog and the thoughtful touches he made. ⁶
Navendu Pottekkat, whose code, ~~I stole~~ helped me style my subscribe page.
Bjørn Erik Pedersen and Steve Francia and the rest of the gang, for making Hugo
Aditya Telange, for the making the pretty, pretty, little PaperMod theme.
Kushal Das, for sharing my love of typography and beating me to a custom font on his website.
Matthew Butterick, for the gorgeousness, that is Valkyrie. The site originally used the beautiful Charter, but while it looked fetching on Windows and MacOS, it would not render as nicely on Linux machines. ⁷
With Valkyrie, that no longer is the case. I have something beautiful to look at, all day! ⁸
Robin Williams, for teaching me all about CRAP and everthing I know about type and design.

They decided to move their editor away from being purely Markdown. I get why they did it. But it just wasn’t for me. I wanted something simple. ↩︎
sorta kinda, like learning about cars, by looking under the hood of your own car, like in the old days ↩︎
even with something as weird and esoteric as the site refusing to build, because of emacs crapping in the content folder ↩︎
related post coming later … ↩︎
the aforementioned horizontal rule, two to center images and captions and one for my subscription ask at the bottom of the post. ↩︎
Nearly everything I did here, I cribbed from his blog config ↩︎
which ofcourse, is where I spend my entire day. ↩︎
I was hesitant to plonk down the money for Valkyrie. But I forgot all about that, once I saw my words rendered in the font. So, I am chalking this down to an investment. Besides Matthew’s prices are value for money (I’m just a little broke at the moment, hence the quibbling) and his usage license is generous. ↩︎

I Have Now Begun Learning Go!

feedback@janusworx.com (Mario Jason Braganza) — Wed, 20 Apr 2022 15:10:29 +0530

That’s just it for now :) Am learning Go!

Planetgo on Janusworx

All About the Move to Hugo

I Have Now Begun Learning Go!