The italic binary has six subcommands. Run italic --help or
italic <command> --help for the same information at the terminal.
Run the full build pipeline once, writing the site into the output directory
(public/ by default; see output_dir).
| Flag | Default | Meaning |
|---|---|---|
--drafts |
off | Include documents marked draft: true in the output. |
Without --drafts, drafts are dropped at the start of the build and never
appear in the output — nor in collections, taxonomies, or backlinks. See
Drafts.
italic build # production build
italic build --drafts # staging build that includes draftsBuild the site, serve it locally with live reload, and rebuild on every change to the source directories. Drafts are always included while serving.
| Flag | Default | Meaning |
|---|---|---|
--port <PORT> |
3000 |
Port to bind. |
--host <HOST> |
127.0.0.1 |
Host address to bind. |
italic serve
italic serve --port 8080
italic serve --host 0.0.0.0 --port 8080 # reachable from other devices on your networkRebuild on every change to the source directories, without running a server. Drafts are always included while watching. Useful when another tool is serving the output directory.
italic watchScaffold an empty starter site at <path>. The path must not already exist.
The scaffold includes a fully commented config.yaml showing every available
key with its default.
italic new my-siteCopy the configured theme's starter content into your content/ directory.
Requires a theme: key in config.yaml. Existing files are skipped, so it is
safe to run in a project that already has content. See
Themes.
italic scaffoldRemove the output directory (public/ by default).
italic clean- Configuration reference — directories the commands read and write
- Quickstart — the commands in context