CLI Usage

Global Options

Option Description
`-v, --verbose` Show detailed output
`-h, --help` Show help
`--version` Show version

init

Create a new project.

  hwaro init [path] [options]

Options:

Option Description
`--scaffold TYPE` Project type: `simple`, `blog`, `docs`
`--force` Overwrite existing files
`--skip-sample-content` Skip sample content

Examples: 

  hwaro init my-site
hwaro init my-docs --scaffold docs
hwaro init my-blog --scaffold blog

build

Build the static site.

  hwaro build [options]

Options:

Option Description
`-o, --output-dir DIR` Output directory (default: `public`)
`--base-url URL` Override `base_url` from `config.toml`
`-d, --drafts` Include drafts
`--minify` Minify HTML/JSON/XML
`--no-parallel` Disable parallel processing
`--cache` Enable caching
`--skip-highlighting` Disable syntax highlighting

Examples: 

  hwaro build
hwaro build --minify
hwaro build --drafts --cache
hwaro build -o dist
hwaro build --base-url https://example.com

serve

Start development server with live reload.

  hwaro serve [options]

Options:

Option Description
`-p, --port PORT` Port (default: `3000`)
`-b, --bind HOST` Bind address (default: `0.0.0.0`)
`--base-url URL` Override `base_url` from `config.toml`
`--open` Open browser
`-d, --drafts` Include drafts

Examples: 

  hwaro serve
hwaro serve --port 8080
hwaro serve --open --drafts
hwaro serve --base-url https://example.com

new

Create a new content file.

  hwaro new [path]

Examples: 

  hwaro new content/about.md
hwaro new content/blog/my-post.md

Creates a file with front matter template:

  +++
title = "My Post"
date = "2024-01-15"
draft = true
+++

Write your content here...

Build Hooks

Configure in config.toml:

  [build]
hooks.pre = ["npm install"]
hooks.post = ["npm run minify"]