You learn through experience. First do something and see it does not work and then throw it away – or you read along here, to avoid configuring jekyll plugins, that simply are not allowed to be run within GitHub pages.

You can find all allowed plugins within the Pages gem. To be precise, you will find the whitelist of allowed Jekyll plugins here: See all GitHub Pages approved jekyll plugins.

It appears to be a lot of work for the GitHub security team, to add more gems here, since they all have to be checked on every version bump. So keep yourself happy and just restrict yourself to those plugins, if you want to host your page on GitHub pages.

Jekyll is a great static site generator, with a great ecosystem of plugins to create almost all you need. But since every plugin is handling things a wee bit different, sometimes the results are not consistent throughout the page.

Since we always want to render nice canonical URLs with no unnecessary index.html files, I figured having a nice liquid plugin is the best choice, since the current Jekyll pagination plugin is always putting an index.html at the end with no (apparent) way to strip it away.

But since there are plugins for almost every usecase, I found this nice liquid filter plugin for beautifying URLs. Simply copy that code into the _plugins dir and use it like this:

<meta property="og:url" content="https://til.jaz-lounge.com/jekyll/jekyll-beautify-urls" />