跳过前导信息

静态站点生成器前置内容

许多静态站点生成器(例如 Jekyll、Middleman)依赖于文档顶部添加的 前置内容 来确定如何转换内容。前置内容通常从文件的第一行开始,并由块分隔符(例如 ---)界定。

这是一个包含前置内容文档的示例

---  (1)
layout: default (2)
---  (3)
= Document Title

content
1 前置内容起始分隔符
2 前置内容数据
3 前置内容结束分隔符

静态站点生成器会在将文档传递给 AsciiDoc 处理器进行转换之前删除这些行。然而,在工具之外,这些额外的行可能会干扰处理器。

skip-front-matter 属性

如果 skip-front-matter 属性通过 API 或 CLI(例如 -a skip-front-matter)设置,Asciidoctor 将会识别前置内容并在解析文档之前将其消耗掉。Asciidoctor 将提取的内容存储在 front-matter 属性中,以便集成可以使用。Asciidoctor 在读取 include 文件时也会删除前置内容。