Did you read the memo?

a minimalistic, self-hosted, micro-blogging engine
by Borjan Tchakaloff

Finally generated

It took me a bit more than two hours of work but I came up with a simple engine. The data is read from a TOML file and spits out more-or-less the HTML I hand wrote.

The real exercise here is to see if a single-file script can do what I want. I mean: no dependencies other than the standard library (Python 3.11 at the moment).

Sunday mornings

Somehow I always end up with tech ideas on Sunday mornings.

Is it because I am “refreshed” after a Saturday focused on chores and family activities? Or maybe it´s the “relaxed” time it takes me to whip up the Sunday breakfast (waffles, pancakes, or crêpes).

I don´t often take much action to follow-up on these ideas. Today is different. Today I am taking notes. Today I am actually doing something else than rambling in my heads. Today it is on paper. (And now digital.)

Revived and published

I have another project I would like to work on and I though it was a perfect opportunity to finally push the "memos" online.

Of course plumbing is a pain: I just spent at least a full hour looking at DNS, NS records, static web hosting, and other unwieldy concepts. I ended up pushing the static files to a repository on SourceHut and using my domain with their hosting for now.

Now onto how to make it easier for me to publish… (Or should I simply spin-up an instance of microblog.pub?)

A first step to improve “reader mode”, a.k.a. metadata

I am a big fan of the "reader mode" in Firefox. It couples a gentle sepia tone with distraction-free content, great for long pieces of text.

It turns out that you don´t want to forget the basic HTML metadata such as author in the page header.

Let´s get ready for the future: with tags

I already planned for a couple of features for a next version. Tags are well recognised in the blogosphere, they are a dynamic free-form of grouping articles together by themes.

Let´s take a sneak peek at what it could look like with the current stylesheet.

Customising pico, a minimal CSS framework for semantics nerds

It´s not only for nerds but the facts speak for themselves: there is a "classless" version that simply styles all basic HTML tags. No additional classes needed.

Now, I am trying to tweak a few things such as aligning the date-stamp to the right.

Exploring (basic) styling

I neither want nor need something complicated. Since the idea is to have a minimal engine to publish byte-sized content every now and then, I want to follow suit with the styling and not spend countless hours trying to get it perfect. It has to be simple, and easy to implement. (Wishful thinking!)

I will certainly look into minimalistic CSS solutions out there. I have almost no skills in that area and I know how painful it is to test and have it right. Been there, done that.

Hand-writing an HTML prototype

After a decade or two, I am back to hand-crafting an HTML page.

Today, I am prototyping the very page of this project: a list of memos. (That is so meta.) It turns out bare HTML is still as easy as pie, styling is the real deal.

Kick-starting a new project: memos!

I like the concept of leaving a log of short entries on a regular basis.

I am not so good at publishing blog posts frequently, somehow the barrier is too high for me.

Let´s try with a shorter form, and also because it´s fun to explore project ideas.

Stand-alone, short, and sweet entries following the idea of micro-blogging, but why follow the arbitrary limit of 136 characters? I will keep them short but that´s because I want to.