在AsciiDoc中,相邻的普通文本行在转换时会合并成一个单独的段落。这意味着你可以在源文档中包裹段落文本,无论是在特定的列上还是将每个句子或短语放在自己的行上。分隔相邻行的换行符不会出现在输出中。相反,换行符会被转换为一个空格。(实际上,所有重复的空格字符都会被减少到一个单一的空格,就像在HTML中一样。)
如果您希望段落中的换行符得以保持,可以使用几种技术。对于任何单独一行,您可以在其末尾添加一个空格加上加号(即 {plus}
)。这种语法向处理器发出信号,在输出中以硬换行结束该行。要将这种行为应用到段落的每一行,请直接在段落中设置`hardbreaks`选项。或者,您可以通过设置文档的`hardbreaks-option`属性,告诉处理器保留文档中每个段落的所有换行符,不过应谨慎使用这个选项。
要在段落中的某个地方插入一个空行,你可以使用硬换行语法(即,{empty}{plus}
)单独放在一行上。这允许你在输出中的行之间插入空间,而不引入独立的段落。
内联换行语法
为了在段落中保留一个换行符,可以在行末插入一个空格再加上加号(+
)。这将导致在该行之后出现一个可见的换行(例如,<br>
)。
Unresolved directive in hard-line-breaks.adoc - include::example$paragraph.adoc[tag=hb]
结果显示在下面。
Unresolved directive in hard-line-breaks.adoc - include::example$paragraph.adoc[tag=hb]
硬换行选项
要保留整个段落中的所有换行符,请使用属性列表将`hardbreaks`选项分配给该段落。
Unresolved directive in hard-line-breaks.adoc - include::example$paragraph.adoc[tag=hb-p]
The result of 使用hardbreaks选项保留换行 is displayed below.
Unresolved directive in hard-line-breaks.adoc - include::example$paragraph.adoc[tag=hb-p]
硬换行选项属性
为了在整个文档的所有段落中保持换行符,可在文档头部设置`hardbreaks-option`文档属性。
Unresolved directive in hard-line-breaks.adoc - include::example$paragraph.adoc[tag=hb-attr]