Названия глав в заголовке документа, сгенерированного Asciidoctor-PDF

Мне нужно добавить заголовок главы в заголовок страницы файлов PDF, созданных с помощью Asciidoctor-toPDF. Вот набор свойств, которые я использую в начале своего документа:

= Book title
:notitle:
:toc: left
:toclevels: 8 
:sectnums:
:sectnumlevels: 8
:source-highlighter: coderay 
:icons: font
:chapter-label:
:header_recto_content_center: '{section-title}'

Есть ли какое-либо свойство, которое мне не хватает или которое конфликтует с генерацией заголовка?


person Carla    schedule 26.02.2020    source источник


Ответы (1)


Несколько атрибуты, связанные с темой, существуют. Но header, к сожалению, не один из них.

Таким образом, чтобы оформить заголовок PDF, нужно прибегнуть к пользовательскому стилю в формате YAML.

Стиль

В этом примере файл называется style.yml и помещается в наш рабочий каталог.

extends: default   #1

header:
  height: 15mm     #2
  recto: &header   #3
    center-content: '-- {section-or-chapter-title} --' #4
  verso: *header   #5
  1. Расширяет тему asciidoctor-pdf по умолчанию с помощью вашего индивидуального кода.
  2. Определите высоту заголовка, иначе содержимое не будет отображаться; также объясняется здесь .
  3. Создайте привязку YAML ко всему содержимому recto.
  4. Использование {section-or-chapter-title} объясняется и показано в конце поста.
  5. Ссылайтесь на контент из &header. Проще говоря, заставить verso вести себя так же, как recto.

Документ

Содержимое файла adoc показано ниже. Файл называется book.adoc и находится в том же каталоге, что и style.yml.

= Book title
:notitle:
:toc: left
:toclevels: 8 
:sectnums:
:sectnumlevels: 8
:source-highlighter: coderay 
:icons: font
:chapter-label:

== Chapter One

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy 
eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam 
voluptua.

== Chapter Two

=== Section One

Lorem ipsum dolor sit amet, consetetur sadipscing elitr, sed diam nonumy 
eirmod tempor invidunt ut labore et dolore magna aliquyam erat, sed diam 
voluptua.

Преобразование

Преобразование PDF выполняется с использованием атрибутов pdf-stylesdir и pdf-style.

asciidoctor-pdf -a pdf-stylesdir=. -a pdf-style=style.yml -d book book.adoc

Результат

Тогда первая глава выглядит так, как показано на скриншоте. Поскольку заголовка раздела нет, глава используется для заполнения заголовка.

введите здесь описание изображения

Вторая глава, в которой определены и глава, и раздел, отображает заголовок раздела в заголовке.

введите здесь описание изображения

person uroesch    schedule 21.12.2020