Skip to content

blog: typst books, article layout, and typst-gather#1913

Open
gordonwoodhull wants to merge 8 commits intoprereleasefrom
blog/typst-books-etc
Open

blog: typst books, article layout, and typst-gather#1913
gordonwoodhull wants to merge 8 commits intoprereleasefrom
blog/typst-books-etc

Conversation

@gordonwoodhull
Copy link
Collaborator

@cwickham here's a first draft

I wish I had nicer examples for screenshots - these are just test cases.

@gordonwoodhull gordonwoodhull changed the title Blog/typst books etc blog: typst books, article layout, and typst-gather Feb 26, 2026
@github-actions github-actions bot temporarily deployed to pull request February 26, 2026 20:55 Inactive
@github-actions
Copy link
Contributor

📝 Preview Deployment

🔍 Full site preview: https://deploy-preview-1913.quarto.org

🔄 Modified Documents

Copy link
Collaborator

@cwickham cwickham left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is looking really good. I think the screenshots are fine. They illustrate the new functionality well, so unless you want to invest time into some super slick ones, I wouldn't worry.

Quarto 1.9 adds Typst book projects, article margin layout via Marginalia, and offline package bundling with `typst-gather`.
image: typst-book-article.png
---

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If we publish before the release we should add a pre-release feature callout here.


Naturally, book and article layout can be combined:

![](typst-book-article.png)
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I notice the box on this page around "A. Additional Resources" doesn't go all the way to the edge of the page, like the first example. I'd expect it to align with some other vertical, e.g. the edge of the page, or the inner or outer edge of the margin content.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yes... Maybe it's overselling to say they can naturally be combined.

It is completely functional, but it will require more work to properly integrate article layout and book layout at the template/extension level.

I am 99% certain that nothing more will need to change in Quarto core, so I declared success here.

But the quarto-orange-book extension still needs work here, and probably contributions upstream to the Typst package.

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I changed this to a callout with no screenshots. It works but layout is not ready to show off.

Add column: margin code cell option, fig-column/tbl-column,
fig-cap-location/tbl-cap-location, and asides to the article
layout bullet list. Reframe intro around feature parity with LaTeX.
…, copy edits

- Add lightbox with 4-col book and 3-col article screenshot groups
- Add fig-alt text on all screenshots and image-alt in front matter
- Add landscape thumbnail image
- Add brand.yml customization example
- Split long bullet, improve captions, fix callout tone, tighten closing
@gordonwoodhull
Copy link
Collaborator Author

gordonwoodhull commented Mar 3, 2026

Thanks @cwickham, excellent feedback.

I think the new draft covers everything.

I prefer to post both of the blog posts after release, because there is are important links into the docs, and I don't think we should post links to the prerelease docs.

Alternatively, we could post and then update the links after release, but that seems fiddly.

@gordonwoodhull gordonwoodhull marked this pull request as ready for review March 3, 2026 15:35
@github-actions github-actions bot temporarily deployed to pull request March 3, 2026 15:39 Inactive
@github-actions
Copy link
Contributor

github-actions bot commented Mar 3, 2026

📝 Preview Deployment

🔍 Full site preview: https://deploy-preview-1913.quarto.org

🔄 Modified Documents

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants