Ijanc.org git repositories

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.

diff | patch | tree

2 months ago d4e8dba86b Murilo Ijanc

clean public before build, fix series links, add rss, sitemap, meta description, custom 404

diff | patch | tree

2 months ago 5bf6d120ef Murilo Ijanc

add file watcher via inotify and kqueue

diff | patch | tree

More ↓

Branches

6 weeks ago

main

summary | commit briefs | commits

Tree

.gitignore	commits \| blame
.rustfmt.toml	commits \| blame
LICENSE	commits \| blame
Makefile	commits \| blame
README.md	commits \| blame
example/
kssg.1	commits \| blame
kssg.rs	commits \| blame

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
    git clone https://git.sr.ht/~ijanc/kssg
    git clone https://github.com/kssg.git

License
-------
ISC — see LICENSE.