From 78fdeb543356e07253853452389c8b8d04a52cec Mon Sep 17 00:00:00 2001 From: adumh00man Date: Tue, 22 Sep 2026 18:43:31 +0000 Subject: [PATCH] =?UTF-8?q?Update=20Blog=20=E2=80=9C2026-09-22-how-this-wo?= =?UTF-8?q?rks=E2=80=9D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- content/blog/2026-09-22-how-this-works.md | 12 +++++++++++- 1 file changed, 11 insertions(+), 1 deletion(-) diff --git a/content/blog/2026-09-22-how-this-works.md b/content/blog/2026-09-22-how-this-works.md index 269fea7..4d8b41e 100644 --- a/content/blog/2026-09-22-how-this-works.md +++ b/content/blog/2026-09-22-how-this-works.md @@ -27,4 +27,14 @@ The concept is simple. Provide it with some kind of git api, and a repo to commi Sveltia, probably written in svelte (not that I checked) is exactly the same project but better. It looks better, it performs better, but it's actually fully opensource with a GPLv3 license and actual documentation. It's the sway to Decap's i3, and in the same way, is supposed to be a drop in replacement. Replace one line in the html file and you've installed it. Did I mention that these kind of CMSs are built from javascript files instead of being actual webpages? Weird. -Sveltia DEFAULTS to dark mode, which means that's the one I'm using forever. I could theme it to be all catppuccin like everything else in my life, but I'm too lazy. There are limits to my joblessness, ok? The way that sveltia works is through a simple config file, defining the frontmatter of different "collections" of markdown files. Collections are just folders, like if you had a blog folder and a project folder. Frontmatter is where you can define stuff like the description and publish date of an article, and whether its a draft or not. If you want to see what I'm on about, look at the source for this site [here]([https://git.voidarc.co.uk/adumh00man/blog](https://git.voidarc.co.uk/adumh00man/blog)) +Sveltia DEFAULTS to dark mode, which means that's the one I'm using forever. I could theme it to be all catppuccin like everything else in my life, but I'm too lazy. There are limits to my joblessness, ok? The way that sveltia works is through a simple config file, defining the frontmatter of different "collections" of markdown files. Collections are just folders, like if you had a blog folder and a project folder. Frontmatter is where you can define stuff like the description and publish date of an article, and whether its a draft or not. If you want to see what I'm on about, look at the source for this site [here]([https://git.voidarc.co.uk/adumh00man/blog]\(https://git.voidarc.co.uk/adumh00man/blog\)). + +Once you have all of your awesome articles, you have to present them to the rest of the world, which is where options broaden a bit. + +## Blog sites are stupid + +There are two halves to a good blog setup. The generator and the theme. The generator is the main limiting choice, and often the most important one. Some generators will support every possible feature of markdown (I would have latex support if I could be bothered to enable it), whilst some generators will only support text, in order to be lighter and faster. I chose the middle of the road newbie option, Hugo, because it was like 3 in the morning and I don't do much critical thinking. + +### Hu-goes there?? + +Bad pun I know. Hugo is written in go and under the Apache 2 license. Open source, good shit. It also has a massive and very active community, having about 90k stars on github. That means there are lots and lots of themes available, but we'll get there. Hugo requires you to run a command in order to rebuild the site, which means