就像我们在说话时强调某些单词和短语一样,我们通过使用格式和标点符号在文本中强调单词和短语。AsciiDoc 提供了一系列格式化标记,用于对文档应用视觉强调和排版标点。您可以使用内置的和用户定义的角色构建这些基本格式标记。本页涵盖了 AsciiDoc 提供的格式化标记以及应用和自定义它们的规则。

格式化术语和概念

格式标记和成对符号

一个[格式化标记](#def-format-mark.term)是一种象征性字符,例如 *_~,它表明了你想要AsciiDoc转换器应用于文本的内联样式。格式化标记是成对出现的。

一个*格式化配对*由一个相同的开头标记和结尾标记组成,它包围着你想要设置样式的文本。被格式化的文本(即被格式化配对包围的文本)可以跨越多个连续的行。

[#def-open-mark.term] 开放标记 指定了你希望样式开始的位置。[#def-close-mark.term] 闭合标记 指定了你希望样式结束的位置。

格式化配对可以嵌套,但不能重叠。如果配对重叠了,行为是未定义的,并且AsciiDoc处理器可能会产生格式错误的输出。

格式化对可以定义为受限或不受限的,这取决于它允许应用的位置。不受限的格式化对可以应用在任何位置,而受限格式化对的应用则更受限制。

限制格式化对

当一个空白字符直接在要格式化的文本之前,而一个空白字符或标点符号(,;".?!)直接跟随文本,并且文本不是以空白字符开始或结束时,可以使用[术语] 约束格式对。约束对使用单个开放标记和单个闭合标记来包含要设定样式的文本(例如,*强调*)。

例如,你使用这种形式来格式化单独站立的单词,

那是*很有力*的东西!

格式化一系列单词,

那真是*非常强烈*的东西!

或者在标点符号旁边格式化一个单词,比如感叹号。

这个东西很*强大*!

如你所见,受限对提供了更简洁的标记,但代价是使用上的限制更多(受限)。然而,在大多数情况下它应该足够,因此缩写标记是一种好处。你可以将受限对视为比不受约束对更弱的标记。

不受约束的格式配对

一个*不受限制的格式化配对*可以在文本中的任何地方使用。当不满足受限制的格式化配对的条件时,就需要使用不受限制的格式化配对。一个不受限制的配对由一个双开标记和一个双闭标记组成,它们围绕着要设置样式的文本(例如,Sara**h**)。

例如,您会使用一个不受约束的对来格式化单词中的一个或多个字母。

手册页面(man page),简称为手册页面,是一种软件文档形式。

不受约束的成对格式提供了一种更加粗暴的格式化方法,代价是更加冗长。通常情况下,当受约束的成对格式不起作用时,你会切换到不受约束的成对格式。更多关于何时使用不受约束成对格式的例子,请参阅何时应该使用不受约束的成对格式?

内联文本和标点符号样式

AsciiDoc 提供了六种内联文本样式和一种仅通过格式标记应用的标点样式。

'''Bold (type: strong)'''

加粗文本会因为使用了更粗或更深的字体,而在常规文本中显得突出。当文本需要吸引视觉扫描页面的人的注意时,加粗是非常有用的。加粗的格式标记是一个星号(*)。

Italic (type: emphasis)

为了强调一个单词或短语、引用一个说话者、或引入一个术语,文本通常会被斜体化。斜体字稍微向右倾斜,并且根据字体的不同,可能有草书风格的装饰和花饰。斜体的格式化标记是下划线(_)。

Monospace (type: monospaced)

技术内容经常需要以某种方式格式化文本,以表明它是一个命令或源代码。这种文本通常使用固定宽度(即,等宽)字体来强调。等宽格式的标记是反引号(``)。

高亮 (类型:标记)

另一种吸引对文本注意的方式是高亮显示。这种语义风格用于参考或标注目的,或者标记关键主题或要点的重要性。高亮的格式标记是一个井号(#)。

Styled phrase (type: unquoted)

将角色添加到使用高亮格式标记(#)的文本范围中,可以将其转换为可以进行样式设置的通用短语。AsciiDoc定义了几种内置角色,您可以使用这些角色来设置文本样式,转换器的样式/主题系统还允许您为自定义角色定义样式。

下标和上标(类型:下标/上标)

下标和上标文本在数学表达式和化学公式中很常见。下标的格式标记是波浪号(~)。上标的格式标记是插入号(^)。

曲线引号和撇号(类型:双/单)

默认情况下,AsciiDoc处理器输出直引号和撇号。它们可以通过添加反引号(`)作为格式提示来改变为弯引号。

引号替换

当AsciiDoc处理器遇到被指定格式标记包围的文本时,这些标记在引用替换步骤中会被相应HTML或XML元素的起始和结束标签所替换,具体取决于你的后端。你可以通过引用替换值来控制何时将内联格式应用于内联文本、宏或块。