Programming

17022 readers

240 users here now

Welcome to the main community in programming.dev! Feel free to post anything relating to programming here!

Cross posting is strongly encouraged in the instance. If you feel your post or another person's post makes sense in another community cross post into it.

Hope you enjoy the instance!

Rules

Follow the programming.dev instance rules
Keep content related to programming in some way
If you're posting long videos try to add in some form of tldr for those who don't want to watch videos

Wormhole

Follow the wormhole through a path of communities [email protected]

founded 1 year ago

MODERATORS

[email protected]

Stacks for Simple Static Sites (fd93.me)

submitted 7 months ago by [email protected] to c/[email protected]

20 comments fedilink hide all child comments

Hey, just wanted to drop this here. It's a technical follow-up to The Unreasonable Effectiveness of Static Sites which was reasonably popular, and explains the components of a static site's stack.

you are viewing a single comment's thread
view the rest of the comments

[–] [email protected] 12 points 7 months ago (9 children)

Just last week I decided to try a different tech than I'm used to to run up a site. I did a little research then searched GitHub and found Hugo. I read the Hugo docs, followed their beginners guide and... Didn't get fucking anywhere. Their docs are out of date, the examples are out of date. It looked so promising but my brain works best when referencing examples and when I couldn't even get those to work, well, I don't have time for that these days.

If anyone knows another static site generator with up to date documentation and an easy to run up example please let me know.

[–] [email protected] 7 points 7 months ago* (last edited 7 months ago)

I use Pelican for the site and it's working great. :)

Astro is also popular and will be familiar if you've developed with React before as they support JSX templates.

[–] [email protected] 5 points 7 months ago* (last edited 7 months ago)

Hugo was born out of Google so it has all of the same benefits and drawbacks as every Google project (both internal and external):

Lots of capabilities. You name it, it's a feature.
To support all of those capabilites, there's abstractions for everything -- enough to make you go a little insane if you have to go through the code.
Lacking documentation. Nobody gets promoted for writing docs, so if you really need to know how that feature works, you have to go through the code.
May be abandoned at any time (but pull requests/CLs are always welcome).

[–] [email protected] 3 points 7 months ago* (last edited 7 months ago)

I use https://quarto.org

Pros: Markdown, easy to use. Docs are very good. Also, despite being a a static site, it comes with fulltext site searching, all done locally, enabled by default:

https://quarto.org/docs/websites/website-search.html

It uses pandoc under the hood, so anything that works with pandoc works there.

Cons: No support for any kind of template engine beyond simple variable replacement, as far as I know.

[–] [email protected] 2 points 7 months ago

11ty is great, especially since it's very BYO in terms of templating languages. (I started with nunjucks until I figured out the magic that is webc.)

[–] [email protected] 2 points 7 months ago

I tried a few. Zola was the only one I got far enough with to actually get my site deployed.

Some of that might be that I learned stuff from my previous failures, but I really feel like the combination of the way it works and the Zola-specific themes are what worked for me.

[–] [email protected] 2 points 7 months ago* (last edited 7 months ago)

I used Astro. It is a start but you can incorporate any us framework you want to.

The Docs are great which is why I used it.

[–] [email protected] 2 points 7 months ago

That's interesting, Hugo is the only SSG I've had luck with so far. I'm kind of stuck on Docusaurus at work and it's a disaster.

On the face of things they're all so simple, but aren't documented well for users new to SSGs, and the build often spits out something unexpected with no way to figure out why.

[–] [email protected] 1 points 7 months ago

Hexo has been working great for me. I found the documentation great as well.

[–] [email protected] 1 points 7 months ago* (last edited 7 months ago)

I use zola for my sites. It's got not as many templates as hugo but my sites don't use templates and I found it very straightforward to use from scratch.