summaryrefslogtreecommitdiff
path: root/crates/typst-cli/src/args.rs
diff options
context:
space:
mode:
Diffstat (limited to 'crates/typst-cli/src/args.rs')
-rw-r--r--crates/typst-cli/src/args.rs6
1 files changed, 5 insertions, 1 deletions
diff --git a/crates/typst-cli/src/args.rs b/crates/typst-cli/src/args.rs
index bed5f49a..c115d5a9 100644
--- a/crates/typst-cli/src/args.rs
+++ b/crates/typst-cli/src/args.rs
@@ -68,7 +68,11 @@ pub struct CompileCommand {
#[clap(flatten)]
pub common: SharedArgs,
- /// Path to output file (PDF, PNG, or SVG), use `-` to write output to stdout
+ /// Path to output file (PDF, PNG, or SVG).
+ /// Use `-` to write output to stdout; For output formats emitting one file per page,
+ /// a page number template must be present if the source document renders to multiple pages.
+ /// Use `{p}` for page numbers, `{0p}` for zero padded page numbers, `{t}` for page count.
+ /// For example, `doc-page-{0p}-of-{t}.png` creates `doc-page-01-of-10.png` and so on.
#[clap(required_if_eq("input", "-"), value_parser = ValueParser::new(output_value_parser))]
pub output: Option<Output>,