跳到主要内容

更新日志

v0.7.3​

Minor Breaking Changes​

  • feat!: always attach #speaker-note[] to the previous slide & default receive-body-for-new-*-slide-fn to false (#354)
    • #speaker-note[] now always attaches to the slide above it, regardless of how that slide was created (explicit slide calls, heading-triggered section slides, or normal content slides). This eliminates the common pitfall where a #speaker-note[] placed after a slide would silently create an unwanted empty "ghost" slide.
    • receive-body-for-new-section-slide-fn and its variants are now defaulted to false (previously true).

Migration Guide​

If you relied on content after = Section headings being absorbed into the section slide body, explicitly set receive-body-for-new-section-slide-fn: true in your config-common(...).

Features​

  • feat: item-by-item-fn and presets for it (#347)
  • feat: improved custom-progressive-outline and new section-relationship and some other things (#345)
  • feat: better lazy-layout for mixed layouts (#355)
  • feat: add cols as alias of side-by-side and export some components cols, lazy-xxx to outside (#356)
  • theme(metropolis): add outline-slide for metropolis (#349)
  • feat: add warning for empty slide content height detection

Documentation​

  • docs: add multiple columns example and improve docs structure

v0.7.1​

Features​

  • feat(agents): breakable and clip options to avoid slide overflow (#336)
  • feat(components): add lazy-v (lazy-h) and lazy-layout for equalizing multi-column (-row) block heights (widths) (#339)
  • feat: additional contact and extra field in config-info (#342)
  • feat: touying-get-config function (#333)

Fixes​

  • fix: fix fit-to-height and size-to-pt and allow text reflow (#332)
  • fix: fix waypoint markers (#341)

v0.7.0​

Features​

  • major feature: a named waypoint feature (#298)
  • feat(waypoint): start param and Waypoints in handout-subslides (#304)
  • feat: auto, "h"-here string and inverse function for string subslide-numbers and waypoints (#301)
  • feat: implicitly allow fn-wrapper based animation functions via reducer (#300)

Fixes​

  • fix: fix cover-with-rect breaking long lines of text when partially hidden and fallback functions for color/alpha cover (#328)
  • fix: using explicit numbering in display-current-heading when style=auto (#329)
  • fix: fix ghost slides with show rules. Fix proper consistent handling of show rules and defer keyword (#317)
  • fix: alert not delayed (#316)
  • fix: remove redundant nested text call (#324)
  • fix: function alternatives-match takes into account parameter stretch (#320)
  • fix: correctly handle page margin merge/precedence (#322)
  • fix: fix cover spacing issues surrounding lists (#303)
  • fix: correctly parses negative subslide indices (ints, arrays) for handout-subslides (#307)
  • fix: slide function does not update via scoped import (#310)

Thanks for the contributions from @zral0kh, @Andrew15-5, @navdeeprana, and @Cemoixerestre.

v0.6.3​

A major bugfix release, fixing many long-standing bugs and introducing many practical features.

Features​

  • feat: add #jump(n, relative: bool) as unified animation control; redefine #pause/#meanwhile as sugar
  • feat: add #handout-only for inline content and <touying:handout> label for handout-exclusive slides (#286)
  • feat: add handout-subslides to control which subslides appear in handout mode (#288)
  • feat: add #touying-raw for animated code block reveals (#283)
  • feat: add full-screen speaker notes mode with slide thumbnail (show-only-notes) (#281)
  • feat: support arbitrary aspect ratios (e.g. 16-10) across all themes and speaker-note second screen (#280)
  • feat: add #item-by-item animation for list, enum, and terms (#278)
  • feat(recall): add subslide parameter to #touying-recall (#285)
  • feat: add default-composer to config-common for global slide layout configuration (#284)
  • feat: add cover-fn parameter to uncover for external package integration (e.g. Fletcher) (#267)
  • feat: minislides can be displayed inline (#228)
  • theme: improve appearance of long author lists in university and stargazer theme (#242)
  • theme(simple): make simple-theme respect color configuration for deco-format (#252)
  • theme(aqua,stargazer): add extra parameter to title-slide (#291)

Fixes​

  • fix: prevent ghost-slide blank pages from touying-set-config anchor regression (#289)
  • fix: styled content on first slide no longer creates extra slides (#287)
  • fix: remove unoutlined headings from navigation
  • fix: fix #meanwhile being ignored inside grid cells, boxes, and other containers (#274)
  • fix: fix config: parameter silently ignored across all themes (#273)
  • fix: fix slides after #show/#set rules not rendering subsequent slides (#268)
  • fix: fix title page PDF page label causing pdfpc presenter notes mismatch (#277)
  • fix: fix duplicate label error for labeled footnotes with #pause animations (#275)
  • fix: fix #pause inside #speaker-note body (nested list items) (#282)
  • theme(dewdrop): fix body content under level-1 heading was silently dropped (#279)
  • theme(stargazer): update stargazer theme margins and fix #259

Documentation​

  • docs(BIG CHANGE): refactor docs website and add references page
  • docs: reduce README noise, improve first impression (#297)
  • docs: restructure docs + add docs-preview CI for PRs (#296)
  • docs: comprehensive docstring improvements across all source files (#294)

Theme Migration Guide​

For theme developers upgrading to v0.6.3:

  1. Move config to the last position in utils.merge-dicts to allow user overrides:

    // Before
    self = utils.merge-dicts(self, config, config-page(...))

    // After
    self = utils.merge-dicts(self, config-page(...), config)

  2. Replace paper with utils.page-args-from-aspect-ratio to support arbitrary aspect ratios:

    // Before
    config-page(paper: "presentation-" + aspect-ratio, ...)

    // After
    config-page(..utils.page-args-from-aspect-ratio(aspect-ratio), ...)

v0.6.2​

Features​

  • feat: allow customisation of components.checkerboard (#161)

Fixes​

  • fix: support ratio and relative margins for full-width headers (#256)
  • fix: fix magic.bibliography-as-footnote in Typst 0.14 (#249)
  • fix: theorion package is broken with Typst 0.14.0 (#237)
  • fix: update components.typ and pass named arguments to grid (#207)
  • fix: fix #meanwhile in cetz (#205)
  • fix: documentation contains unclosed raw text error (#187)
  • fix: use correct circle symbol (#171)
  • fix: use regex to override colors of equations (#167)
  • fix: show-hide-set-list-marker-none with full enum (#157)
  • fix: remove dump and label-it function for better cache

Miscellaneous​

  • docs: update README, bump versions of deps, and fix comment docs
  • ci: add more tests, bump versions of tytanic, and update typstyle workflow (#221, #261)

v0.6.1​

Added support for the theorion package, and used it as the default math theorem environment.

v0.6.0​

It's not a big update, but it's the first touying release since typst 0.13 was released.

Features​

  • feat: add auto style for display-current-heading.
    • For users, you can use show heading: set text(blue) to change color for heading in some themes like dewdrop.
    • For theme creator, you can use syntax like utils.display-current-heading(level: 1, style: auto) to achieve the same result.
  • feat: apply config-info information to set document.
  • feat: set stretch: false by default for alternatives functions. This is a minor breaking change, but I think it would be more intuitive: no auto empty space.

Fixes​

v0.5.4 & v0.5.5​

Features​

Fixes​

Thanks for the contributions from @enklht.

v0.5.3​

Features​

  • feat: add stretch parameter for #alternatives[] function class. This allows us to handle cases where the internal element is a context expression.
  • feat: add config-common(align-enum-marker-with-baseline: true) for aligning the enum marker with the baseline.
  • feat: add linebreaks option to components.mini-slides. https://github.com/touying-typ/touying/pull/96
  • feat: add <touying:skip> label to skip a new-section-slide.
  • feat: add config-common(show-hide-set-list-marker-none: true) to make the markers of list and enum invisible after #pause.
  • feat: add config-common(bibliography-as-footnote: bibliography(title: none, "ref.bib")) to display the bibliography in footnotes.
  • refactor: add config-common(show-strong-with-alert: true) configuration to display strong text with an alert. (small breaking change for some themes)
  • refactor: refactor display-current-heading for preserving heading style in title and subtitle. https://github.com/touying-typ/touying/issues/71
  • refactor: make new-section-slide-fn function class can receive body parameter. We can use receive-body-for-new-section-slide-fn to control it. (Breaking change)
    • For example, you can add #speaker-note[] for a new section slide, like = Section Title \ #speaker-note[].
    • If you don't want to append content to the body of the new section slide, you can use --- after the section title.

Fixes​

v0.5.1 & v0.5.2​

  • Fix some bugs.

v0.5.0​

This is a significant disruptive version update. Touying has removed many mistakes that resulted from incorrect decisions. We have redesigned numerous features. The goal of this version is to make Touying more user-friendly, more flexible, and more powerful.

Major changes include:

  • Avoiding closures and OOP syntax, which makes Touying's configuration simpler and allows for the use of document comments to provide more auto-completion information for the slide function.
    • The existing #let slide(self: none, ..args) = { .. } is now #let slide(..args) = touying-slide-wrapper(self => { .. }), where self is automatically injected.
    • We can use config-xxx syntax to configure Touying, for example, #show: university-theme.with(aspect-ratio: "16-9", config-colors(primary: blue)).
  • The touying-slide function no longer includes parameters like section, subsection, and title. These will be automatically inserted into the slide as invisible level 1, 2, or 3 headings via self.headings (controlled by the slide-level configuration).
    • We can leverage the powerful headings provided by Typst to support numbering, outlines, and bookmarks.
    • Headings within the #slide[= XXX] function will be adjusted to level slide-level + 1 using the offset parameter.
    • We can use labels on headings to control many aspects, such as supporting the <touying:hidden> and other special labels, implementing short headings, or recalling a slide with #touying-recall().
  • Touying now supports the normal use of set and show rules at any position, without requiring them to be in specific locations.

A simple usage example is shown below, and more examples can be found in the examples directory:

#import "@preview/touying:0.6.3": *
#import themes.university: *

#show: university-theme.with(
  aspect-ratio: "16-9",
  config-info(
    title: [Title],
    subtitle: [Subtitle],
    author: [Authors],
    date: datetime.today(),
    institution: [Institution],
    logo: emoji.school,
  ),
)

#set heading(numbering: "1.1")

#title-slide()

= The Section

== Slide Title

#lorem(40)

Theme Migration Guide:

For detailed changes to specific themes, you can refer to the themes directory. Generally, if you want to migrate an existing theme, you should:

  1. Rename the register function to xxx-theme and remove the self parameter.
  2. Add a show: touying-slides.with(..) configuration.
    • Change self.methods.colors to config-colors(primary: rgb("#xxxxxx")).
    • Change self.page-args to config-page().
    • Change self.methods.slide = slide to config-methods(slide: slide).
    • Change self.methods.new-section-slide = new-section-slide to config-methods(new-section-slide: new-section-slide).
    • Change private theme variables like self.xxx-footer to config-store(footer: [..]), which you can access through self.store.footer.
    • Move the configuration of headers and footers into the slide function rather than in the xxx-theme function.
    • You can directly use set or show rules in xxx-theme or configure them through config-methods(init: (self: none, body) => { .. }) to fully utilize the self parameter.
  3. For states.current-section-with-numbering, you can use utils.display-current-heading(level: 1) instead.
    • If you only need the previous heading regardless of whether it is a section or a subsection, use utils.display-current-heading().
  4. The alert function can be replaced with config-methods(alert: utils.alert-with-primary-color).
  5. The touying-outline() function is no longer needed; you can use components.adaptive-columns(outline()) instead. Consider using components.progressive-outline() or components.custom-progressive-outline().
  6. Replace states.slide-counter.display() + " / " + states.last-slide-number with context utils.slide-counter.display() + " / " + utils.last-slide-number. That is, we no longer use states but utils.
  7. Remove the slides function; we no longer need this function. Instead of implicitly injecting title-slide(), explicitly use #title-slide(). If necessary, consider adding it in the xxx-theme function.
  8. Change #let slide(self: none, ..args) = { .. } to #let slide(..args) = touying-slide-wrapper(self => { .. }), where self is automatically injected.
    • Change specific parameter configurations to self = utils.merge-dicts(self, config-page(fill: self.colors.neutral-lightest)).
    • Remove self = utils.empty-page(self) and use config-common(freeze-slide-counter: true) and config-page(margin: 0em) instead.
    • Change (self.methods.touying-slide)() to touying-slide().
  9. You can insert visible headings into slides by configuring config-common(subslide-preamble: self => text(1.2em, weight: "bold", utils.display-current-heading(depth: self.slide-level))).
  10. Finally, don't forget to add document comments to your functions so your users can get better auto-completion hints, especially when using the Tinymist plugin.

Other Changes:

  • theme(stargazer): new stargazer theme modified from Coekjan/touying-buaa.
  • feat: implemented fake frozen states support, allowing you to use numbering and #pause normally. This behavior can be controlled with enable-frozen-states-and-counters, frozen-states, and frozen-counters in config-common().
  • feat: implemented label-only-on-last-subslide functionality to prevent non-unique label warnings when working with @equation and @figure in conjunction with #pause animations.
  • feat: added the touying-recall(<label>) function to replay a specific slide.
  • feat: implemented nontight-list-enum-and-terms, which defaults to true and forces list, enum, and terms to have their tight parameter set to false. You can control spacing size with #set list(spacing: 1em).
  • feat: replaced list with terms implementation to achieve align-list-marker-with-baseline, which is off by default.
  • feat: implemented scale-list-items, scaling list items by a factor, e.g., scale-list-items: 0.8 scales list items by 0.8.
  • feat: supported direct use of #pause and #meanwhile in math expressions, such as $x + pause y$.
  • feat: provided #pause and #meanwhile support for most layout functions, such as grid and table.
  • feat: added #show: appendix support, essentially equivalent to #show: touying-set-config.with((appendix: true)).
  • feat: Introduced special labels <touying:hidden>, <touying:unnumbered>, <touying:unoutlined>, <touying:unbookmarked> to simplify control over heading behavior.
  • feat: added basic utils.short-heading support to display short headings using labels, such as displaying <sec:my-section> as "My Section".
  • feat: added #components.adaptive-columns() to achieve adaptive columns that span a page, typically used with the outline() function.
  • feat: added #show: magic.bibliography-as-footnote.with(bibliography("ref.bib")) to display the bibliography in footnotes.
  • feat: added components like custom-progressive-outline, mini-slides.
  • feat: removed touying-outline(), which can be directly replaced with outline().
  • fix: replaced potentially incompatible code, such as type(s) == "string" and locate(loc => { .. }).
  • fix: Fixed some bugs.

v0.4.2​

  • theme(metropolis): decoupled text color with neutral-dark (Breaking change)
  • feat: add mark-style uncover, only and alternatives
  • feat: add warning for styled block for slides
  • feat: add warning for touying-temporary-mark
  • feat: add markup-text for speaker-note
  • fix: fix bug of slides

v0.4.1​

Features​

  • feat: support builtin outline and bookmark
  • feat: support speaker note for dual-screen
  • feat: add touying-mitex function
  • feat: touying offers a gallery page via wiki

Fixes​

  • fix: add outline-slide for dewdrop theme
  • fix: fix regression of default value "auto" for repeat

Miscellaneous Improvements​

  • feat: add list support for touying-outline function
  • feat: add auto-reset-footnote
  • feat: add freeze-in-empty-page for better page counter
  • feat: add ..args for register method to capture unused arguments

v0.4.0​

Features​

  • feat: support #footnote[] for all themes.
  • feat: access subslide and repeat in footer and header by self => self.subslide.
  • feat: support numbered theorem environments by ctheorems.
  • feat: support numbering for sections and subsections.

Fixes​

  • fix: make nested includes work correctly.
  • fix: disable multi-page slides from creating the same section multiple times.

Breaking changes​

  • refactor: remove self.padding and add self.full-header self.full-footer config.

v0.3.3​

  • template: move template to touying-aqua package, make Touying searchable in Typst Universe Packages
  • themes: fix bugs in university and dewdrop theme
  • feat: make set-show rule work without setting parameter
  • feat: make composer parameter more simpler
  • feat: add empty-slide function

v0.3.2​

  • fix critical bug: fix is-sequence function, make grid and table work correctly in touying
  • theme: add aqua theme, thanks for pride7
  • theme: make university theme more configurable
  • refactor: don't export variable s by default anymore, it will be extracted by register function (Breaking Change)
  • meta: add categories and template config to typst.toml for Typst 0.11

v0.3.1​

  • fix some typos
  • fix slide-level bug
  • fix bug of pdfpc label

v0.3.0​

Features​

  • better show-slides mode.
  • support align and pad.

Documentation​

  • Add more detailed documentation.

Refactor​

  • simplify theme.

Fix​

  • fix many bugs.

v0.2.1​

Features​

  • Touying-reducer: support cetz and fletcher animation
  • university theme: add university theme

Fix​

  • fix footer progress in metropolis theme
  • fix some bugs in simple and dewdrop themes
  • fix bug that outline does not display more than 4 sections

v0.2.0​

  • Object-oriented programming: Singleton s, binding methods utils.methods(s) and (self: obj, ..) => {..} methods.
  • Page arguments management: Instead of using #set page(..), you should use self.page-args to retrieve or set page parameters, thereby avoiding unnecessary creation of new pages.
  • #pause for sequence content: You can use #pause at the outermost level of a slide, including inline and list.
  • #pause for layout functions: You can use the composer parameter to add yourself layout function like utils.side-by-side, and simply use multiple pos parameters like #slide[..][..].
  • #meanwhile for synchronous display: Provide a #meanwhile for resetting subslides counter.
  • #pause and #meanwhile for math equation: Provide a #touying-equation("x + y pause + z") for math equation animations.
  • Slides: Create simple slides using standard headings.
  • Callback-style uncover, only and alternatives: Based on the concise syntax provided by Polylux, allow precise control of the timing for displaying content.
    • You should manually control the number of subslides using the repeat parameter.
  • Transparent cover: Enable transparent cover using oop syntax like #let s = (s.methods.enable-transparent-cover)(self: s).
  • Handout mode: enable handout mode by #let s = (s.methods.enable-handout-mode)(self: s).
  • Fit-to-width and fit-to-height: Fit-to-width for title in header and fit-to-height for image.
    • utils.fit-to-width(grow: true, shrink: true, width, body)
    • utils.fit-to-height(width: none, prescale-width: none, grow: true, shrink: true, height, body)
  • Slides counter: states.slide-counter.display() + " / " + states.last-slide-number and states.touying-progress(ratio => ..).
  • Appendix: Freeze the last-slide-number to prevent the slide number from increasing further.
  • Sections: Touying's built-in section support can be used to display the current section title and show progress.
    • section and subsection parameter in #slide to register a new section or subsection.
    • states.current-section-title to get the current section.
    • states.touying-outline or s.methods.touying-outline to display a outline of sections.
    • states.touying-final-sections(sections => ..) for custom outline display.
    • states.touying-progress-with-sections((current-sections: .., final-sections: .., current-slide-number: .., last-slide-number: ..) => ..) for powerful progress display.
  • Navigation bar: Navigation bar like here by states.touying-progress-with-sections(..), in dewdrop theme.
  • Pdfpc: pdfpc support and export .pdfpc file without external tool by typst query command simply.