Skip to content

Commit e85d055

Browse files
copy edits
1 parent 4d206ec commit e85d055

1 file changed

Lines changed: 11 additions & 6 deletions

File tree

  • docs/blog/posts/2026-02-xx-typst-books-etc

docs/blog/posts/2026-02-xx-typst-books-etc/index.qmd

Lines changed: 11 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,14 @@
11
---
22
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
37
---
48

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.
610

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:
812

913
* Typst Books
1014
* Article layout in Typst
@@ -40,17 +44,16 @@ All book features previously available in the LaTeX format are now available in
4044

4145
List-of-Figures and List-of-Tables support is [coming soon](https://github.com/quarto-dev/quarto-cli/issues/14081).
4246

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.
4448

4549
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.
4650

4751
## Article Layout in Typst
4852

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.
5054

5155
Specifically:
5256

53-
5457
* Figures, tables, code listings, and equations can be placed in the margin using the `.column-margin` class.
5558
* Figure, table, and code listing captions can be placed in the margin with `cap-location: margin`
5659
* 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:
6568

6669
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.
6770

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

Comments
 (0)