Skip to content

Guide

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.

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!

How to use Mastodon

Elon Musk has bought Twitter for an incredible amount of money and has since started to destroy it left, right and center. Employees got fired or resigned, verified accounts lost their iconic blue checkmark and received a grey/transparent "official" badge while the blue checkmark is now something you can buy for $8, and other things I sure can't think of right now.

But all this drama also surfaces some new changes.
Mastodon1 gained a lot of popularity due to the recent events and is currently having around 1.9 million active users on over 6,000 individual servers. People start to move from Twitter to Mastodon as they see the former dying in the forseeable future or at least becoming a less welcoming place for individuals.