如何在asciidoctor-pdf中将列表项保留在同一页面上？

Question

我正在使用asciidoc整理一些用户文档。我需要以PDF结尾；我在Ubuntu上使用asciidoctor-pdf（使用Asciidoctor 1.5.5的Asciidoctor PDF 1.5.0.alpha.18）

我有asciidoc项目符号列表；列表项中的一些是文本指令，中间点缀着小屏幕截图。我希望每个列表项都尽可能保留在同一页面上。

这些不会将所有内容保留在同一页面上

[options="unbreakable"]
* Use the virtual keyboard to enter the letters and numbers of your network password: +
image:ss/ss_password_done_blurred.png[]

这将所有内容放在同一页面上，但在整个列表项周围放了一个框：

====
* Use the virtual keyboard to enter the letters and numbers of your network password: +
image:ss/ss_password_done_blurred.png[]
====

有没有办法使普通段落或列表项牢不可破（或保持在一起）？

我需要使用与asciidoctor-pdf不同的工具链吗？

Answer 1

想到的第一个技巧是，仅从样式中隐藏示例块的边框和背景，只要块样式足以将您的内容保持在一起即可。像这样：

example:
  border_color: ffffff
  border_radius: 0
  border_width: 0
  background_color: ffffff
  padding: 0

如果您期望像这样的更多需求，则Asciidoctor还提供的DocBook> PDF链可能更适合您。在该过程的另一端，您拥有XSLT，它比基于Prawn的asciidoctor-pdf配置要强大得多。请注意，该路线可能需要对输出进行更多的自定义，以使其看起来像asciidoctor-pdf（IMO，无从属关系）一样现代/优雅。