Follow

This is the most minimal static site generator without ANY external dependencies! Just install Node.js, Go, Python...

It's hard to not be cynical seeing that the author works at Mircosoft.

@neauoire Yeah I know I'm preaching to the choir here.. After all this time I STILL haven't found a solution that I can easily pass along to others.

@rostiger @neauoire I recently had a need to whip up a very basic home page. Ended up literally writing hte raw HTML for it (that was a throwback). I haven't found a static site generator I'm really happy with ( I tried Jekyll, and... well... https://planet-geek.com/2015/04/06/geekitude/sorry-jekyll-im-done-with-you/ )

@rostiger static site builders for people who don't already have a website with content in the hundreds of pages, is a cumbersome extravagance.

It's best not to pass along the idea that people need site builders in the first place.

@neauoire I have managed to convince people with single pagers to manually edit the HTML code of their website. However this particular case is a small blog with currently around 70 - 100 pages of content. The latest PHP update of the webspace provider broke the whole dang thing to such an extent that I've only been able to fix the frontend so far.

@neauoire I've spent too many hours trying to fix the backend, but eventually gave up in frustration. Can't leave it broken forever though, so now I'm considering switching to something with less dependencies. It just gets more complicated when there are other people involved. :/

@rostiger what format is the content? Is it just stuff in a mysql database, or static html pages?

If you could extract the bodies of the pages, you might be good building a little thing that just adds a header and a footer to those.

@neauoire That's what I'm currently considering. I'm struggling with the layer below though: what are the minimum requirements for someone else to use it? I can't assume that everyone fulfills the build environment requirements (currently considering bash or C), or even that they know how to navigate a terminal. I'd need to provide binaries which gives me a headache just thinking about it... ugh

@rostiger @neauoire My experiences in the field for this: Build and design that stuff for exactly the people that use it (possibly even ask them if they can only do it from one specific computer or have only one person do the deployments etc., it might be an option!), don't overestimate the scope of where it has to run etc., that makes a lot of worries/problems go away. Also don't shy away from using stuff outside the minimalist toolbox if it causes minimal work and maximum pragmatism: e.g. I wrote a windows batch script for an independent library in vienna which triggers the upload of their book catalogue to the server - obviously both windows and batch scripts are outside of my interest or sanity zone haha, but in the end it cost me around 20 minutes to set this up and the person that's doubleclicking it to do the upload every day is still happily served. :)

@freebliss Good point, I'm trying to be more pragmatic for sure. Unfortunately this one has to be use-able by potentially any user with any system configuration. I was quite happy running KirbyCMS until the provider broken it by updating PHP... >:(

@rostiger Any user with any system configuration sounds like a good fit for something interpreter-based to me. Python e.g. comes installed on practically every mac or linux these days, and it's easy to bundle as well if you don't want your windows users to have to install python themselves. Something C-based on the other hand usually turns into a problem if you're targeting any user with any system configuration in a singular purpose/audience project. It's a fascinating space in any case, I'm constantly learning, do let me know what you come up with in the end, I'm curious!

@freebliss Python is quite high on my list because of how widespread it is. I'm currently looking at Pelican, but I'm still wondering how easy that setup would be for someone not on a nix system or with no terminal experience...

@rostiger Pelican also uses "make" somehow doesn't it (possibly an obstacle)? In the last two years or so I've made really good experiences with just writing all generators from scratch (respectively recycling and iterating on own code from generator #2 onwards) but it's also a luxury as it requires time (especially to get into it and build the know-how, maybe not so much once you're into it then). Finding something 3rd party that really sticks to minimalist, long term support attitude is tricky, but fingers crossed you'll find something! Pelican has certainly been around long, so maybe a good candidate, even if not so minimal (as far as i remember).

@freebliss @rostiger for what it’s worth, I have very little contemporary experience with web stuff, but I was able to write a python script that parses a folder of markdown files into cross referenced html and attaches headers and footers with links in an afternoon. If it’s useful I’d be happy to share the code.

@freebliss @rostiger https://gist.github.com/flowb/57975f847f24cac2d040c35a67566deb I started it a couple months ago, but haven’t worked on it in a bit. The markdown library that it uses can be installed via pip, but I didn’t get the impression that you would need that.

@rostiger
run that stack in a container and continue with more pleasuring projects. 😉
@neauoire

@rostiger I also seem to recall Ralph S. Engelschall making one with a similar approach. Can't find anything about it.

However, it's weird that this is a thing 30 years after I encountered it.

@rostiger@merveilles.town i guess you have to assume some platform.. you also have to install nix, 9 or windows or whatever to use site generators that really don't require additional software (make / mk and cat should be suficiente for basic uses on nix)

my generator is at home on 9, but can be used on nix systems using p9p. some of the same code is used to render this proxy output:
https://xj-ix.luxe/gemini/sunshinegardens.org/~xj9/wiki/memex--web/

not perfect, but supporting every possible platform kills simplicity.

@rostiger Well you do need at least one programming language to build the generator, but what's most important is for whom it is, and what is the context. I built several SSG in python because the build step is handled directly by github actions and it's simple for anyone to modify it later.

@thomasorus Chisai is actually high up on my list of potential candidates.The only thing that scares me is also one of its best features: GitHub as a dependency.

@rostiger Well it's only if you want it because it's convenient and gives a pseudo backend CMS for editing. You can just do `python3 src/build.py` locally or on any server and build the website from text files. Be careful about the licence tho!

@thomasorus Nice choice! It's the IndieFund website, so that's a showstopper. 🙃

@rostiger
You know that hugo is just one binary, do you?

If you need a static site generator or not has been discussed already, but if you need one, you should really look at hugo.
Sign in to participate in the conversation
Merveilles

Revel in the marvels of the universe. We are a collective of forward-thinking individuals who strive to better ourselves and our surroundings through constant creation. We express ourselves through music, art, games, and writing. We also put great value in play. A warm welcome to any like-minded people who feel these ideals resonate with them.