yaml

从 YAML 文件读取结构和化数据

文件必须包含有效的 YAML 对象或数组。 YAML 映射将被转换为 Typst 字典，YAML 序列将被转换为 Typst 数组。 字符串和布尔值将被转换为相应的 Typst 类型值。 null 值（null、~ 或空字符串 ''）将转换为 none。 数字将根据是否为整数转化为浮点值或整数值。 自定义 YAML 标签将被忽略，但加载的值仍将存在。

示例中的 YAML 文件为一个以 author 为键，子键为 “title” 和 “published” 的对象。

举例

#let bookshelf(contents) = {
  for (author, works) in contents {
    author
    for work in works [
      - #work.title (#work.published)
    ]
  }
}

#bookshelf(
  yaml("scifi-authors.yaml")
)