«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.