与其对文本应用显式格式,不如将一段文本封闭在非格式化元素中。这种标记被称为文本范围(以前称为_未引用文本_)。它的目的是允许诸如角色和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
)。你应该创建你自己的语义角色来代替这些被弃用的角色。