`mkws`

simple static site generator

Quickstart

On a Linux machine, in a terminal:


curl mkws.sh
| tar -xzvf -


mv ws.sh example.com && cd example.com


echo "hello, world" > index.upphtml


bin/mkws https://example.com

News

5.0.0 - 2022-10-13

Changed

inline CSS by default in theme layouts
uppercase exported variable names in bin/mkws
add s.uppcss to man page
prefer braces around variables
don't mask return values

Full Changelog

Binaries for OpenBSD also available

Read The Full Docs You can also join our IRC channel

Features

Small Just ~30 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!

What people are saying

Thanks for making mkws!

mbucc

That sounds beautiful

BenWibking

OK, super tiny and simple. This looks like a nice alternative for the big ones like Jekyll or Hugo.

ervin

I like it a lot

Dight67

I was just thinking about looking for something like this only a hour ago. I hate front end web dev. I'll be using it for a django project I'm working on if it suits. Thanks.

Arafel

Simple & clean, nice job. I love the description btw: "simple static site generator", no fluff just straight to the point lol.

jmbenfield

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

j3s

Pretty cool! Never realized I could use single quotes in HTML.

Apos

This is super cool! It looks like it'd be great to tie in with some of my existing scripts.

vord

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! 🙏

cibiliciceanu

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.

Raphael_A_Bauer

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

carsten

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

kiraemclean

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

oxalorg

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

jlj

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

lohn

hmm cool

hrcerq

very cool

pekman

mkws is to be considered a proof-of-concept

eklausmeier

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.

mckinley

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.

eldersnake

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

proycon

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.

citizen428

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

teddydd

[...]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

morgangeek

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.

tomolt