yaml

YAMLファイルから構造化データを読み込む。

読み込むファイルには有効なYAMLオブジェクトまたは配列が含まれていなければなりません。 YAMLの値は、下の表に示す対応するTypstの値に変換されます。

この関数は辞書、配列、またはYAMLファイルの内容に応じた別のYAMLデータ型を返します。

この例におけるYAMLファイルには著者名をキーとするオブジェクトが含まれており、 それぞれの著者にはtitleとpublishedというキーを持つ サブマッピングのシーケンスが含まれています。

例

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

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

変換の詳細

注意事項

• 多くの場合、YAMLの数値は整数か小数かに応じてfloatまたはintに変換されます。 ただし、2⁶³-1より大きい（または-2⁶³より小さい）整数は 浮動小数点数に変換されるため、近似値になる可能性があります。

• カスタムYAMLタグは無視されますが、読み込まれた値はそのまま保持されます。

• bytesは性能と可読性のためYAMLシーケンスとしてはエンコードされません。 バイナリデータにはcbor.encodeを検討してください。

• repr関数はデバッグ目的のみで、 出力の安定性はTypstのバージョン間で保証されません。