Start revising book

book/src/IMPORT.typ

@@ -1 +1 @@
-#import "@preview/polylux:0.3.1": *
+#import "@preview/polylux:0.4.0": *

book/src/SUMMARY.md

@@ -8,7 +8,7 @@
   - [General syntax](./dynamic/syntax.md)
   - [Complex rules](./dynamic/complex.md)
   - [Helper functions](./dynamic/helper.md)
-    - [pause](./dynamic/pause.md)
+    - [later](./dynamic/later.md)
     - [one-by-one and friends](./dynamic/obo-lbl.md)
     - [alternatives](./dynamic/alternatives.md)
   - [Cover mode](./dynamic/cover.md)

book/src/diy/diy.md

@@ -14,14 +14,11 @@ the font size to something readable from the last row:
 #set text(size: 25pt)
 ```
 We should be ready do go to create some actual slides now.
-We will use the function `polylux-slide` for this, which is kind of at the core
+We will use the function `slide` for this, which is kind of at the core
 of this package.
 ```typ
-// Remember to actually import polylux before this!
-
-#polylux-slide[
-  Hello, world!
-]
+// Remember to actually import Polylux before this!
+{{#include hello-world.typ:6:8}}
 ```
 And here is the result (the gray border is not part of the output but it makes
 the slide easier to see here):
@@ -32,35 +29,22 @@ talk they are attending.
 Also, let us choose a nicer font and maybe add some colour?
 We modify the `#set page` and `#set text` commands for that:
 ```typ
-#set page(paper: "presentation-16-9", fill: teal.lighten(90%))
-#set text(size: 25pt, font: "Blogger Sans")
-
-#polylux-slide[
-  #set align(horizon + center)
-  = My fabulous talk
-
-  Jane Doe
-
-  Conference on Advances in Slide Making
-]
+{{#include title-slide.typ:3:18}}
 ```
 ![titleslide](title-slide.png)
 Not bad, right?
 Another thing that is usually a good idea is to have a title on each slide.
 That is also no big deal by using off-the-shelf Typst features, so let's modify
 our first slide:
 ```typ
-#polylux-slide[
-  == My slide title
-  Hello, world!
-]
+{{#include slide-title.typ:15:18}}
 ```
 This is starting to look like a real presentation:
 ![slidetitle](slide-title.png)
 
 ## So what?
 To be honest, everything we did so far would have been just as easy without
-using polylux at all.
+using Polylux at all.
 So why should you care about it?
 
 Consider the following situation:
@@ -69,56 +53,27 @@ of some text changes, or some other small-sized change.
 Would you like to duplicate the whole slide just so to create this affect?
 And then maintain multiple copies of the same content, making sure never to
 forget updating all copies when your content evolves?
-Of course you wouldn't and, gladly, polylux can handle this for you.
+Of course you wouldn't and, gladly, Polylux can handle this for you.
 
 This kind of feature is called **dynamic content** or **overlays** (loosely
 speaking, you might also say **animations** but that might be a bit of a stretch,
 nothing actually "moves" on PDF pages).
 
-So how does that work in polylux?
+So how does that work in Polylux?
 As a quick example, let's add a little quiz to our slides:
 ```typ
-#polylux-slide[
-  == A quiz
-
-  What is the capital of the Republic of Benin?
-
-  #uncover(2)[Porto-Novo]
-]
+{{#include quiz.typ:20:27}}
 ```
 ![quiz](quiz.png)
 Note how two more slides have been created even though we declared only one.
 
-The next sections will explain dynamic content in polylux in all its details.
+The next sections will explain dynamic content in Polylux in all its details.
 
 For reference, here is the full source code for the slides we developed in this
 section:
 ```typ
 {{#include ../IMPORT.typ}}
 
-#set page(paper: "presentation-16-9", fill: teal.lighten(90%))
-#set text(size: 25pt, font: "Blogger Sans")
-
-#polylux-slide[
-  #set align(horizon + center)
-  = My fabulous talk
-
-  Jane Doe
-
-  Conference on Advances in Slide Making
-]
-
-#polylux-slide[
-  == My slide title
-  Hello, world!
-]
-
-#polylux-slide[
-  == A quiz
-
-  What is the capital of the Republic of Benin?
-
-  #uncover(2)[Porto-Novo]
-]
+{{#include quiz.typ:3:27}}
 ```
 

book/src/diy/hello-world.typ

@@ -3,6 +3,6 @@
 #set page(paper: "presentation-16-9")
 #set text(size: 25pt)
 
-#polylux-slide[
+#slide[
   Hello, world!
 ]

book/src/diy/previews.fish

@@ -0,0 +1,4 @@
+typst-compose hello-world 1 gray --root ../../..
+typst-compose title-slide 2 gray --root ../../..
+typst-compose slide-title 2 gray --root ../../..
+typst-compose quiz 2 gray --root ../../..

book/src/diy/quiz.typ

@@ -1,26 +1,27 @@
 #import "../../../polylux.typ": *
 
 #set page(paper: "presentation-16-9", fill: teal.lighten(90%))
-#set text(size: 25pt, font: "Blogger Sans")
+#set text(size: 25pt, font: "Lato")
 
-#polylux-slide[
-  #set align(horizon + center)
+#slide[
+  #set align(horizon)
   = My fabulous talk
 
   Jane Doe
 
   Conference on Advances in Slide Making
 ]
 
