字面块按照您在源代码中看到的方式准确显示您编写的文本。字面文本被视为预格式化文本。该文本以固定宽度的字体呈现,且保留了换行符。只有在文档转换时,特殊字符和标注才会被替换。
字面样式可以通过以下任何方法应用到内容中:
-
将一个段落的第一行缩进一个或多个空格,
-
通过属性列表对块设置`literal`风格,或者
-
将内容包裹在一对字面块定界符(
....
)内。
缩进方法
当一行文本以一个或多个空格开始时,它会被显示为一个原样区块。这种方法是插入简单代码片段的一种简便方式。
使用缩进指示文本字面值
Unresolved directive in literal-blocks.adoc - include::example$literal.adoc[tag=indent]
使用缩进指示文本字面值的结果如下所示。
Unresolved directive in literal-blocks.adoc - include::example$literal.adoc[tag=indent]
字面风格语法
通过在块上使用属性列表设置样式属性`literal`,可以将文字样式应用于一个块,例如一个段落。
字面样式语法
Unresolved directive in literal-blocks.adoc - include::example$literal.adoc[tag=style]
字面样式语法的结果如下呈现。
Unresolved directive in literal-blocks.adoc - include::example$literal.adoc[tag=style]
限定的文本块
最后,你可以通过在你想要渲染为文字的内容外围加上一对文字块分隔符(....
)来实现。当内容包含空行时,这种方法特别有用。
限定字面块语法
Unresolved directive in literal-blocks.adoc - include::example$literal.adoc[tag=block]
限定字面块语法 的结果在下面呈现。
Unresolved directive in literal-blocks.adoc - include::example$literal.adoc[tag=block]
请注意,在输出中,加粗文本格式并没有应用于文本,三个连续的句点也没有被替换为省略号Unicode字符。