TOC

Buch mit Asciidoctor erstellen

Ein Buch mit Asciidoctor erstellen

1. Einführung

In diesem kurzen Artikel zeigen wir Ihnen, wie Siegenerate a book from an AsciiDoc document festlegen und wie Sie Ihr Buch mit verschiedenen Stiloptionen anpassen.

Wenn Sie mit AsciiDoc in Java nicht vertraut sind, können Sie unsereIntroduction to AsciiDoctor lesen.

2. Backend-Buchtyp

Der einfachste Weg, ein Buch mit AsciiDoctorj zu erstellen, ist mit Maven, wie im vorigen Artikel beschrieben. The only difference is that you have to specify doctype tag and set it to “book”. 

pdf
book

Mit dem definierten Doctype weiß AsciiDoctorj, dass Sie ein Buch erstellen möchten, und erstellt Folgendes:

  • Eine Titelseite

  • Ein Inhaltsverzeichnis

  • Die erste Seite mit Körperinhalten

  • Teile und Kapitel

Um erwähnte Teile zu erhalten, sollte das Asciidoc-Dokument Titel, Abschnitte und andere Teile enthalten, die für ein Buch normal sind.

3. Benutzerdefinierten Stil definieren

Beim Schreiben eines Buches möchten wir natürlich ein benutzerdefiniertes Styling verwenden. Dies ist mit der AsciiDoc-spezifischen Formatierungssprache möglich, die in der einfachen YAML-Datei definiert ist.

Zum Beispiel definiert dieser Codeausschnitt, wie jede Seite in einem Buch aussehen wird. Wir möchten im Hochformat arbeiten, mit einem Rand von 0,75 Zoll oben und unten und einem Rand von 1 Zoll an den Seiten auf A4-Papier: 

page:
    layout: portrait
    margin: [0.75in, 1in, 0.75in, 1in]
    size: A4

Außerdem können wir einen benutzerdefinierten Stil für die Fußzeile und die Kopfzeile des Buches definieren: 

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}

Weitere Formatierungsoptionen finden Sie unterGithub page of AsciiDoctorj.

Um das benutzerdefinierte Design in einen Prozess zur Bucherstellung einzubeziehen, müssen Sie den Pfad definieren, in dem sich unsere Stildatei befindet. Die Position wird im Attributteil inpom.xml: angegeben 

${project.basedir}/src/themes
custom

Die erste Zeile definiert den Pfad, in dem unser Stil definiert ist, und die zweite Zeile gibt den Namen der Datei ohne Erweiterung an.

Mit diesen Änderungen sieht unserpom.xmlo aus: 


    src/docs/asciidoc
    target/docs/asciidoc
    
        ${project.basedir}/src/themes
        custom
    
    pdf
    book

4. Buch generieren

Um Ihr Buch zu generieren, müssen Sie nur Maven im Projektverzeichnis ausführen. Das generierte Buch befindet sich im Verzeichnis vontarget/docs/asciidoctor/.

5. Fazit

In diesem Tutorial haben wir Ihnen gezeigt, wie Sie mit Maven ein Buch im einfachen Stil erstellen.

Wie immer kann der Code aus diesem Artikelover on GitHub gefunden werden.

Related