在AsciiDoc中,列表项彼此之间有自然的关联性。如果相邻行以相同的列表标记开头,即使它们之间被空行分开,它们也会被连结到同一个列表中。如果相邻行以不同的列表标记开头,即使被空行分隔,它也会被放入嵌套列表中。
这些规则使得将列表项保持在同一个列表中变得更加容易。然而,如果你想要创建分开的列表,这些规则可能会带来挑战。幸运的是,有方法可以强制改变这种行为。本页面描述的技巧适用于所有类型的列表。
使用行注释
要强行分隔列表,你可以在两个列表之间插入一个空行,并在空行的两侧各放置一个行注释(即 //
)。
这是一个示例,显示了在哪里放置行注释来分隔两个相邻的无序列表。行注释前缀后的 -
是对作者的提示,表明注释行用作“列表结束”的标记:
Unresolved directive in separating.adoc - include::example$unordered.adoc[tag=divide]
这种技术适用于分离任何类型的列表。
使用一个块属性行
开始新列表的另一种方式是在第二个列表上方放置一个块属性行(即使是一个空的),并用一个空行隔开。
这是一个示例,展示了如何通过块属性行来分隔相邻的无序列表和有序列表。
Unresolved directive in separating.adoc - include::example$unordered.adoc[tag=divide-alt]
前面的空行很重要。如果没有这个空行,有序列表将仍然嵌套在有序列表之内。如果第二个列表需要块属性,你可以将它们添加到块属性行中。
这种技术适用于分离任何类型的列表。