PDF Ausgabe von AsciiDoc Dokumenten

1. Zur PDF-Vorschau wechseln

Klicken Sie auf den Pfeil neben dem Augensymbol in der oberen Symbolleiste und wählen Sie "PDF" im Dropdown-Menü aus.

2. Struktur anpassen

Das PDF lässt sich nun an Ihre Wünsche anpassen:

  • Mit :title-page: erzeugen Sie eine eigene Titelseite im PDF.

  • Mit :title-logo-image: und :front-cover-image: lassen sich Bilder für die Titelseite oder das Cover hinzufügen.

  • :pagenums: definiert, ob bzw. wo Seitenzahlen angezeigt werden sollen.

3. Gestaltung in CSS

Eine Besonderheit in adoc Studio ist die CSS Gestaltung. Im Gegensatz zu anderen AsciiDoc Konvertern werden alle Gestaltungsanweisungen im gleichen CSS wie für die HTML Ausgabe umgesetzt. Nutzen Sie dafür Media Querie, um PDF-spezifische Regeln anzuwenden. Ein Beispiel:

@media vivliostyle {
    @page {
        size: var(--ads-page-size, A4 portrait);
        margin: var(--ads-page-margin, 2cm);
    }

4. Fußnoten und Endnoten

  • Fußnoten: Erscheinen am unteren Rand jeder Seite im PDF. Verwenden Sie in AsciiDoc footnote:[Hier Notiz einfügen].

  • Endnoten: Alle Notizen werden am Ende des Dokuments gesammelt. Nutzen Sie endnote:[Hier Notiz einfügen]] und konfigurieren Sie sie so, dass sie ganz am Ende der Datei erscheinen.

  • Die Position der Fußnoten lässt sich ebenfalls über das Attribut :footnotes-position: bestimmen

Tipp: Setzen Sie eine ID an Fuß- oder Endnoten, um an mehreren Stellen auf sie zu verweisen.

  1. Setzen Sie footnote:ID[Hier Notiz einfügen] oder endnote:ID[Hier Notiz einfügen] im Text

  2. ID ist nur ein Platzhalter, geben Sie ihm einen eindeutigen Namen, um unerwünschte Verweise zu vermeiden.

  3. Nun müssen Sie an weiteren Stellen lediglich footnote:ID[] schreiben und die Fußnote führt stets auf die gleiche Referenz.

Zurück
Weiter