typst/docs/reference/groups.yml
2023-07-02 20:07:43 +02:00

77 lines
2.5 KiB
YAML

# This is responsible for the fact that certain math functions are grouped
# together into one documentation page although they are not part of any scope.
- name: variants
display: Variants
functions: ["serif", "sans", "frak", "mono", "bb", "cal"]
description: |
Alternate typefaces within formulas.
These functions are distinct from the [`text`]($func/text) function because
math fonts contain multiple variants of each letter.
- name: styles
display: Styles
functions: ["upright", "italic", "bold"]
description: |
Alternate letterforms within formulas.
These functions are distinct from the [`text`]($func/text) function because
math fonts contain multiple variants of each letter.
- name: sizes
display: Sizes
functions: ["display", "inline", "script", "sscript"]
description: |
Forced size styles for expressions within formulas.
These functions allow manual configuration of the size of equation elements
to make them look as in a display/inline equation or as if used in a root or
sub/superscripts.
- name: underover
display: Under/Over
functions: [
"underline",
"overline",
"underbrace",
"overbrace",
"underbracket",
"overbracket",
]
description: |
Delimiters above or below parts of an equation.
The braces and brackets further allow you to add an optional annotation
below or above themselves.
- name: roots
display: Roots
functions: ["root", "sqrt"]
description: Square and non-square roots.
- name: attach
display: Attach
functions: ["attach", "scripts", "limits"]
description: |
Subscript, superscripts, and limits.
The `attach` function backs the `[$a_b^c$]` syntax that adds top and bottom
attachments to a part of an equation. Attachments can be displayed either as
sub/superscripts, or limits. Typst automatically decides which is more
suitable depending on the base, but you can also control this manually with
the `scripts` and `limits` functions.
- name: lr
display: Left/Right
functions: ["lr", "abs", "norm", "floor", "ceil", "round"]
description: |
Delimiter matching.
The `lr` function allows you to match two delimiters and scale them with the
content they contain. While this also happens automatically for delimiters
that match syntactically, `lr` allows you to match two arbitrary delimiters
and control their size exactly. Apart from the `lr` function, Typst provides
a few more functions that create delimiter pairings for absolute, ceiled,
and floored values as well as norms.