Your blog probably doesn’t need a static site generator (opens in new tab)

(zainamro.com)

23 pointsz0a6y ago21 comments

21 comments

If you care about your readers, your site should probably have navigation links, maybe even search and an RSS feed. So now you are talking about editing lots of things by hand or moving to some kind of automation. If you like coding HTML by hand, that's great, do it, but there's also nothing wrong with having some infrastructure to build navigation, indices, etc. HTML is analogous to other markup languages, such as latex or markdown, and has its strengths and weaknesses. There is nothing inherently virtuous about it.

Not trying to be harsh but I feel like the "purist" opinion presented in the article is an affect which can only be expressed about sites unburdened by the presence of or desire for readers.

zainamro6y ago

I agree with you that there really is nothing virtuous about handcrafted HTML, and it's for that same reason that I've spent very little time on it as you can probably tell. Rather, the point of the article is to assert that you don't need another tool, fancy theme or dependency to write and share something online. As for the RSS feed, there is one you can find at https://zainamro.com/feed.xml, which I've also mentioned in the final paragraph. And regarding your point on navigation and search, I've noticed most users naturally find their way around my website without any explicit navigation links. That being said, I have considered adding an "Up" link that takes you to the parent directory which I think may suffice.

JohnFen6y ago

Interesting! I followed pretty much the exact same trajectory on my sites. I started a couple of decades ago with handcrafted HTML, then wrote a couple of my own CMSes, then moved to WordPress, and now I'm back to handcrafted HTML.

Every approach has advantages and disadvantages, but for me, for most of my sites, coming back to plain HTML has truly been a joy.

type06y ago

You could also do plain html but using some good templating language like handlebars or pug, and do on the fly compilation with a few scripts in your preferred language.

JohnFen6y ago

Yes indeed -- and I've played with that before. There's nothing wrong with doing that, but for my needs, just going with plain HTML is easiest.

If these sites needs to be more complex, then I'll likely use a static site generator of some sort. I have two sites that are more complex still, and I use WordPress for them.

1 more reply

actionowl6y ago

How does one handle consistent navigation though? If you make a change it sucks having to update that on every page IMHO.

combatentropy6y ago

I use JavaScript, https://www.combatentropy.com/

The minimalist style of both this writer and me does not sell the concept very hard. But you could attain any look you want, however fancy, just by pasting two lines in the head of each of your static pages: a stylesheet and a script tag.

Then your HTML would consist mainly of the words of your article. JavaScript could insert a header, footer, aside, whatever. To update all your past pages, just update what that one JavaScript file is doing or your stylesheet or both.

type06y ago

Using javascript for navigation is fine and all, but you wouldn't be able to provide good fallback for users who disabled js. Better just use somethiing like nunjucks to extend your html https://mozilla.github.io/nunjucks/

1 more reply

Porthos9K6y ago

It looks like the person behind https://zainamro.com/ can't be bothered to provide a navigation menu on every page, or even a link back to their site's home page, so they'd probably dismiss your question out of hand.

However, if you really want consistent elements on every page, you could probably do the job with m4 and a makefile. You can party like it's 1998[1].

[1] https://web.archive.org/web/20190813130112/https://www.linux...

actionowl6y ago

I use zodiac[1] (awk + make) for that use-case, so I guess I'm already partying like it's 1985! :P

[1] https://github.com/nuex/zodiac

comis6y ago

When I was a kid I remember using Server Side Includes (.shtml) to achieve this. It's how I ran my "blog" before blogs were common.

No clue if anybody still does this, but it worked great in 2001.

type06y ago

If it is a blog though, please make sure to create XML feed (RSS or Atom), I don't consider sites that don't have it as blogs. Again even a simple templating language can do this, you could even run pug in cli mode and produce valid RSS feed.

void_nill6y ago

https://zainamro.com/feed.xml

combatentropy6y ago

Also by the author, about the bloatedness of news sites today, https://zainamro.com/notes/unbearable-news

jart6y ago

I like to divide tools into things that solve difficult computer science problems and ones that are just plain cool, like Jekyll. The latter category is like a drug since you can get lost having fun doing so much stuff without needing to think too deeply with all the rough mental workouts. But that usually isn't rewarding in hindsight. It's better to be attracted to the austere. There's less distraction that way. Although, swearing off the shiny things doesn't necessarily preclude having a more fabulous web design, OP ;)

vhodges6y ago

Best of both worlds? https://soupault.neocities.org/

7532yahoogmail6y ago

Bold! That some bold leadership right there!

tyzerdak6y ago

Try hugo. You need to waste 1 day to build and config it, but then you can make pretty amazing stuff fast

Porthos9K6y ago

I think Zain Amro mentioned Hugo as one of the tools he has used.

j / k navigate · click thread line to collapse

21 comments

scelerat6y ago

Not trying to be harsh but I feel like the "purist" opinion presented in the article is an affect which can only be expressed about sites unburdened by the presence of or desire for readers.

zainamro6y ago

JohnFen6y ago

Every approach has advantages and disadvantages, but for me, for most of my sites, coming back to plain HTML has truly been a joy.

type06y ago

You could also do plain html but using some good templating language like handlebars or pug, and do on the fly compilation with a few scripts in your preferred language.

JohnFen6y ago

Yes indeed -- and I've played with that before. There's nothing wrong with doing that, but for my needs, just going with plain HTML is easiest.

If these sites needs to be more complex, then I'll likely use a static site generator of some sort. I have two sites that are more complex still, and I use WordPress for them.

1 more reply

actionowl6y ago

How does one handle consistent navigation though? If you make a change it sucks having to update that on every page IMHO.

combatentropy6y ago

I use JavaScript, https://www.combatentropy.com/

type06y ago

1 more reply

Porthos9K6y ago

However, if you really want consistent elements on every page, you could probably do the job with m4 and a makefile. You can party like it's 1998[1].

[1] https://web.archive.org/web/20190813130112/https://www.linux...

actionowl6y ago

I use zodiac[1] (awk + make) for that use-case, so I guess I'm already partying like it's 1985! :P

[1] https://github.com/nuex/zodiac

comis6y ago

When I was a kid I remember using Server Side Includes (.shtml) to achieve this. It's how I ran my "blog" before blogs were common.

No clue if anybody still does this, but it worked great in 2001.

type06y ago

void_nill6y ago

https://zainamro.com/feed.xml

combatentropy6y ago

Also by the author, about the bloatedness of news sites today, https://zainamro.com/notes/unbearable-news

jart6y ago

vhodges6y ago

Best of both worlds? https://soupault.neocities.org/

7532yahoogmail6y ago

Bold! That some bold leadership right there!

tyzerdak6y ago

Try hugo. You need to waste 1 day to build and config it, but then you can make pretty amazing stuff fast

Porthos9K6y ago

I think Zain Amro mentioned Hugo as one of the tools he has used.

j / k navigate · click thread line to collapse