waypoint
waypoint(lbl, advance: true, start: auto)(source)Waypoints (by Zral0kh)
Declare a named waypoint in the slide's subslide sequence.
A waypoint names a set of subslide positions so that it can be referred to
by label in uncover, only, effect, alternatives, and other animation
functions. This lets you avoid counting subslide numbers manually.
By default, a waypoint call also acts as a #pause (advancing to the next subslide).
Set advance: false to mark the current position without advancing.
A waypoint covers all subslides from its declaration until the next waypoint is declared (or the end of the slide).
You can also set the starting subslide of a waypoint with the start argument, which allows for more flexible control, independent of how your content may be structured. Circular waypoint dependencies will panic!
Thus passing start will basically act like a jump(start) at the position of the waypoint.
Note that your labels need to be slide-unique. They need not be globally unique, but must be unique within a single slide.
You can use hierarchical labels with : separators (e.g. <part:intro>).
When referencing <part>, all waypoints starting with part: are combined.
Example:
Some content
#waypoint(<reveal>)
#uncover(<reveal>)[Revealed content]
#waypoint(<highlight>)
#effect(text.with(fill: red), <highlight>)[Highlighted]
lbl : label
The label for this waypoint.
advance : bool default: true
If true (default), acts as a #pause before marking. If false, marks the current subslide position without advancing.
start : auto | int | label default: auto
The starting subslide for this waypoint. By default the location in the content and depends on advance. If set ignores advance and allows to specify a subslide index or a waypoint.
Returns: content