Как сохранить элемент списка на той же странице в asciidoctor-pdf?

Я использую asciidoc для составления пользовательской документации. Мне нужно получить PDF; Я использую asciidoctor-pdf в Ubuntu (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??


asciidoc asciidoctor asciidoctor-pdf
person fovea1959    schedule 16.07.2019    source источник

Ответы (1)


arrow_upward
1
arrow_downward

Первый лайфхак, который приходит на ум, — это просто скрыть границу и фон блока примера от просмотра, если стиля блока достаточно, чтобы сохранить содержимое вместе. Что-то типа:

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

Цепочка DocBook > PDF, которую также предоставляет Asciidoctor, может лучше подойти вам, если вы ожидаете гораздо больше потребностей, подобных этому. На другом конце этого процесса у вас есть XSLT, который намного мощнее, чем конфигурация asciidoctor-pdf на основе Prawn. Имейте в виду, что этот маршрут может потребовать дополнительной настройки вывода, чтобы он выглядел современно/элегантно, как это делает asciidoctor-pdf (IMO, без принадлежности).

person Brian D    schedule 20.07.2019
comment
Бинго! Поместите это в файл «extends-theme.yml», добавьте строку extends: default в начало и просто сделайте asciidoctor-pdf -a pdf-style=./extends-theme.yml master.adoc - person fovea1959; 22.07.2019