mishareyzlin.com VS minimum-viable-hugo

You can iterate over files and collect them into a map from paths to contents and use a 2kb snarkdown if you need markdown parsing. Here’s mine (I use both files and a content.json file for the contents):

https://github.com/gryzzly/mishareyzlin.com/blob/main/build....

Hugo comes out of the box with headers and footers, but you'll probably want to grep around a bit before you understand them fully. I can still recommend my https://github.com/Siilikuin/minimum-viable-hugo as a decent way to get started with a "gears first" approach to Hugo, even though recent developments have made it a bit outdated (in a good way!).

I like Hugo a lot, personally.

If you want to go as minimal as possible, my https://github.com/Siilikuin/minimum-viable-hugo gets you set up with a single no-CSS, no-JS HTML page. I found this pretty ideal for staying to learn the platform.

I like Hugo. It's been a gateway drug into building more interesting websites than just a blog for me. Giving you RSS feeds out of the box is a lovely bonus.

Both my personal website https://andrew-quinn.me/ and my TIL site run on Hugo: https://hiandrewquinn.github.io/til-site/

Most recently I used Hugo to create a backup archive of the Finnish broadcast news, plus translations, which was all in all very easy thanks to its i18n support: https://hiandrewquinn.github.io/selkouutiset-archive/

I even gave a presentation at the local university to first year CS students who wanted to get Hugo up and running. It was a big success!

I wrote https://github.com/Siilikuin/minimum-viable-hugo a while back to turn setting it up into a simple copy-and-paste operation. You might get some use out of it.

Hugo's documentation is rather awful hence explanations like https://github.com/Siilikuin/minimum-viable-hugo or https://dabase.com/e/04066/ I found this course to be a thorough explanation of the required templates, how to style etc. (where CSS and the whole frontend have stayed mysterious to me for years).