- Description:
- KISS site static generator
- Owner:
- Murilo Ijanc'
- Last Change:
- Clone URL:
ssh://anon@ijanc.org/got.kssg
Commit Briefs
replace cargo with rustc makefile, add manpage, separate site content (main)
remove cargo dependency, compile with rustc via makefile and vendored crates. move source from src/main.rs to kssg.rs. add kssg.1 mandoc manpage. remove example content (site content lives in ijanc.org repo now). add new subcommand, updated frontmatter field, draft visibility in serve, post listing by year, root/ directory support, webring footer, content type detection, watcher re-registration for new dirs.
Branches
Tree
| .gitignore | commits | blame |
| .rustfmt.toml | commits | blame |
| LICENSE | commits | blame |
| Makefile | commits | blame |
| README.md | commits | blame |
| kssg.1 | commits | blame |
| kssg.rs | commits | blame |
| templates/ | |
README.md
kssg - KISS static site generator
==================================
kssg is a minimal static site generator written in Rust.
Requirements
------------
In order to build kssg you need rustc.
Installation
------------
Edit Makefile to match your local setup (kssg is installed into
the /usr/local/bin namespace by default).
Afterwards enter the following command to build and install kssg:
make clean install
To fetch vendored dependencies from crates.io:
make vendor
Running kssg
------------
Build your site:
kssg build
Start the development server with live reload (drafts are visible):
kssg serve
Create a new post:
kssg new "Post title"
Configuration
-------------
The configuration of kssg is done by editing the template
in templates/base.html and (re)building the site. There is no
configuration file.
Content lives in content/ as Markdown files with YAML frontmatter:
---
title: Post title
date: 2026-04-07
description: Short description
draft: false
---
# Content here
Directory structure
-------------------
content/ Markdown source files
templates/ HTML templates
static/ Static assets (copied to public/static/)
root/ Files copied to the root of public/
public/ Generated output
vendor/ Vendored Rust dependencies
Download
--------
got clone ssh://anon@ijanc.org/kssg
git clone https://git.ijanc.org/kssg.git
License
-------
ISC — see LICENSE.