muxup-site VS minimum-viable-hugo

On https://muxup.com/ you should see pastel-coloured randomly drawn 'roguh' highlights for the site title and for the titles of individual articles. If you mouse over, they'll be redrawn while your mouse is hovering. If you're on mobile, you won't see that, and that's fine. It worked just fine on Android (FF or Chrome) and iPhone last time I checked, but do let me know if you're not seeing that.

It's really very simple, just thought the distillation of the 'rough' drawing technique to a couple of dozen lines of code for this use case might be of interest to some.

I can recommend writing a short script to test redirects and cache control are configured as expected for your site - here's mine (health warning: shell script) https://github.com/muxup/muxup-site/blob/main/utils/server_t...

I link to something I've written in a conversation if it's relevant (like this - my blog is https://muxup.com/), and post articles to HN, lobste.rs, or an appropriate subreddit if no-one else does and I think it's relevant to people there.

I've also found that a custom-written generator is surprisingly productive. My own attempt is at https://github.com/muxup/muxup-site/blob/main/build.py and I wrote up a few notes on it here https://muxup.com/2022q3/muxup-implementation-notes#site-gen....

See my implementation notes post for more technical detail (which also links to the site source).

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).