Skip to content

Guide

Create a custom (sub-)domain for your MC Server

I'm in the process of creating a Minecraft Server. And at one point in that process did I had to setup a custom subdomain for it.
Since I was not running a server for such a long time did I had to look up tutorials, bud sadly, these tutorials either didn't explain how you set up a DNS entry with Cloudflare, showed outdated pictures and info on Cloudflare or explained it so poorly, that it didn't help.

So after figuring it out did I now decide to create my own quick guide to explain things. Enjoy.


Add Share buttons to your Blog

One feature that is currently missing from the Material for MkDocs Blog plugin1 are share buttons that would allow your readers to share your blog post on Social media platforms.
This guide will show you how you can implement this yourself!


Integrate Gitea/Forgejo Stats into Material for MkDocs

One core feature of Material for MkDocs1 is the display of statistics of a linked repository, such as latest release, fork count and star count.
However, this feature is limited to GitHub2 and GitLab3 repositories and other repositories cannot be added the same way as these two.

A prime example is trying to add statistics from a Gitea4 or Forgejo5 hosted repository, which requires some extra steps to be done here. And this post will explain how!


How to add the fediverse:creator meta tag for blog posts in MkDocs

Mastodon 4.3 added a feature, where links to sites can display an author affilialtion, linking to a Mastodon account associated with that site.
This feature works through the usage of a meta HTML tag containing a specific name and content value.

This small blog post explains how you can add this tag to Blog posts of your MkDocs site.


How to use JDA-Utilities' EventWaiter

If you're developing a bot with JDA1, changes are high that you want to implement a system where your bot is waiting for an input from the user after performing a command or action.
Doing this in JDA can be a bit tedious, especially if you want it to do things such as having the action expire after no input for a while. This is where JDA-Utilities2 comes into play. And this is where this blog post will explain how to use it and especially its EventWaiter functionality.


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.