1. Введение
В этой быстрой статье мы покажем, как создать книгу из документа AsciiDoc и как настроить книгу с помощью различных параметров стиля.
Если вы не знакомы с AsciiDoc в Java, вы можете прочитать наше введение в AsciiDoctor .
2. Тип внутренней книги
Самый простой способ создать книгу с помощью AsciiDoctorj — это использовать Maven, как в ранее упомянутой статье. Единственная разница в том, что вы должны указать тег doctype и установить его в «book».
<backend>pdf</backend>
<doctype>book</doctype>
С определенным типом документа AsciiDoctorj знает, что вы хотите создать книгу, поэтому создает:
- Титульный лист
- Содержание
- Первая страница основного содержания
- Части и главы
Чтобы получить упомянутые части, документ Asciidoc должен иметь определенные заголовок, разделы и другие части, которые являются нормальными для книги.
3. Определение пользовательского стиля
При написании книги естественно, что мы хотим использовать некоторые пользовательские стили. Это можно сделать с помощью специального языка форматирования AsciiDoc, определенного в простом файле YAML.
Например, этот фрагмент кода определяет, как будет выглядеть каждая страница в книге. Нам нужен портретный режим, поля 0,75 дюйма сверху и снизу и поля 1 дюйм по бокам на бумаге формата A4:
page:
layout: portrait
margin: [0.75in, 1in, 0.75in, 1in]
size: A4
Кроме того, мы можем определить собственный стиль для нижнего и верхнего колонтитула книги:
header:
height: 0.5in
line_height: 1
recto_content:
center: '{document-title}'
verso_content:
center: '{document-title}'
footer:
height: 0.5in
line_height: 1
recto_content:
right: '{chapter-title} | *{page-number}*'
verso_content:
left: '*{page-number}* | {chapter-title}
Дополнительные параметры форматирования можно найти на странице Github AsciiDoctorj .
Чтобы включить пользовательскую тему в процесс создания книги, мы должны определить путь, по которому находится наш файл стиля. Местоположение указано в части атрибутов в pom.xml:
<pdf-stylesdir>${project.basedir}/src/themes</pdf-stylesdir>
<pdf-style>custom</pdf-style>
Первая строка определяет путь, по которому определяется наш стиль, а вторая строка указывает имя файла без расширения.
С этими изменениями наш pom.xml выглядит так:
<configuration>
<sourceDirectory>src/docs/asciidoc</sourceDirectory>
<outputDirectory>target/docs/asciidoc</outputDirectory>
<attributes>
<pdf-stylesdir>${project.basedir}/src/themes</pdf-stylesdir>
<pdf-style>custom</pdf-style>
</attributes>
<backend>pdf</backend>
<doctype>book</doctype>
</configuration>
4. Создание книги
Чтобы сгенерировать книгу, вам просто нужно запустить Maven в каталоге проекта, а сгенерированную книгу можно найти в каталоге target/docs/asciidoctor/ .
5. Вывод
В этом уроке мы показали вам, как с помощью Maven создать книгу, оформленную в простом стиле.
Как всегда, код из этой статьи можно найти на GitHub .