静态站点生成器的前言部分

许多静态网站生成器（例如，Jekyll，Middleman）依赖于添加到文档顶部的*前 matter* 来确定如何转换内容。前 matter 通常从文件的第一行开始，并由块定界符（例如 ---）界定。

这是一个包含前言部分的文档的例子。

---  (1)
layout: default (2)
---  (3)
= 文件标题

内容

  1. 前言部分开头定界符

  2. 前言数据

  3. 前言部分结束分隔符

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

跳过前言属性

如果通过API或命令行接口（例如，-a skip-front-matter）设置了`skip-front-matter`属性，Asciidoctor将会识别前言部分，并在解析文档之前消耗它。Asciidoctor将提取的内容存储在`front-matter`属性中，以便于集成使用。当读取include files时，Asciidoctor也会移除前言部分。