默认的Asciidoctor样式表通过应用CSS white-space: pre-wrap
和 word-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: pre
和 word-wrap: normal
。
结果:应用了不换行选项的列表区块
Unresolved directive in verbatim-line-wrap.adoc - include::example$wrap.adoc[tag=nowrap]
为了防止全局换行,取消文档上的`prewrap`属性设置。
全局禁用预包装(从而启用不换行)
:prewrap!:
当prewrap属性未设置时,nowrap`类会被添加到任何
<pre>`元素中。
现在,你可以使用最适合你和你的读者的换行策略。