adumh00man/blog
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Update Blog “2026-09-22-how-this-works”

Browse Source
This commit is contained in:
adumh00man
2026-09-22 18:43:31 +00:00
parent 936d89398c
commit 78fdeb5433
1 changed files with 11 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files

12
content/blog/2026-09-22-how-this-works.md
View File

@@ -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, 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