Selecting canvas content
A mark belongs on the canvas when seeing it changes what the reader understands, and the detail holds as a picture on its own.
On this page
#A mark's effect on the reader's understanding
A mark belongs on the canvas when its presence changes what the reader understands. Relevance and accuracy are not enough: a mark whose removal leaves the argument just as clear is decoration, and it competes for attention with the marks carrying the argument.
#The detail read on its own
A detail can be opened full screen, without the narrative beside it, so what is on the canvas has to hold as a picture: the marks named by their own label:, the axes saying what they hold (x axis label:, y axis label:). The body is what a lecturer says and the detail is what is on the board, and a board that reads only while someone talks over it is a board with the labels missing.
#Decoration
- Restating the prose. A
textmark repeating the sentence beside it adds nothing to it. - Furniture the argument never uses. Gridlines, axes and tick numbers nothing in the prose reads.
show-grid,show-axesandshow-ticksturn each off; Framing a readable graph says which ticks a graph needs. - Everything at once. Four curves drawn together where the argument concerns one at a time. A
cuebrings each in as the prose reaches it — Steps, timers, sweeps & parameters.
#Two environments, and direction: auto
A detail holds two canvas environments as a split, or up to nine in a grid, and the compiler refuses a third beside the first two:
scene{
Three powers of x.
}[
graph{
curve(expression: x^2)
}
graph{
curve(expression: x^3)
}
graph{
curve(expression: x^4)
}
][semantic]A scene detail holds at most two canvas environments; found 3 — a grid holds up to nine
Written in a grid, the three stand together:
scene{
Three powers of x.
}[
grid{
graph{
curve(expression: x^2)
}
graph{
curve(expression: x^3)
}
graph{
curve(expression: x^4)
}
}
]A split's direction is best left at auto. The canvas is read twice — in the column beside the prose, and full screen when the internote is presented — and auto stacks the pair in the first and sets them side by side in the second. An explicit horizontal or vertical fixes the arrangement that looked right in whichever view the author wrote it in, and is wrong in the other. It is worth writing only where the axis of the split is part of what the scene says.
#Returning to an environment
A later scene returning to the same subject continues the earlier environment by its id — continue: #projectile — so the reader keeps the view they explored and the elements they added rather than meeting a reset canvas. scene documents what carries over.