UNK is an experiment in minimalism. It is a templating static site generator with an included markup language that all fits within 1000 bytes. There are three main scripts:
You are, of course, free to make the template file as large and involved as you like, but it's pretty good already:
S/s.cssif it exists
<title>, and a
<h1>in the generated HTML
To install UNK, simply clone this repo and put it where you want it. The default TM needs LHT to be in the same directory as it, so keep that in mind.
To run UNK, just
cd into your cloned repo and run
It's just a POSIX shell script.
UNK takes a set of files in a directory, applies a template to them,
and output them into another directory as HTML files ready for a server.
To keep a very small size, UNK delegates most file processing to TM,
the main template. It delegates by using an idea found in
each input file is read as a
heredoc, which enables
So the template, as opposed to the engine,
can do all the heavy-lifting of index generation and navigation and such.
Content goes into the following (hard-coded) directories:
rsyncing to a server.
If there is no TM in the directory where UNK is run,
one will be created that will simply
cat the file being processed.
The following variable is made available to TM:
as well as these functions:
shabstand-in. It is much simpler than
shab, and will fail if the template (or if it nests templates, one of the nested ones) has a
ZZon a line by itself, due to its
and these aliases (though they're more an artefact of saving space in the script, but they can be used in templates):
As mentioned above, templates can be nested. Simply call another template from TM with the X function.
LHT stands for Less HyperText,
because that's what you're writing when you're writing it
(though not much less than HTML).
blank lines are interpreted as
<p> tag breaks,
unless the previous source paragraph started with
< and ended with
It also has support for three inline spans:
Everything else is just HTML.
This means that a valid
.lh file is almost a valid
except where it nests HTML and Markdown
(so it's not really, but you can run it through Markdown in a pinch
and get the basic idea across.
This file, for example, is both
(they're just symlinked to each other),
so it's got some weirdness to keep things compatible between Markdown and LHT.
But if you're just writing for LHT, it can be much simpler.).
LHT was inspired, in part, by Writing HTML in HTML by John Ankarstrom, as well as some other articles I can't think of right now. I liked the idea, but some tags in HTML are just annoying to write over and over, and take me out of the flow of writing prose. So I fixed those few tags. The inline tags are definitely subject to change.
I was bored and decided I'd try to write a static site generator that could fit in a toot (500 characters). I wrote a few of them, making them smaller and smaller each time. By the end, I was left with a tiny script that delegated almost all the work to the template file. That script became UNK in this repo.
I was feeling pretty high on my horse after writing the tiny SSG,
so I thought,
I could try for a tootable Markdown converter next —
boy, was I wrong about that.
Markdown is way too complicated to fit in 500 bytes.
So I just wrote the Really Important Parts:
and some inlines.
Copyright © 2019 Case Duckworth <firstname.lastname@example.org>.
This work is free. You can redistribute it and/or modify it under the terms of the Do What The Fuck You Want To Public License, Version 2, as published by Sam Hocevar. See the LICENSE file for more details.
I was going to go with a stricter license like the GPL, but realized that
To contribute to this project, head over to its GitHub mirror and send me a pull request or issue. One of these days, I'm sure I'll figure out sr.ht's mailing lists,