Cobalt is nice if you want simple: https://cobalt-org.github.io/

It's not python, but it is a single binary to be off and running.

Thanks for the pointer, I hadn't heard of that one. I'd put it in the same department as "gostatic" as being too minimal, unless you want to build the templates yourself. gostatic allowed me to have tags where from a quick look cobalt does not.

Astro is pretty awesome if you’re ok with TS/JS.

Hugo is really nice once you spend some time learning the templating system and how the variables get set up. It does have a learning curve at first, but I don't find any of the alternatives to be as compelling as hugo once you're up and running.

Hugo is great but the learning curve is madness. I've used it twice with a couple years in-between, and succeeded, but it's very annoying to have 1-3 hours of failure before you see anything useful.

Add theme, follow tutorial, somehow blows up, need to figure out exactly where to put what, round and round then find a tiny wedge that works and just expand that until I have something that does what I need. But once it's set up it's really fast and you can iterate on your pages very nicely. No "tons of imports" that I needed with Jekyll.

WordPress. I hate its guts, but my god does it just work. Or I'm just going to give up and use squarespace or webflow, or something like that. I've got a full time job, managing this is not worth the mental energy it takes to learn all it's quirks.

Lektor is Python based and Just Works, but it is far off the beaten track… https://www.getlektor.com/

I use and love Lektor! Built-in CMS, simple templating system, and a lot of flexibility if you want it (but with a great Quickstart option).

Even as a dummy Product Manager, I've been able to write two plugins[0] for it over the last couple weeks (I'm one of the many laid off folks with a wee bit of extra time), and it's been a joy. Definitely frustrating moments — the docs could be better — but the maintainers have been super kind and helpful. It'd definitely benefit from a larger, more active community. Join us!

[0] Shameless plug: just last night, I wrote about one of those plugins here: https://ft.io/blog/link-preview-images/

Nice work! Good write up.

I use Lektor for when I want extensibility, Zola when I want speed and won't ever need to create plugins.

I found elevently the best of the bunch, as it deals with html and js so no need to spin up extra sdks or builds to get things going.

The docs aren't great either but didn't find them as cryptic as Hugo docs.

Hugo is very opinionated. But that opinion it has isn't very well communicated, and I myself don't think I fully understand it enough to write docs on it.

Hugo has opinions on where files should be, how it should be transformed into pages. How those pages should be organized (ie: Taxonomies), and how users and template writers should be able to customize these elements to generate very different web pages.

------------

I do wonder if "Document Hugo" is the wrong approach, but instead the proper thing that needs to happen is "Create Beginner-Hugo-Template" and document that instead.

Then, "Create Intemediate-Hugo-Template" and document how various things you add to these Templates can improve a blog, or book, or various different webpage "ideas".

This past weekend I spent most of a day playing with various simple SSGs with the target of migrating my Hugo blog to something simpler. This was after I spent a couple hours in Hugo trying to generate a page with just simple links to all the blog posts.

My favorite was Hexo: Reasonably simple, default setup looked good. I wrote a larger (but still mini) review of Hexo, gostatic, and Zola: https://linsomniac.gitlab.io/post/2023-02-26-simple_static_s...

Years ago I rewrote our entire company website, including hundreds of blog posts an articles, as well as marketing stuff, in Pelican in a day or two.

When I set up my Hugo site originally, I think I spent some time munging around and eventually got it to work, but that was years ago and everything I learned is lost. So I need something dead simple. But not, unfortunately, so minimal as gostatic.

I like Sphinx [0] with the MyST Markdown syntax [1]. There is a related project, Myst NB [2], which enables including Jupyter notebooks in your site. There is also a plugin for blogging [3].

[0]: https://www.sphinx-doc.org [1]: https://myst-parser.readthedocs.io [2]: https://myst-nb.readthedocs.io [3]: https://ablog.readthedocs.io