CLI Build Command
The build command is used to render your book:
It will try to parse your book.typbook.typ file to understand the structure and metadata of your book and fetch the corresponding files. Note that files mentioned in book.typbook.typ but not present will be created.
The rendered output will maintain the same directory structure as the source for convenience. Large books will therefore remain structured when rendered.
The buildbuild command can take a directory as an argument to use as the book's root instead of the current working directory.
Note: The workspace is a typst-specific command.
The --workspace--workspace option specifies the root directory of typst source files, which is like the --root--root option of typst-clitypst-cli. It is interpreted relative to current work directory of shiroashiroa process.
For example. When a book is created with the main file book-project1/book.typbook-project1/book.typ, and you want to access a template file with path common/book-template.typcommon/book-template.typ, please build it with following command:
Then you can access the template with the absolute path in typst:
The --dest-dir--dest-dir (-d-d) option allows you to change the output directory for the book. Relative paths are interpreted relative to the book's root directory. If not specified it will default to the value of the build.build-dirbuild.build-dir key in book.tomlbook.toml, or to ./book./book.
When your website's root is not exact serving the book, use --path-to-root--path-to-root to specify the path to the root of the book site. For example, if you own myriad-dreamin.github.iomyriad-dreamin.github.io and have mounted the book to /shiroa//shiroa/, you can access https://myriad-dreamin.github.io/shiroa/cli/main.htmlhttps://myriad-dreamin.github.io/shiroa/cli/main.html to get the generated content of cli/main.typcli/main.typ.
The --mode--mode option allows you to specify the mode of rendering typst document. The default mode is normalnormal.
- (Default)
dynamic-pageddynamic-paged: dynamically render as paged document. - (Experimental)
static-htmlstatic-html: statically render the whole document, the embedded frames are not resizable. - (Todo)
static-html-static-pagedstatic-html-static-paged: statically render html parts as much as possible, and leave frames rendered dynamically.
The dynamically rendering means that some elements will be rendered by a wasm renderer in the browser.
Specify a theme directory to copy recursively. This allows you to use custom themes.
The files will be copied to the theme/theme/ in the output directory.
The default theme is located at themes/mdbookthemes/mdbook. You can start by copying this theme and modifying it to your needs.
Currently, no interface is designed for custom themes, i.e. everything is working occasionally. If you have any questions, design or feature requests about theming, please open an issue in the repository.