mkws

Quickstart

On a Linux machine, in a terminal:

curl -so -  https://mkws.sh/mkws@4.0.16.tgz | tar -xzvf -
mv ws.sh example.com && cd example.com
echo "hello, world" > index.upphtml
bin/mkws https://example.com

Binaries for OpenBSD also available

Features

• Small Just 31 lines of sh and 400 lines of C!
• Powerful Uses sh code as a templating laguage!
• ️Extensible Can use any UNIX utility in its templates!
• Zero Config Script your static site generator instead of configuring it!
• No package manager Just download and start hacking!
• Optional JS Add JS to your project only if you prefer!

Built with mkws

What people are saying

• [...]i am a HUGE fan of mkws![...]

• mkws is a very pleasant surprise! I migrated from Hugo, because I wanted something simple, straightforward and minimal. And boy, do I love this!😁Thanks for building it! 🙏

• sh as static site generator? Turns out you can create a decent static site generator with basic Linux commands and a couple lines of code. Impressive.

• Finished playing around with mkws. Nice generator. Fast and easy to use. I even managed to get markdown integration.

• Looks super cool thanks!! I’ll check it out.

• mkws looks really interesting, I'll check it out :D

• Finally started playing around with mkws, @adi@twtxt.net! Lots of fun! :-)

• I can’t express how happy I am to have a decent shell SSG. You are now truly one of my heroes.

• hmm cool

• very cool

• mkws is to be considered a proof-of-concept

• The best parts of mkws are the simplicity and the ability to tweak the script for your use case. Putting everything in one binary or adding a bunch of extra features like a web server would add unnecessary complication.

• mkws for mine is both small and minimal, but not remotely limiting, and packs a punch because sh works surprisingly well as a templating language.

• mkws uses shell scripting as templating, which is not a syntactic improvement

• Love the idea of mkws! Together with a class-less CSS lib like new.css this seems like a great way to get some content online fast and efficiently.

• Wow, such simple yet useful idea. Great job! yes [...]I’d like to have it packaged for Void Linux[...] :)

• [...]great work [...]! I was looking for something as simple and extensible as mkws, after trying other static site generators like hugo, zola, ... often great but too difficult to customize

• I like the general idea. The more I think about it, shell script is sort of a natural fit for templating.[...]Your code is great. It's very concise and only does what it needs to do.

• All kinds of nope. Dynamic typing being the preference of web devs is bad, but stringly typed is insanely worse.

• Wrong tool for the job. Edit: looks like this entire thread came to the same conclusion

• What the fuck? Is that supposed to be a feature?

• Could it be that you misspelled "nanoc"?

🏅Contributors

🎁How to contribute

Make a web site 😉 and send a link to adi@tilde.institute!

You can also sponsor me:

• https://revolut.me/adrianh6s (preferred)
• https://paypal.me/adrianemilgrigore
• XMR:
  
  87PobXAC54BHuqXVPLms6UAT7xpBWBUWic41KTF2Ki9QbHQzanH66xzTf2UrZuiAD6H9K14nHW7LcdYjjHg7epQLEKTnLPP
• BTC:
  
  1NgWZ6aH1xZd2CuEZmAEM9ikA8h4mzkFT