Skip to content

2023

How to use Codeberg Pages for MkDocs

Codeberg1 is a Website providing Git Hosting and services for free and open source software, content and projects.
It's managed by a non-profit (Codeberg e.V.) and offers a lot of things, including their own static page hosting Codeberg Pages.

Since I moved my blog to Codeberg Pages a while ago and since I find its set of features quite good did I now decide to make this little tutorial on how you can automate the publishing and updating of your MkDocs Site for Codeberg Pages.

NoTextToSpeech's comparison of Revolt and Matrix

It has been quite a while since the YouTuber NoTextToSpeech made his video regarding more privacy friendly Discord-Alternatives, comparing Revolt and Matrix (or more accurately the element client) with each other.
This video still bothers me to this day and I can't sit here without giving a more in-depth rant on why this video is not only bad, but also clearly biased towards Matrix, while painting Revolt in a bad light.

Set up a Mastodon-based comment system

Recently did I ask in the Material for MkDocs repository1 about how I could implement a Mastodon-based comment system (#5728).
After looking a bit myself did I manage to setup a working version using some blog post on how to do it.

The post giving the code snippet and explaining it was made for Hugo, so some adjustments were required to make it work.
And since there is no post addressing this for MkDocs and the Material for MkDocs theme am I making this post now.

I already posted a Paste2 with some basic instructions, but I feel like a more in-depth explanation was useful to have, so here we are.

Enjoy!

RSS Feed support

I've implemented support for an RSS Feed to my blog using the MkDocs RSS Plugin.

With this, there should also now be automatic posting of these blog posts as new mastodon toots.
This (hopefully) improves and speeds up my process of creating Mastodon toots for comments on my blog.