0

我正在使用 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 不同的工具链吗？

4

1 回答 1

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，无从属关系）。

于 2019-07-20T00:53:08.870 回答