A PDF customisation plug-in defines a new DITA-OT transformation type based on the built-in PDF conversion.

Target environment

Version of DITA-OT for which the plug-in is installed into.

XSL formatter used to generate PDF output. DITA-OT comes with open source FOP formatter.

Note that customisation features available are dependent on the target DITA-OT and XSL formatter.

Page

Margins

Page margins.

Columns

Header and footer

title
chapter
#
# (##)
Header:
title✕
Footer:
#✕

Drag fields for header and footer contents.

Not available for FOP and RenderX XEP

Page number format.

Either use a simple page number, or reset page numbering for each chapter and prefix page number with chapter number.

Layout

Chapters can be made to always start on an odd page or directly follow the previous page.

Default page count behavior for Bookmaps is to start every chapter on an odd page.

Blank pages are marked withThis page intentionally left blank text.

Chapters can start with a table of chapter contents on a separate chapter cover page.

Style

Formatting


:
:

Indents and Spacing

:
:
:
:
:
:
:
:
:
:
1 Heading 1
1.1 Heading 2
The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog.
Note: The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog.
  1. 1. The quick brown fox jumps over the lazy dog.
    1. 1. The quick brown fox jumps over the lazy dog.
      1. 1. The quick brown fox jumps over the lazy dog.
        1. 1. The quick brown fox jumps over the lazy dog.
  • •The quick brown fox jumps over the lazy dog.
    • •The quick brown fox jumps over the lazy dog.
      • •The quick brown fox jumps over the lazy dog.
        • •The quick brown fox jumps over the lazy dog.
PangramThe quick brown fox jumps over the lazy dog.
XXXThe quick brown fox jumps over the lazy dog.
The quick brown fox jumps on page 42 over the lazy dog. The quick brown fox jumps over the lazy dog.
The quick brown fox™ jumps over the lazy dog®. The quick brown fox™ jumps over the lazy dog®.
Section title
The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog.
Example title
Example content
1.1.1 Heading 3
The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog.
1.1.1.1 Heading 4
The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog. The quick brown fox jumps over the lazy dog.
The quick brown fox jumps over the lazy dog.
(defun factorial (n)
(if (<= n 1)
  1
  (* n (factorial (- n 1)))))
Table 4: Table caption
Doglazy
Foxquick, brown
Figure 6: Figure caption

Cover

Image on the cover page.

Read the cover graphic file name from map metadata field:

<data name="cover-image"> <image href="cover.svg"/> </data>

Table of Contents

Number of levels displayed on table of contents page.

PDF Bookmarks

PDF bookmark node initial state.

Labels

Generate titles for task steps and sections.

Not available for FOP and RenderX XEP

Generate "Table continued…" to table footer when table is broken to multiple pages.

Learn how to add nails to walls.

Buy a hammer and a nail.

1. Hammer in the nail.

Linking

Related links generated for topics.

Metadata

Plug-in ID is used to identify the DITA-OT plug-in.

ID must conform to plug-in ID syntax rules.

Name of the new transformation type.

Transtype name must conform to same syntax rules as plug-in ID.

See plugin installation documentation for next steps.

Donations

The DITA-OT PDF plugin generator is developed as a spare time project by Jarno Elovirta and is available for use free of charge. Donations are welcome per "value for value" model: you give value only when you feel you have received value.