Skip to content

2025

A small update

This time I have set out to achieve two small things. I wanted my blog to feel a little bit more personal with a logo and favicon and on the rare occasion where I would like to share a link to this page, I would like to see those nice looking "cards" with title, short excerpt and picture, not an error message about some Open Graph info missing. Yes, I've learned today that Open Graph exists.

I fixed both things. I will, full of shame, admit that I have used an LLM to generate a basic icon/logo which I touched up in GIMP. The generation process was frustrating, though. The "AI" spat out unappealing graphics most of the time. You could immediately tell it was generated, be it style or plain retardation of the imagery.. Was it faster or better than just using an existing design from an icon pack? I am not sure, but no time savings were made.

My second issue was resolved by activating the social plugin and modifying the pipeline to install additional dependencies before building the site. After adding the site_description social cards started appearing properly when linking to my site. What I am missing from the mkdocs-material documentation is a clear indication where I need to put the Open Graph meta information for all pages inside my project. In posts I just yolo'd it and put description: beneath date:, but setting this manually for every blog post is not sustainable in the long run.

There probably is an automated way to make the description be the first paragraph of the post. I just haven't found it yet.

First milestone

Today marks a small but important milestone. The site got published!

I have set up repository mirroring and use GitHub Pages to serve it on my custom domain. I had to create the CNAME file inside my docs_dir for it to work, but it was all described in the documentation.

If for some reason GitHub goes down, the site is also published to GitLab Pages at random-string.gitlab.io. I can easily point my domain overe there if needed.

A few days later

I forgot how to git already. Getting back into my blog project took some time and a lot of willpower. I used a few evenings figuring out a new way for backups. I have learned how to manage BTRFS subvolumes and set-up automatic snapshots of /home and /mnt/dane.

In the future I plan to move my server's partitions from XFS to BTRFS and take advantage of send/receive.

The beginning

Today I have managed to set up a repository and started working with git. I still have to wrap my head around branching. The next challenge will be putting this site on GitHub Pages. Later on I want to automate the deployment process in GitLab. Am I mad? Perhaps, but I will learn a lot. Or so I hope..