# ssg

A deliberately small static site generator written in QK.

Build or run the command package from the repository root:

```sh
qkc build ./cmd/ssg
qkc run ./cmd/ssg
qkc run ./cmd/ssg ./example
qkc run ./cmd/ssg ./example public
```

The first optional argument is the site root and defaults to the current
directory. The second is the output directory and defaults to `dist`. A
relative output directory is resolved beneath the site root; an absolute path
is used as given.

- `.md` and `.html` files below `pages/` become reachable output pages.
- Markdown bodies are converted with `vendor.mdhtml.md_to_html`.
- Files below `static/` are copied verbatim into the output directory.
- Files below `templates/` are only emitted when a page or another template uses them.

Front matter is delimited by `---` lines and supports quoted strings, signed
decimal integers, and `true`/`false` booleans:

```text
---
template="article.html"
title="About"
published=true
weight=10
---
```

Templates support `{{ variable }}`, `{{ content }}`, flat includes, parent
templates, basic conditions, comparisons, and `else`:

```html
{% include "header.html" %}
{% if published %}visible{% else %}hidden{% endif %}
{% if title == "About" %}about{% endif %}
```

Template and include paths are relative to `templates/`. Absolute paths and
`.` or `..` path components are rejected. Parent templates and includes share
one cycle detector.

Deliberate limitations: quoted front matter strings do not process escape
sequences; numbers are signed decimal integers; missing variables and invalid
syntax are errors; page bodies are content rather than templates; symlinks and
other special filesystem entries are rejected; the output directory is not
cleaned before a build. Static files are copied after generated pages, so a
static file with the same output path replaces the generated file.