如何在 asciidoctor-pdf 的同一页上保留列表项?
How to keep list item on same page in asciidoctor-pdf?
我正在使用 asciidoc 整理一些用户文档。我需要以 PDF 结尾;我在 Ubuntu 上使用 asciidoctor-pdf(Asciidoctor PDF 1.5.0.alpha.18 使用 Asciidoctor 1.5.5)
我有 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 不同的工具链吗??
想到的第一个技巧就是隐藏示例块的边框和背景,只要块样式足以将您的内容保持在一起即可。类似于:
example:
border_color: ffffff
border_radius: 0
border_width: 0
background_color: ffffff
padding: 0
如果您期望像这样的需求更多,Asciidoctor 还提供的 DocBook > PDF 链可能更适合您。在该过程的另一端,您有 XSLT,它比 Prawn-based asciidoctor-pdf 配置强大得多。请注意,该路线可能需要对输出进行更多自定义,以使其看起来 modern/elegant 与 asciidoctor-pdf 的方式相同(IMO,无从属关系)。
我正在使用 asciidoc 整理一些用户文档。我需要以 PDF 结尾;我在 Ubuntu 上使用 asciidoctor-pdf(Asciidoctor PDF 1.5.0.alpha.18 使用 Asciidoctor 1.5.5)
我有 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 不同的工具链吗??
想到的第一个技巧就是隐藏示例块的边框和背景,只要块样式足以将您的内容保持在一起即可。类似于:
example:
border_color: ffffff
border_radius: 0
border_width: 0
background_color: ffffff
padding: 0
如果您期望像这样的需求更多,Asciidoctor 还提供的 DocBook > PDF 链可能更适合您。在该过程的另一端,您有 XSLT,它比 Prawn-based asciidoctor-pdf 配置强大得多。请注意,该路线可能需要对输出进行更多自定义,以使其看起来 modern/elegant 与 asciidoctor-pdf 的方式相同(IMO,无从属关系)。