Presentate is a package for creating presentation in Typst. It provides a framework for creating dynamic animation that is compatible with other packages. For usage, please refer to demo.pdf
Simple Usage
Import the package with
#import "@preview/presentate:0.2.0": *
and then, the functions are automatically available.
Creating slides
You can create a slide using slide
function. For simple animation, you can use pause
function to show show some content later.
The easiest is to type #show: pause
. For example,
#set page(paper: "presentation-16-9")
#set text(size: 25pt)
#slide[
Hello World!
#show: pause;
This is `presentate`.
]
which results in
You can style the slides as you would do with normal Typst document. For example,
#set page(paper: "presentation-16-9")
#set text(size: 25pt, font: "FiraCode Nerd Font Mono")
#set align(horizon)
#slide[
= Welcome to Presentate!
\ A lazy author \
#datetime.today().display()
]
#set align(top)
#slide[
== Tips for Typst.
#set align(horizon)
Do you know that $pi != 3.141592$?
#show: pause
Yeah. Certainly.
#show: pause
Also $pi != 22/7$.
]
Relative Index Specification
You can use none
and auto
to specify the index as with previous animation or after previous animation.
This is useful for modifying steps of the animation so that some contents appear with or after another.
One application is for showing contents in sync:
#slide[
= Content in Sync
#table(columns: (1fr, 1fr), stroke: 1pt)[
First
#show: pause;
I am
#show: pause;
in sync.
][
// `[]` is a dummy content.
#uncover(1, [], update-pause: true)
Second
#show: pause;
I am
#show: pause;
in sync.
#show: pause
Heheh
]
]
Package Integration
Use can use the render
function to create a workspace, and import the animation
module of Presentate to create animation with other packages.
For example, Integration with CeTZ and Fletcher
#import "@preview/cetz:0.4.1": canvas, draw
#import "@preview/fletcher:0.5.8": diagram, edge, node
#slide[
= CeTZ integration
#render(s => ({
import animation: *
let (pause,) = settings(hider: draw.hide.with(bounds: true))
canvas({
import draw: *
pause(s, circle((0, 0), fill: green))
s.push(auto) // update s
pause(s, circle((1, 0), fill: red))
})
},s)
)
]
#slide[
= Fletcher integration
#render(s => ({
import animation: *
diagram($
pause(#s, A edge(->)) #s.push(auto)
& pause(#s, B edge(->)) #s.push(auto)
pause(#s, edge(->, "d") & C) \
& pause(#s, D)
$,)
}, s,))
]
Results:
You can incrementally show the content from other package by wrap the functions in the animate
function, with a modifiers that modifies the function’s arguments to hide the content using modifier
.
For example, this molecule animation is created compatible with Alchemist package:
#import "@preview/alchemist:0.1.6" as alc
#let modifier(func, ..args) = func(stroke: none, ..args) // hide the bonds with `stroke: none`
#let (single,) = animation.animate(modifier: modifier, alc.single)
#let (fragment,) = animation.animate(modifier: (func, ..args) => none, alc.fragment) // hide the molecule with `none`
#slide[
= Alchemist Molecules
#render(s => ({
alc.skeletize({
fragment(s, "H_3C")
s.push(auto)
single(s, angle: 1)
fragment(s, "CH_2")
s.push(auto)
single(s, angle: -1, from: 0)
fragment(s, "CH_2")
s.push(auto)
single(s, from: 0, angle: 1)
fragment(s, "CH_3")
})
},s)
)
]
which results in
Versions
0.2.0
- Change the framework of animations, using one state for all cover functions.
- Introduce
render
andanimation
for more flexible package integration.
0.1.0
Initial Release
Acknowledgement
Thanks Minideck package author for the minideck
package that inspires me the syntax and examples.
Touying package authors and Polylux author for inspring me the syntax and parsing method.