kewt/site/docs/usage.md

title = "Usage" priority = 3

Usage

kewt --help
kewt --version
kewt --new [title]
kewt --post [title]
kewt --generate-template [path]
kewt --update [dir]
kewt --from <src> --to <out>
kewt [src] [out]
kewt --watch
kewt --serve [port]

• --new [title] creates a new site directory with a default site.conf, template.html, and index.md.
• --post [title] creates a new markdown file in the configured posts_dir with the current date/time as the filename and default frontmatter.
• --generate-template [path] writes the default template.html to the given path (defaults to template.html in the current directory).
• --update [dir] adds any missing keys to site.conf and checks template.html against the latest default.
• --watch (-w) watches for file changes in the source directory and rebuilds automatically.
• --clean cleans the output directory before building (default behavior).
• --no-clean does not clean the output directory before building. Useful with --watch to avoid clearing output on every rebuild.
• --serve (-s) starts a local HTTP server (python3 or busybox) in the output directory after building. Use with the port number to specify the port. Composable with --watch.