与其对文本应用显式格式,不如将一段文本封闭在非格式化元素中。这种标记被称为文本范围(以前称为_未引用文本_)。它的目的是允许诸如角色和ID之类的属性应用于未格式化的文本。尽管这些属性仍然可以用来对文本应用样式。

文本跨度语法

当文本被一对单个或双重井号(#)包围 至少有一个角色时,角色将会被应用到该文本上,而不添加任何其他隐含的格式化。

Caution
如果没有属性列表,格式对将被解释为突出显示的文本
文本跨度语法
Unresolved directive in text-span-built-in-roles.adoc - include::example$text.adoc[tag=text-span]

文本跨度语法 转换为HTML时,它会被翻译成以下输出。

Text span HTML输出
Unresolved directive in text-span-built-in-roles.adoc - include::example$text.adoc[tag=text-span-html]

正如您所见,提供此元素的样式取决于样式表。通常,这意味着您需要定义自定义内联样式,以映射到相应的类。在这种情况下,由于 underline 是一个内置角色,样式已为您提供。

内置的文本角色

AsciiDoc 语言提供了一些内置的角色,你可以使用这些角色为文本提供格式化提示。虽然这些角色经常与文本跨度一起使用,但它们也可以与接受角色的任何其他格式化文本一起使用。

Warning
不是所有的转换器都能识别这些角色,不过你至少可以期待它们被HTML转换器支持。

这些角色如下:

下划线

将下划线装饰应用于文本的范围。

上划线

给文本区域上方添加一条上划线装饰。

删除线

应用一条贯穿文字的删除线(又称为中划线)装饰到文本的范围。

不间断

禁止文本范围内的单词被拆分。

不换行

防止文本段落进行任何换行。

保留空白

阻止连续的空格和类似空格的字符被压缩(即,所有空格都会被保留)。

有几个内置的角色曾经在AsciiDoc中得到支持,但后来已经被弃用。这些角色包括`big`、small、指定的颜色(例如,aqua),以及指定的背景颜色(例如,aqua-background)。你应该创建你自己的语义角色来代替这些被弃用的角色。