序言

文档标题 结尾和文档正文中的第一个章节标题之间的内容被称为前言。前言是可选的。

序言
Unresolved directive in preamble-and-lead.adoc - include::example$preamble.adoc[]

当使用默认的Asciidoctor样式表时,如果第一段没有显式的角色,它就会被设计得好像它有领先角色序言的结果如下所示。

文档的序言

主角

将`lead`角色应用于任何段落,它将使用较大的字体大小进行渲染。lead 角色被分配给 role attribute。您可以使用经典方法或速记方法设置`role`。

使用简写语法将角色设置为领导。
Unresolved directive in preamble-and-lead.adoc - include::example$paragraph.adoc[tag=lead]

使用简写语法将角色设置为领导。的结果如下所示。”

段落应用了领先角色值的样式。

当你使用默认样式表将文档转换为HTML时,preamble的第一段自动被设置为引导段落样式。要禁用此行为,请为第一段分配任何角色。

禁用自动前导段落样式
Unresolved directive in preamble-and-lead.adoc - include::example$paragraph.adoc[tag=no-lead]

自定义角色(normal)的存在告知CSS不要将其作为引导段落进行样式设置。