默认的Asciidoctor样式表通过应用CSS white-space: pre-wrapword-wrap: break-word 属性来包裹代码块中的长行。行将在词边界处换行,类似于大多数文本编辑器的行换行方式。这样可以避免水平滚动条,一些用户认为比行包裹更大的可读性问题。

然而,这种行为是可配置的,因为有时候你不希望列表和文字块中的行换行。

防止换行

有两种方法可以防止文本换行,改为使用水平滚动条:

  • nowrap` 块选项

  • 取消设置默认启用的`prewrap`文档属性。

你可以在文本或代码列表块上使用`nowrap`选项,以防止在HTML中进行行包裹。

不换行选项语法的列表块
Unresolved directive in verbatim-line-wrap.adoc - include::example$wrap.adoc[tag=nowrap]

当使用nowrap选项时,nowrap 类会被添加到 <pre> 元素上。这个类将CSS修改为 white-space: preword-wrap: normal

结果:应用了不换行选项的列表区块

Unresolved directive in verbatim-line-wrap.adoc - include::example$wrap.adoc[tag=nowrap]

为了防止全局换行,取消文档上的`prewrap`属性设置。

全局禁用预包装(从而启用不换行)
:prewrap!:

当prewrap属性未设置时,nowrap`类会被添加到任何<pre>`元素中。

现在,你可以使用最适合你和你的读者的换行策略。