From 63ed63cee38e6af712448edb9026831b9148a3ab Mon Sep 17 00:00:00 2001 From: Charlotte Wickham Date: Tue, 7 Oct 2025 13:47:47 -0700 Subject: [PATCH 1/2] Document page-numbering for format: typst --- docs/output-formats/typst.qmd | 11 ++++++++++- docs/reference/formats/typst.json | 4 ++++ 2 files changed, 14 insertions(+), 1 deletion(-) diff --git a/docs/output-formats/typst.qmd b/docs/output-formats/typst.qmd index 87e988b37..0d11b7a7d 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 an empty string: + +```yaml +page-numbering: "" +``` {{< include /docs/output-formats/_document-options-toc.md >}} diff --git a/docs/reference/formats/typst.json b/docs/reference/formats/typst.json index 69cf98d5a..dddafc172 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 an empty string, \n`\"\"`, to omit page numbering.\n\nSee [Typst Numbering](https://typst.app/docs/reference/model/numbering/) \nfor additional information.\n" } ] }, From e168ad1d8690ef564d78b6448b6a02b885d47da7 Mon Sep 17 00:00:00 2001 From: Charlotte Wickham Date: Wed, 8 Oct 2025 09:05:32 -0700 Subject: [PATCH 2/2] Use `false` to omit numbering --- docs/output-formats/typst.qmd | 4 ++-- docs/reference/formats/typst.json | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/docs/output-formats/typst.qmd b/docs/output-formats/typst.qmd index 0d11b7a7d..711a32e25 100644 --- a/docs/output-formats/typst.qmd +++ b/docs/output-formats/typst.qmd @@ -123,10 +123,10 @@ The `columns` option expects a number - the number of columns your body content 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 an empty string: +To omit page numbers, set `page-numbering` to `false`: ```yaml -page-numbering: "" +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 dddafc172..6af29969f 100644 --- a/docs/reference/formats/typst.json +++ b/docs/reference/formats/typst.json @@ -79,7 +79,7 @@ }, { "name": "page-numbering", - "description": "Schema to use for numbering pages, e.g. `1` or `i`, or an empty string, \n`\"\"`, to omit page numbering.\n\nSee [Typst Numbering](https://typst.app/docs/reference/model/numbering/) \nfor additional information.\n" + "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" } ] },