tinymist-query 0.14.18

Language queries for tinymist.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74

---
source: crates/tinymist-query/src/hover.rs
expression: content
input_file: crates/tinymist-query/src/fixtures/hover/pagebreak.typ
---
Range: 0:20:0:29

```typc
let pagebreak(
  to: none | str = none,
  weak: bool = false,
);
```


======


A manual page break.

Must not be used inside any containers.

# Example
```typ
The next page contains
more details on compound theory.
#pagebreak()

== Compound Theory
In 1984, the first ...
```

Even without manual page breaks, content will be automatically paginated
based on the configured page size. You can set [the page height](https://typst.app/docs/reference/layout/page/#parameters-height)
to `auto` to let the page grow dynamically until a manual page break
occurs.

Pagination tries to avoid single lines of text at the top or bottom of a
page (these are called _widows_ and _orphans_). You can adjust the
[`text.costs`] parameter to disable this behavior.

# Named Parameters

## to

```typc
type: "even" | "odd" | none
```

If given, ensures that the next page will be an even/odd page, with an
empty page in between if necessary.

```typ
#set page(height: 30pt)

First.
#pagebreak(to: "odd")
Third.
```

## weak (named)

```typc
type: bool
```

If `true`, the page break is skipped if the current page is already
empty.


======


[Open docs](https://typst.app/docs/reference/layout/pagebreak/)