Hacker News new | ask | show | jobs
by Teichopsia 2482 days ago
Recently I looked into the landscape to see what I felt comfortable with.

tl;dr: I ended up using eleventy with tailwindcss.

It depends what you are comfortable with...

There are a few blogging sites (their names escape me at the moment but are similar to https://write.as) that seemed interesting. Again, I did a quick search but couldn't find the one I had in mind.

My preference is python, so naturally I looked there first. I can't remember what happened to pelican, why I didn't go for it. Nikola seemed nice until I started reading the documentation. I also looked at some that were further down static gens list. But something was missing.

Jekyll has great documentation, but there are a lot of moving pieces. You can make it into a full fledge website that has a blog, or make it into a blog - quite easily. It seems that whoever states that Jekyll is geared towards creating a blog..... who knows why?!

Played around with Hugo last year and meh...

Now, I don't know how much looking into different ssg influenced the ease it was to pick up eleventy, but it just made sense. It's a bare bones static site generator that - just works. There are several blog posts that will get you up and running quickly. There are several skeleton GitHub repos, some use tailwindCSS, some have netlify Cms already configured, some are plain. Or you can just build your own.

Another I picked it, which is on a personal level. Since it's such a well structured, bare-bone project, its helping me learn/practice JavaScript and it's ecosystem. npm scripts is all you need.

All the other tools, gatsby, etc - are great if you already understand react. And even if you don't but are interested - I got the impression (gatsby at least) that it's documentation was good and you could learn a great deal about react going through it. Maybe, I don't know.

Finally... I feel that some projects could do with an overhaul, at least with their documentation. Some parts felt like an afterthought instead of one cohesive, linear explanation. Not an easy task in the least, but what is?

But more importantly, pick one thing and stick to it (unless it proves to be hindering productivity).