在这个页面上,你将学到:

  • ✓ 如何用AsciiDoc标记一个示例区块。

一个示例块对于视觉上划分说明概念或显示操作结果的内容是有用的。

一个例子可以包含任何类型的内容和AsciiDoc语法。普通的替换规则适用于例子的内容。

例子样式语法

如果示例内容是连续的,即没有被空行打断,块样式名 example 可以直接放置在文本顶部的属性列表([])中。

将样式块指定为段落
.Optional title
[example]
This is an example of an example block.

The result of 将样式块指定为段落 is displayed below.

可选标题
这是一个示例块的例子。

分隔示例语法

如果示例内容包括多个块或由空行分隔的内容,请将内容置于由四个等号(====)组成的分界线之间。

当你使用示例分隔符时,你不需要设置块样式名称。

示例块分隔符语法
拟声词
====
书本落到地板上发出了一个“砰”的声音。

他能听到鸽子在松树的枝头*咕咕*地叫。

示例块分隔符语法 的结果如下所示。

拟声词

书本落到地板上发出了一个“砰”的声音。

他可以听见鸽子在松树枝头*咕咕*地鸣叫。

Tip
'''复杂警告 使用分隔的示例语法。'''