包装属性条目值
软换行属性值
如果文档属性的值太长,无法在屏幕上显示,您可以通过在行的末尾使用行续接符将值分成多行,以使其更易于阅读。
一个行续接符由一个空格后跟一个反斜杠字符 (\) 组成,位于行的末尾。行续接符必须放在多行值中的每一行,除了最后一行。行续接符后面的行可以缩进,但该缩进不会包含在值中。
当处理器读取属性值时,它会将行续接符、换行符以及任何后续的缩进合并为一个空格。在这种情况下,我们可以说属性值具有软换行。
假设我们要定义一个名为 description 的属性,其值非常长。我们可以将此属性拆分成多行,在除最后一行外的每一行末尾放置一个行续接符。
示例 1. 带有软换行的多行属性值
:description: If you have a very long line of text \
that you need to substitute regularly in a document, \
you may find it easier to split the value neatly in the header \
so it remains readable to folks looking at the AsciiDoc source.
如果缺少行续接符,处理器将假定它已找到值的结尾,并且不会将后续行包含在属性值中。
硬换行属性值
您可以通过在行续接符前面插入一个硬换行替换符来强制属性值进行硬换行。硬换行替换符是一个空格后跟一个加号字符 (+)。
如上一节所述,行续接符、换行符和后续的缩进通常会替换为一个空格。这将阻止识别硬换行替换符。然而,处理器会考虑到这种情况并保留换行符。
假设我们要定义一个名为 haiku 的属性,该属性需要硬换行。我们可以将此属性拆分成多行,并通过在除最后一行外的每一行末尾放置一个硬换行替换符后跟一个行续接符来保留这些换行符。
示例 2. 带有硬换行的多行属性值
:haiku: Write your docs in text, + \
AsciiDoc makes it easy, + \
Now get back to work!
此语法确保在新行中将换行符保留为硬换行符。