Skip to main content

Touying 0.7.0

· 3 min read
OrangeX4
Zralokh

Touying 0.7.0 is a large release built around one major feature — named waypoints — together with a long list of animation and layout fixes.

Named waypoints​

Animations have always been addressed by subslide number, which means counting #pausees by hand and renumbering everything whenever you insert one. Named waypoints (#298, by @zral0kh) let you name a position in the animation instead.

#waypoint(<label>) marks a spot — and, like #pause, advances to the next subslide unless you pass advance: false. A waypoint covers every subslide from its declaration until the next waypoint or the end of the slide, so passing the label to uncover, only, effect or alternatives shows content for exactly that stretch. Two markers turn a waypoint into an open range: from-wp is visible from it onwards, until-wp up to just before it. Labels need only be unique within a single slide, and they may be referenced before they are declared.

#uncover(until-wp(<summary>))[Shown before the summary.]

Main content.

#waypoint(<summary>)

Summary text. #pause More summary.

#uncover(from-wp(<summary>))[Visible from the summary on.]

That is three subslides: the first shows the intro line and the main content, the second swaps it for the summary, the third adds the rest — and nothing had to be numbered. get-first and get-last pick out a single edge of a waypoint, prev-wp and next-wp shift a reference by whole waypoints, and hierarchical labels such as <part:intro> are combined when you refer to <part>. The start parameter sets where a waypoint begins independently of where it sits in the content (#304), and waypoints work in handout-subslides too.

Also new​

  • More flexible subslide numbers: specifications now accept auto and the "h" ("here") string, with an inverse function for string subslide numbers and waypoints (#301).
  • Animation functions via reducer: functions based on fn-wrapper are now implicitly allowed through the reducer (#300), making custom animation helpers easier to build.

Fixes​

  • Covers: cover-with-rect no longer breaks long lines of text when they are partially hidden, and colour and alpha covers gained fallback functions (#328). Cover spacing around lists was also fixed (#303).
  • Show rules: ghost slides caused by show rules are gone, and show rules and the defer keyword are handled consistently (#317).
  • Headings: display-current-heading uses explicit numbering when style: auto (#329).
  • Layout: alternatives-match respects stretch (#320), and page margin merging and precedence are correct (#322).
  • Plus alert no longer delayed (#316), negative subslide indices parsed correctly for handout-subslides (#307), and slide updating via a scoped import (#310).

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