Tree


.gitignorecommits | blame
.rustfmt.tomlcommits | blame
LICENSEcommits | blame
Makefilecommits | blame
README.mdcommits | blame
kssg.1commits | blame
kssg.rscommits | 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.