Несколько атрибуты, связанные с темой, существуют. Но 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
- Расширяет тему
asciidoctor-pdf
по умолчанию с помощью вашего индивидуального кода.
- Определите высоту заголовка, иначе содержимое не будет отображаться; также объясняется здесь а>.
- Создайте привязку YAML ко всему содержимому
recto
.
- Использование
{section-or-chapter-title}
объясняется и показано в конце поста.
- Ссылайтесь на контент из
&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
Результат
Тогда первая глава выглядит так, как показано на скриншоте. Поскольку заголовка раздела нет, глава используется для заполнения заголовка.
![введите здесь описание изображения](https://i.stack.imgur.com/9o8hK.png)
Вторая глава, в которой определены и глава, и раздел, отображает заголовок раздела в заголовке.
![введите здесь описание изображения](https://i.stack.imgur.com/PIpQY.png)
person
uroesch
schedule
21.12.2020