Skip to content

Conversation

@eusebe
Copy link

@eusebe eusebe commented Oct 29, 2025

I am submitting

  • a new package
  • an update for a package

Description: This package provides a Typst function, progressive-outline, and a tempate, progressive-layout, to generate a dynamic table of contents, similar to what is found in some LaTeX's Beamer presentations.

I have read and followed the submission guidelines and, in particular, I

  • [X ] selected a name that isn't the most obvious or canonical name for what the package does

  • [ X] added a typst.toml file with all required keys

  • [ X] added a README.md with documentation for my package

  • [ X] have chosen a license and added a LICENSE file or linked one in my README.md

  • [ X] tested my package locally on my system and it worked

  • [ X] excluded PDFs or README images, if any, but not the LICENSE

  • [ X] ensured that my package is licensed such that users can use and distribute the contents of its template directory without restriction, after modifying them through normal use.

@typst-package-check typst-package-check bot added the new A new package submission. label Oct 29, 2025
@elegaanz elegaanz self-assigned this Nov 3, 2025
Copy link
Member

@elegaanz elegaanz left a comment

Choose a reason for hiding this comment

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

Two small suggestions to improve your README.

#import "@preview/progressive-layout:1.0.0": progressive-layout, progressive-outline

// Apply the template to your document
#show: doc => progressive-layout(doc)
Copy link
Member

Choose a reason for hiding this comment

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

It is more idiomatic to write #show doc: progressive-layout, can you please update the example here (and other example files, using .with(...) in case you need to supply other arguments)?

This package includes two files to demonstrate its usage:

- [`example.typ`](https://github.com/eusebe/progressive-layout/blob/main/example.typ): This file shows how the `progressive-outline` function works with different options.
- [`demo.typ`](https://github.com/eusebe/progressive-layout/blob/main/demo.typ): This file provides an example of how to use the `progressive-layout` template.
Copy link
Member

Choose a reason for hiding this comment

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

I would either:

  • link to the files in this repository (i.e. [\example.typ`](example.typ)`)
  • delete the copy of the files in this repository, and link to a pinned commit or tag in your own repository (by replacing main in the URL with the commit hash or tag name)
    This was, you can be sure that the example files will always be in sync with the version of the package the user is reading the README for. Currently, if you push a breaking API change, the examples won't work anymore for people still reading the old README.

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

Labels

new A new package submission.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants