.ie \n(.g .ds Aq \(aq
.el .ds Aq '
.TH typst-eval 1  "typst-eval " 
.SH NAME
typst\-eval \- Evaluates a piece of Typst code, optionally in the context of a document
.SH SYNOPSIS
\fBtypst\-eval\fR [\fB\-\-in\fR] [\fB\-\-target\fR] [\fB\-\-format\fR] [\fB\-\-pretty\fR] [\fB\-\-root\fR] [\fB\-\-input\fR] [\fB\-\-font\-path\fR] [\fB\-\-ignore\-system\-fonts\fR] [\fB\-\-ignore\-embedded\-fonts\fR] [\fB\-\-package\-path\fR] [\fB\-\-package\-cache\-path\fR] [\fB\-\-creation\-timestamp\fR] [\fB\-j\fR|\fB\-\-jobs\fR] [\fB\-\-features\fR] [\fB\-\-diagnostic\-format\fR] [\fB\-h\fR|\fB\-\-help\fR] <\fIEXPRESSION\fR> 
.SH DESCRIPTION
Evaluates a piece of Typst code, optionally in the context of a document
.SH OPTIONS
.TP
\fB\-\-in\fR \fI<IN>\fR
A file in whose context to evaluate the code. Can be used to introspect the document. Use `\-` to read input from stdin
.TP
\fB\-\-target\fR \fI<TARGET>\fR [default: paged]
The target to compile for
.br

.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
paged: PDF and image formats
.IP \(bu 2
html: HTML
.IP \(bu 2
bundle: Bundle
.RE
.TP
\fB\-\-format\fR \fI<FORMAT>\fR [default: json]
The format to serialize in
.br

.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
json
.IP \(bu 2
yaml
.RE
.TP
\fB\-\-pretty\fR
Whether to pretty\-print the serialized output.

Only applies to JSON format.
.TP
\fB\-\-root\fR \fI<DIR>\fR
Configures the project root (for absolute paths)
.RS
May also be specified with the \fBTYPST_ROOT\fR environment variable. 
.RE
.TP
\fB\-\-input\fR \fI<key=value>\fR
Add a string key\-value pair visible through `sys.inputs`
.TP
\fB\-\-font\-path\fR \fI<DIR>\fR
Adds additional directories that are recursively searched for fonts.

If multiple paths are specified, they are separated by the system\*(Aqs path separator (`:` on Unix\-like systems and `;` on Windows).
.RS
May also be specified with the \fBTYPST_FONT_PATHS\fR environment variable. 
.RE
.TP
\fB\-\-ignore\-system\-fonts\fR
Ensures system fonts won\*(Aqt be searched, unless explicitly included via `\-\-font\-path`
.RS
May also be specified with the \fBTYPST_IGNORE_SYSTEM_FONTS\fR environment variable. 
.RE
.TP
\fB\-\-ignore\-embedded\-fonts\fR
Ensures fonts embedded into Typst won\*(Aqt be considered
.RS
May also be specified with the \fBTYPST_IGNORE_EMBEDDED_FONTS\fR environment variable. 
.RE
.TP
\fB\-\-package\-path\fR \fI<DIR>\fR
Custom path to local packages, defaults to system\-dependent location
.RS
May also be specified with the \fBTYPST_PACKAGE_PATH\fR environment variable. 
.RE
.TP
\fB\-\-package\-cache\-path\fR \fI<DIR>\fR
Custom path to package cache, defaults to system\-dependent location
.RS
May also be specified with the \fBTYPST_PACKAGE_CACHE_PATH\fR environment variable. 
.RE
.TP
\fB\-\-creation\-timestamp\fR \fI<UNIX_TIMESTAMP>\fR
The document\*(Aqs creation date formatted as a UNIX timestamp.

For more information, see <https://reproducible\-builds.org/specs/source\-date\-epoch/>.
.RS
May also be specified with the \fBSOURCE_DATE_EPOCH\fR environment variable. 
.RE
.TP
\fB\-j\fR, \fB\-\-jobs\fR \fI<JOBS>\fR
Number of parallel jobs spawned during compilation. Defaults to number of CPUs. Setting it to 1 disables parallelism
.TP
\fB\-\-features\fR \fI<FEATURES>\fR
Enables in\-development features that may be changed or removed at any time
.br

.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
html
.IP \(bu 2
bundle
.IP \(bu 2
a11y\-extras
.RE
.RS
May also be specified with the \fBTYPST_FEATURES\fR environment variable. 
.RE
.TP
\fB\-\-diagnostic\-format\fR \fI<DIAGNOSTIC_FORMAT>\fR [default: human]
The format to emit diagnostics in
.br

.br
\fIPossible values:\fR
.RS 14
.IP \(bu 2
human
.IP \(bu 2
short
.RE
.TP
\fB\-h\fR, \fB\-\-help\fR
Print help (see a summary with \*(Aq\-h\*(Aq)
.TP
<\fIEXPRESSION\fR>
The piece of Typst code to evaluate