-#polylux-slide[
+#slide[
   == My slide title
   Hello, world!
 ]
 
-#polylux-slide[
+#slide[
   == A quiz
 
   What is the capital of the Republic of Benin?
 
-  #uncover(2)[Porto-Novo]
+  #show: later
+  Porto-Novo
 ]

book/src/diy/slide-title.typ

@@ -1,18 +1,18 @@
 #import "../../../polylux.typ": *
 
 #set page(paper: "presentation-16-9", fill: teal.lighten(90%))
-#set text(size: 25pt, font: "Blogger Sans")
+#set text(size: 25pt, font: "Lato")
 
-#polylux-slide[
-  #set align(horizon + center)
+#slide[
+  #set align(horizon)
   = My fabulous talk
 
   Jane Doe
 
   Conference on Advances in Slide Making
 ]
 
-#polylux-slide[
+#slide[
   == My slide title
   Hello, world!
 ]

book/src/diy/title-slide.typ

@@ -1,17 +1,17 @@
 #import "../../../polylux.typ": *
 
 #set page(paper: "presentation-16-9", fill: teal.lighten(90%))
-#set text(size: 25pt, font: "Blogger Sans")
+#set text(size: 25pt, font: "Lato")
 
-#polylux-slide[
-  #set align(horizon + center)
+#slide[
+  #set align(horizon)
   = My fabulous talk
 
   Jane Doe
 
   Conference on Advances in Slide Making
 ]
 
-#polylux-slide[
+#slide[
   Hello, world!
 ]

book/src/dynamic/dynamic.md

@@ -7,7 +7,7 @@ for one slide, each with slightly different content.
 This enables us to have some basic dynamic elements on our slides.
 
 In this book, we will use the term _logical slide_ for a section of content that
-was created by one call to `#polylux-slide`, and _subslide_ for a resulting PDF
+was created by one call to `#slide`, and _subslide_ for a resulting PDF
 page.
 Each logical side can have an arbitrary amount of subslides and every subslide
 is part of exactly one logical slide.
@@ -29,6 +29,3 @@ This results in 6 PDF pages for this logical slide.
 
 In the LaTeX beamer package, the functionalities described in this part are
 called "overlays".
-
-Everything discussed here works just as well when you use themes.
-For simplicity, we will work through the material without them, though.

book/src/dynamic/item-by-item-complex.typ

@@ -0,0 +1,29 @@
+#import "../../../polylux.typ": *
+#set page(paper: "presentation-16-9")
+#set text(size: 35pt, font: "Atkinson Hyperlegible")
+
+#slide[
+#show: columns.with(3)
+
+#set list(marker: sym.arrow)
+#item-by-item[
+  - first
+  - second
+    - some
+    - detail
+  - third
+]
+#colbreak()
+
+#item-by-item[
+  + also
+  + works
+  + with `enums`
+]
+#colbreak()
+
+#item-by-item(start: 2)[
+  / and: with
+  / terms: too
+]
+]

book/src/dynamic/line-by-line.typ → book/src/dynamic/item-by-item.typ

@@ -1,9 +1,9 @@
 #import "../../../polylux.typ": *
 #set page(paper: "presentation-16-9")
-#set text(size: 50pt)
+#set text(size: 50pt, font: "Atkinson Hyperlegible")
 
-#polylux-slide[
-#line-by-line[
+#slide[
+#item-by-item[
   - first
   - second
   - third

book/src/dynamic/later.md

@@ -0,0 +1,31 @@
+# `show: later` to reveal content piece by piece
+Consider some code like the following:
+```typ
+#uncover("1-")[first]
+#uncover("2-")[second]
+#uncover("3-")[third]
+```
+The goal here is to uncover parts of the slide one by one, so that an increasing
+amount of content is shown, but we don't want to specify all subslide indices
+manually, ideally.
+
+If you have used the LaTeX beamer package before, you might be familiar with the
+`\pause` command.
+It makes everything after it on that slide appear on the next subslide.
+Features of the kind "everything after this" are handled in Typst using the
+`#show:` feature.
+Namely, `#show: some-function` uses the following content as an argument to
+`some-function`.
+Polylux provides the `later` function that makes its argument appear on the
+next subslide.
+So, we can equivalently write the above code as:
+```typ
+{{#include later.typ:6:10}}
+```
+This results in
+
+![later](later.png)
+
+`#show: later` should mainly be used when you want to distribute a lot of code
+onto different subslides.
+For smaller pieces of code, consider one of the functions described next.

book/src/dynamic/later.typ

@@ -0,0 +1,11 @@
+#import "../../../polylux.typ": *
+#set page(paper: "presentation-16-9")
+#set text(size: 50pt, font: "Atkinson Hyperlegible")
+
+#slide[
+first
+#show: later
+second
+#show: later
+third
+]