While working on a couple of Hugo themes over the weekend, I remembered how completely baffled I was, when I first started working with Hugo, by how exactly a theme was put together and how all those bits and fragments of template files and template code worked.
So I thought I'd put together the most basic functional Hugo theme I could come up with, which still demoed the things I remember being confused by when I started out:
- A custom homepage
- Static page[s]
- Posts organised under a separate 'Blog' section
- Filtering pages by tag
- Using some basic template code like variables, loops, if...else
I've also commented everything I could think of in the code. So [hopefully!] it'll start to make some kind of sense, as you poke through it.
I'm not really sure if this is a worthwhile venture yet. Reading the posts here, I get the feeling that most folks who visit these forums are already pretty knowledgeable. But, on the off-chance some of you are feeling as befuddled as I was, when I started out, here is Hugo Skeleton Site for your tinkering pleasure:
[BTW: I'm aware that there are certain things I've not done in the most ideal 'Hugo way', but sometimes I had to be a bit inefficient to keep things as simple as possible. I'm also still learning myself, so there may well be idiocies included free of charge too]
Comments, criticisms, corrections, etc. to the usual address.