替代是对块的叶子内容应用的。替代决定了文本如何被解释。如果没有应用替代,文本就会按照输入的内容传递给转换器。否则,替代会转换那些文本。
替代可以替换引用、格式标记、字符和字符序列以及宏。替代按类型组织,并将这些类型打包成组。本页面提供了这些分类的概览。后续页面将详细介绍每种替代类型。
替换类型
每种替换类型都会将文本中的字符、标记、属性引用和宏替换为给定转换器的适当输出。当文档被处理时,根据块元素或内联元素被分配的替换组,最多可以执行六种类型的替换。处理器按照以下顺序运行替换:
为了方便起见,这些类型被分组并按替代组的顺序排列。
替换组
每个块级元素和行内元素都有一个默认的替换组,除非你为特定元素自定义替换,否则将应用默认替换组。《table-subs-groups》展示了在每个组中执行的替换类型。
Unresolved directive in index.adoc - include::partial$subs-group-table.adoc[]
正常置换群
正常替换组(normal
)应用于大多数AsciiDoc块和内联元素,除了在下一节中描述的组别中列出的特定元素。
头部替换组
标题替换组(header
)应用于文档头部的元数据行(作者和修订信息)。它也用于属性条目的值,无论这些条目是在文档头部还是正文中定义的。只有特殊字符、属性引用和内联pass宏在属于标题组的元素中被替换。
Tip
|
你可以在属性条目中使用内联 pass 宏来自定义应用于属性值的替换类型。 |
逐字替换组
字面意义、列表和源代码块是使用原样替换组(verbatim
)来处理的。在这些块中,只有特殊字符会被替换。
无代换组别
不转换组(none
)应用于注释块。注释中不应用任何转换。
逃避替换
AsciiDoc 语法提供了几种方法来防止替换被应用。当你想要防止标点和符号被解释为格式标记时,使用反斜杠转义标点可能就足够了。为了更全面的替换预防和控制,你可以使用内联直通宏或者直通块。