软换行属性值

如果文档属性的值太长而无法在屏幕上完全显示,你可以通过行继续符将值分割成多行,以便于阅读。

一条 连续线 由一行末尾跟随一个空格和一个反斜杠字符 (\) 组成。连续线必须放置在多行值的每一行的末尾,除了最后一行。跟在连续线字符后面的行可以进行缩进,但是该缩进不会包含在值中。

当处理器读取属性值时,它会将行续行、换行符以及任何随后的缩进合并为一个空格。在这种情况下,我们可以说属性值具有软换行。

假设我们想要定义一个名为`description`的属性,它有一个很长的值。我们可以通过在值的每一行(最后一行除外)的末尾放置一个行继续符号来把这个属性分成多行。

一个具有软换行的多行属性值
:description: 如果你在文档中有一行非常长的文本\
需要定期替换,\
你可能会发现在头部整齐地分割这个值\
这样对于查看AsciiDoc源码的人来说会更易于阅读。

如果连续的行缺失了,处理器会假定它已经找到了属性值的末尾,并且不会包含后续的行到属性值中。

强制换行属性值

您可以通过在行续连接符前插入硬换行符来强制属性值进行硬换行。硬换行符是一个空格后面跟着一个加号(+)字符。

如前一节所述,行续行、换行和随后的缩进通常会被替换成一个空格。这将阻止硬换行替换被识别。然而,处理器会考虑到这种情况,并保持换行不变。

假设我们想要定义一个名为`haiku`的属性,它需要固定的换行符。我们可以将这个属性的值分成多行,并通过在每行值的末尾(最后一行除外)放置一个硬换行符替换和一个行延续符来保留这些换行符。

一种具有硬换行的多行属性值
用文本书写你的文档,
AsciiDoc 使它变得简单,
现在,回去工作吧!

这种语法确保了在输出中保留了换行符作为硬换行。