You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/blog/posts/2026-02-xx-typst-books-etc/index.qmd
+11-6Lines changed: 11 additions & 6 deletions
Original file line number
Diff line number
Diff line change
@@ -1,10 +1,14 @@
1
1
---
2
2
title: Typst Books, Article Layout, and `typst-gather`
3
+
author: Gordon Woodhull
4
+
description: |
5
+
Quarto 1.9 adds Typst book projects, article margin layout via Marginalia, and offline package bundling with `typst-gather`.
6
+
image: typst-book-article.png
3
7
---
4
8
5
-
Typst is a modern and lightning-fast typesetting system that aims to replace LaTeX.
9
+
Typst is a lightning-fast typesetting system that provides a modern alternative to LaTeX.
6
10
7
-
The Typst ecosystem is exploding, and Quarto 1.9 provides first-class support for Typst packages:
11
+
The Typst ecosystem is thriving, and Quarto 1.9 provides first-class support for Typst packages:
8
12
9
13
* Typst Books
10
14
* Article layout in Typst
@@ -40,17 +44,16 @@ All book features previously available in the LaTeX format are now available in
40
44
41
45
List-of-Figures and List-of-Tables support is [coming soon](https://github.com/quarto-dev/quarto-cli/issues/14081).
42
46
43
-
Typst Books are implemented as Quarto [Format Extensions](https://quarto.org/docs/extensions/formats.html). Typst partials define the overall book structure, while Lua filters handle the necessary AST transformations.
47
+
Typst Books are implemented as Quarto [Format Extensions](/docs/extensions/formats.qmd). Typst partials define the overall book structure, while Lua filters handle the necessary AST transformations.
44
48
45
49
Quarto bundles the [quarto-orange-book](https://github.com/quarto-ext/orange-book) extension, which [bundles](#typst-gather) the Typst [orange-book](https://typst.app/universe/package/orange-book) package. Orange-book provides a textbook-style layout with colored chapter headers and sidebars.
46
50
47
51
## Article Layout in Typst
48
52
49
-
Also in Quarto 1.9, all [Article Layout](https://quarto.org/docs/authoring/article-layout.html) features now work in Typst, via the Typst [Marginalia](https://typst.app/universe/package/marginalia/) package.
53
+
Also in Quarto 1.9, all [Article Layout](/docs/authoring/article-layout.qmd) features now work in Typst, via the Typst [Marginalia](https://typst.app/universe/package/marginalia/) package.
50
54
51
55
Specifically:
52
56
53
-
54
57
* Figures, tables, code listings, and equations can be placed in the margin using the `.column-margin` class.
55
58
* Figure, table, and code listing captions can be placed in the margin with `cap-location: margin`
56
59
* Footnotes and citations can be displayed in the margin with `reference-location: margin` and `citation-location: margin`. When margin citations are enabled, the bibliography is suppressed.
@@ -65,4 +68,6 @@ Naturally, book and article layout can be combined:
65
68
66
69
Quarto 1.9 automatically stages Typst packages — from your extensions, from Quarto's bundled extensions, and from Quarto itself — into the `.quarto/` cache directory before calling `typst compile`. This means Typst documents render offline without needing network access.
67
70
68
-
To make this work, extension authors use the new [`typst-gather`](/docs/advanced/typst/typst-gather.qmd) tool, which scans their `.typ` files for `@preview` imports and downloads the packages into the extension directory. Authors run `quarto call typst-gather` and commit the results — users of the extension don't need to do anything. This means [Custom Typst Formats](/docs/output-formats/typst-custom.qmd#custom-formats) can depend on Typst packages without copying and pasting Typst code, making them simpler and easier to maintain.
71
+
To make this work, extension authors use the new [`typst-gather`](/docs/advanced/typst/typst-gather.qmd) tool, which scans their `.typ` files for `@preview` imports and downloads the packages into the extension directory. Authors run `quarto call typst-gather` and commit the results — users of the extension don't need to do anything.
72
+
73
+
This means [Custom Typst Formats](/docs/output-formats/typst-custom.qmd#custom-formats) can depend on Typst packages without copying and pasting Typst code, making them simpler and easier to maintain.
0 commit comments