如何实现第零章

“第零章”的原本设计

“第零章”表示首章尚未出现，会用于首章以前的小节、图表。

#set heading(numbering: "1.1")
== 第零章的小节
= 第一章

不过若无这种内容，首章按“第零章”也无妨。

代码是死的，人是活的。虽然 counter 不能设置为负数，但我们可以直接指定整个编号。

#set heading(numbering: "第一章")
#heading(numbering: (..) => "第零章")[这对吗]
#counter(heading).update((a, ..) => a - 1)
= 你说得对
= 但是原神
#heading(numbering: (..) => "第π章")[对的兄弟]

或者显示编号的时候减去 1

#set heading(
  numbering: n => numbering("第一章", n - 1),
)
= 这对吗
= 你说得对
= 但是原神

Typst v0.14.0 需要特别更改

以上用 v0.14.0 编译时，n - 1会报告以下错误。

Number must be at least zero

这是因为n在排版收敛之前可能为零，导致n - 1是负值，让numbering报错。为避免报错，让排版继续迭代，需要把n - 1改为calc.max(n - 1, 0)或calc.abs(n - 1)，以保证非负。

参考 Why the heading number can be zero in v0.14.0-rc.2? - Questions - Typst Forum 以及 v0.14.1 更新说明 提到的 #7459。

v0.14.1 已经修复了这处回退，不再需要特别更改。