PDF Output of AsciiDoc Documents

1. Switch to PDF Preview

Click the arrow next to the eye icon in the top toolbar and select “PDF” from the dropdown menu.

2. Customize structure

The PDF can now be adapted to your requirements:

  • Use :title-page: to create your own title page in the PDF.

  • With :title-logo-image: and :front-cover-image: you can add images for the title page or the cover.

  • :pagenums: defines whether or where page numbers should be displayed.

3. Styling in CSS

A special feature of adoc Studio is the CSS design. In contrast to other AsciiDoc converters, all design instructions are implemented in the same CSS as for the HTML output. Use Media Querie to apply PDF-specific rules. An example:

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

4. Footnotes and Endnotes

  • Footnotes: Render at the bottom of each page in PDF. In AsciiDoc, use footnote:[Your note here].

  • Endnotes: Collect all notes at the document’s end with endnote:[Your note here].

  • The position of the footnotes can also be determined using the :footnotes-position: attribute

Tip: Set an ID in footnotes or endnotes to refer to them in several places.

  1. Place footnote:ID[insert note here] or endnote:ID[insert note here] in the text.

  2. ID is only a placeholder, give it a unique name to avoid unwanted references.

  3. Now you only have to write footnote:ID[] in other places and the footnote will always lead to the same reference.

Back
Next