The CLI

Four commands, one contract: errors go to stderr, stdout stays empty, exit 1 — a failed render never emits a half-rendered document.

Commands

• dogbed render <template.knap> [options] — render a Knap template plus a JSON object to HTML on stdout.
• dogbed template <name> — print an embedded starter to stdout: verdict, release-notes, reading-note. --list shows names.
• dogbed init — scaffold a site skeleton (routes, templates, data, build.sh) into the current directory. Strictly additive — an existing file is never overwritten; a superseded scaffold file is archived to a timestamped dir.
• dogbed --help, dogbed --version — the obvious.

Render options

• --data, -d <file> — JSON object with the template variables (default {}). - reads stdin.
• --profile, -p html|xhtml — oliver output profile: HTML5 fragment (default) or XHTML 1.0 Strict.
• --title <text> — wrap the fragment in a minimal document shell and set <title> (HTML-escaped). XHTML gets the Strict shell.
• --css <href> — <link rel=stylesheet> into the shell. Repeatable, order kept, href verbatim.
• --head <html> — splice one verbatim line into <head> (meta, favicon). Repeatable.
• --lang <tag> — lang on the root element (xml:lang too under XHTML). Verbatim — pick a real BCP 47 tag.
• --wikilink-href <pattern> — href pattern for [[wikilinks]]: {slug} is the target slugged lowercase-kebab, {target} the verbatim target. Default {slug}.html.
• --max-output, -m <bytes> — ceiling on the emitted document, shell included (k/m/g suffixes). Default 256 MiB, 0 = unlimited. Enforced as bytes are written — over-limit output never exists.
• --escape — opt-in sanitization for untrusted data: HTML-escape every string in the JSON object before interpolation, and percent-encode dangerous URL schemes (javascript:, vbscript:, non-image data:). <!-- dogbed:raw --> … <!-- dogbed:endraw --> marks trusted interpolations that pass through unescaped.

Exit contract

Any of --title, --css, --head, --lang switches output from a bare fragment to a full document. With none, the fragment is byte-identical to a bare oliver render:

$ dogbed render share/verdict.knap -d share/verdict.json
<h1 id="dogbed-010-first-verdict">dogbed 0.1.0 — first verdict</h1>
<p><strong>approve</strong> — the pipeline sings</p>
<h2 id="blockers">Blockers</h2>
<h2 id="nits">Nits</h2>
<ol>
<li>ship it</li>
</ol>
$ echo '{"bad":1' | dogbed render verdict.knap -d -
dogbed: invalid JSON in data (-): UnexpectedEndOfInput
$ echo $?
1