diff --git a/docs/output-formats/typst.qmd b/docs/output-formats/typst.qmd index 87e988b37..711a32e25 100644 --- a/docs/output-formats/typst.qmd +++ b/docs/output-formats/typst.qmd @@ -59,7 +59,7 @@ Since Typst is under active development, there are still some limitations to Qua ## Page Layout -You can control the size of the page (`papersize`), the page margins (`margin`), and the number of columns used for page content (`columns`). For example, the following YAML modifies all three options: +You can control the size of the page (`papersize`), the page margins (`margin`), the number of columns used for page content (`columns`), and the page numbering (`page-numbering`). For example, the following YAML modifies the first three options: ```yaml --- @@ -119,6 +119,15 @@ Then, any unspecified margins will inherit from the default margins. The `columns` option expects a number - the number of columns your body content should have. The default template sets `columns` to `1`. +### Page Numbering + +The `page-numbering` option expects a string that describes a [Typst numbering](https://typst.app/docs/reference/model/numbering/) pattern. +For example, the default, `1`, numbers pages with arabic numerals, and `i` numbers pages with lower case roman numerals. +To omit page numbers, set `page-numbering` to `false`: + +```yaml +page-numbering: false +``` {{< include /docs/output-formats/_document-options-toc.md >}} diff --git a/docs/reference/formats/typst.json b/docs/reference/formats/typst.json index 69cf98d5a..6af29969f 100644 --- a/docs/reference/formats/typst.json +++ b/docs/reference/formats/typst.json @@ -76,6 +76,10 @@ { "name": "shift-heading-level-by", "description": "Shift heading levels by a positive or negative integer.\nFor example, with `shift-heading-level-by: -1`, level 2\nheadings become level 1 headings, and level 3 headings\nbecome level 2 headings. Headings cannot have a level\nless than 1, so a heading that would be shifted below level 1\nbecomes a regular paragraph. Exception: with a shift of -N,\na level-N heading at the beginning of the document\nreplaces the metadata title.\n" + }, + { + "name": "page-numbering", + "description": "Schema to use for numbering pages, e.g. `1` or `i`, or `false` to omit page numbering.\n\nSee [Typst Numbering](https://typst.app/docs/reference/model/numbering/) \nfor additional information.\n" } ] },