提示:本教程存在过时问题,更详细教程请阅读 小蓝书Typst 中文社区导航 FAQ
注意:该中文文档为社区驱动的非官网文档,可能存在错译、漏译或过时等问题,请以官网文档 Documentation 为准,如发现错漏,也欢迎 您的贡献镜像)。Typst 非官方中文交流 QQ 群:793548390
Warning: the Chinese document is a community-driven non-official document, there may be mistranslation, omission or outdated problems, please refer to the official website documentation.
Typst 中文文档

numbering

Applies a numbering to a sequence of numbers.

A numbering defines how a sequence of numbers should be displayed as content. It is defined either through a pattern string or an arbitrary function.

A numbering pattern consists of counting symbols, for which the actual number is substituted, their prefixes, and one suffix. The prefixes and the suffix are repeated as-is.

Example

#numbering("1.1)", 1, 2, 3) \
#numbering("1.a.i", 1, 2) \
#numbering("I – 1", 12, 2) \
#numbering(
  (..nums) => nums
    .pos()
    .map(str)
    .join(".") + ")",
  1, 2, 3,
)
Preview

参数
参数是函数的输入,它们在函数名称后面的括号中传入。

numbering() -> any

numbering
str function
必需参数位置参数
位置参数按顺序传入,不带名称。

Defines how the numbering works.

Counting symbols are 1, a, A, i, I, , , א, , , and *. They are replaced by the number in the sequence, in the given case.

The * character means that symbols should be used to count, in the order of *, , , §, , and . If there are more than six items, the number is represented using multiple symbols.

Suffixes are all characters after the last counting symbol. They are repeated as-is at the end of any rendered number.

Prefixes are all characters that are neither counting symbols nor suffixes. They are repeated as-is at in front of their rendered equivalent of their counting symbol.

This parameter can also be an arbitrary function that gets each number as an individual argument. When given a function, the numbering function just forwards the arguments to that function. While this is not particularly useful in itself, it means that you can just give arbitrary numberings to the numbering function without caring whether they are defined as a pattern or function.

numbers
int
必需参数位置参数
位置参数按顺序传入,不带名称。
可变参数
可变参数可以多次传入。

The numbers to apply the numbering to. Must be positive.

If numbering is a pattern and more numbers than counting symbols are given, the last counting symbol with its prefix is repeated.