PDF Ausgabe

Zur PDF-Vorschau wechseln

Klicken Sie auf den Pfeil neben dem Augen-Symbol in der oberen Werkzeugleiste und wählen Sie "PDF" aus dem Dropdown-Menü. Die Vorschau zeigt nun das exakte PDF-Layout.

pdf output

PDF-Struktur anpassen

Mit speziellen Attributen passen Sie die PDF-Ausgabe an Ihre Anforderungen an:

Attribut Wirkung

:title-page:

Erstellt eine separate Titelseite

:pagenums:

Zeigt Seitenzahlen an

:toc:

Fügt ein Inhaltsverzeichnis ein

:front-cover-image: image:cover.png[]

Setzt ein Titelbild

:title-logo-image: image:logo.png[width=200]

Platziert ein Logo auf der Titelseite

Beispiel für einen vollständigen Dokumentkopf:

= Mein Handbuch
:title-page:
:pagenums:
:toc:
:title-logo-image: image:logo.png[width=150]

Styling mit CSS

Eine Besonderheit von adoc Studio ist das CSS-basierte PDF-Rendering. Im Gegensatz zu anderen AsciiDoc-Konvertern verwenden Sie dasselbe CSS für HTML und PDF.

Für PDF-spezifische Anpassungen nutzen Sie Media Queries:

@media vivliostyle {
    body {
        font-size: 11pt;
    }
    .page-break {
        page-break-before: always;
    }
}

Fuß- und Endnoten

  • Fußnoten erscheinen am Ende jeder Seite: footnote:[Ihre Notiz hier]

  • Endnoten werden am Ende des Dokuments gesammelt: endnote:[Ihre Notiz hier]

Die Position der Fußnoten können Sie mit dem Attribut `:footnotes-position:` steuern:

  • :footnotes-position: page – Am Seitenende (Standard)

  • :footnotes-position: document – Am Dokumentende

Mit <<< auf einer eigenen Zeile erzwingen Sie einen Seitenumbruch an einer bestimmten Stelle.

Barrierefreie PDFs (PDF/UA)

PDF/UA steht für "Universal Accessibility" und ist ein internationaler ISO-Standard (ISO 14289) für barrierefreie PDF-Dokumente. Das Ziel ist, dass Dokumente für alle Menschen zugänglich sind – einschließlich Menschen mit Behinderungen.

Um barrierefreie PDFs zu erzeugen, aktivieren Sie das Attribut im Dokumentkopf:

:ads-pdf-ua:

Mehr ist nicht notwendig. adoc Studio fügt dann beim Export automatisch die erforderlichen Barrierefreiheitsinformationen hinzu.

In der PDF-Vorschau sind die Dokumente nicht PDF/UA-konform – die Barrierefreiheitsinformationen werden erst beim Export integriert.
Mehr zu PDF/UA finden Sie bei Wikipedia und im Handbuch.