PDF Output

Switching to PDF Preview

Click the arrow next to the eye icon in the top toolbar and select "PDF" from the dropdown menu. The preview now shows the exact PDF layout.

pdf output

Customizing PDF Structure

With special attributes, you can adapt the PDF output to your requirements:

Attribute Effect

:title-page:

Creates a separate title page

:pagenums:

Displays page numbers

:toc:

Inserts a table of contents

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

Sets a cover image

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

Places a logo on the title page

Example for a complete document header:

= My Manual
:title-page:
:pagenums:
:toc:
:title-logo-image: image:logo.png[width=150]

Styling with CSS

A special feature of adoc Studio is the CSS-based PDF rendering. Unlike other AsciiDoc converters, you use the same CSS for HTML and PDF.

For PDF-specific adjustments, use media queries:

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

Footnotes and Endnotes

  • Footnotes appear at the bottom of each page: footnote:[Your note here]

  • Endnotes are collected at the end of the document: endnote:[Your note here]

You can control the position of footnotes with the :footnotes-position: attribute:

  • :footnotes-position: page – At the page bottom (default)

  • :footnotes-position: document – At the document end

With <<< on its own line, you force a page break at a specific location.

Accessible PDFs (PDF/UA)

PDF/UA stands for "Universal Accessibility" and is an international ISO standard (ISO 14289) for accessible PDF documents. The goal is to make documents accessible to everyone – including people with disabilities.

To create accessible PDFs, activate the attribute in the document header:

:ads-pdf-ua:

Nothing more is necessary. adoc Studio then automatically adds the required accessibility information during export.

In PDF preview, documents are not PDF/UA compliant – the accessibility information is only integrated during export.
More about PDF/UA can be found on Wikipedia and in the Manual.