kewt

Pronounced "cute"

Go to the repo

kewt is a minimalist ssg inspired by werc and kew

It's meant to be a static site generator, like kew but use only default (POSIX) tooling, like werc (and definitely unlike kew)

Features

No dependencies
Supports many embed types
Automatic css variable replacement for older browsers
Automatic inlining and embedding of many filetypes with \![link] or \![alt](link)
Inline html support
MFM $font and \<plain> tags
Admonition support (that's what the blocks like the warning block below are called)

If you want to force a file to be inlined, use \!![] instead of \![]

Usage

./kewt.sh --help
./kewt.sh --new [title]
./kewt.sh --from <src> --to <out>
./kewt.sh [src] [out]

--new [title] creates a new site directory with a copied site.conf and a default index.md.

site.conf

title = "kewt"
style = "kewt"
dir_indexes = true
single_file_index = true
flatten = false
order = ""
home_name = "Home"
show_home_in_nav = true
footer = "made with <a href="https://kewt.krzak.org">kewt</a>"
logo = ""
display_logo = false
display_title = true
logo_as_favicon = true
favicon = ""

title site title
style style file name from ./styles (without .css)
dir_indexes generate directory index pages when missing index.md
single_file_index if a directory has one markdown file and no index.md, use that file as index.html
flatten flatten sidebar directory levels
order comma separated file/directory name list to order the sidebar (alphabetical by default)
home_name text for the home link in navigation (default: "Home")
show_home_in_nav show home link in navigation (default: true)
footer footer html/text shown at the bottom of pages
logo logo image path (used in header if enabled)
display_logo show logo in header
display_title show title text in header
logo_as_favicon use logo as favicon
favicon explicit favicon path (used when logo_as_favicon is false or no logo is set)

Ignores

.kewtignore: Files/directories to ignore. If empty, the whole directory gets ignored
.kewthide: Files/directories to hide from navigation but still process. Same empty rules as with ignore
.kewtpreserve: Files/directories to copy but not convert markdown to html. Same empty rules again

Embeds

\![link]:
- local image/audio/video files are embedded as media tags
- local text/code files are inlined directly
- global image/audio/video links are embedded as media tags
- other global links are embedded as <iframe>
\![alt](link) works the same, with alt used for images
\!![] and \!![alt](link) force inline local file contents

Credits

Markdown to html conversion based on markdown.bash by chadbraunduin
Default css style and html template based on kew by uint23

![WARNING] Most of this was coded at night, while sleepy and a bit sick, and after walking for about 4 hours around a forest, so...

3.3 KiB Raw Blame History