Table of Contents
More Resources
Use the PDF Plugin Generator
PDF Plugin Generator
Learn how to use the PDF Plugin Generator to generate a PDF customization plugin.
Generate a Plugin
Use the PDF Plugin Generator to select the PDF customizations you want and generate a plugin.
PDF Plugin Generator Customizations
Possible PDF output customizations using the PDF Plugin Generator.
PDF Plugin Generator

Learn how to use the PDF Plugin Generator to generate a PDF customization plugin.
The PDF Plugin Generator is a tool that enables you to preview and select PDF customizations, and creates a plugin with the correct files for you. Once you have a plugin, you can either use it as a plugin skeleton to add easyDITA PDF Customizations to or upload it into easyDITA and use it when publishing.
For a full list of available customizations, see PDF Plugin Generator Customizations.
Let’s get started and Generate a Plugin.
Generate a Plugin

Use the PDF Plugin Generator to select the PDF customizations you want and generate a plugin.
You want to create a plugin to customize your PDF output.
  1. First, navigate to go to the PDF Plugin Generator.

    Expected Result

  2. For the target environment, you only need to uncheck Override shell. You can leave the default selections for the DITA-OT version and XSL formatter.

    Step Information
    By default, the DITA-OT 2.2 is selected. However, if you require a different version, you can change it.
    Important:If your custom plugin is built using the DITA-OT version 2.0+, you’ll need the corresponding DITA-OT version in easyDITA. Contact an easyDITA representative to upload and enable the DITA Open Toolkit 2.X on your server. Once enabled, you’ll be able to use the DITA-OT 2.X and your plugin in a publishing scenario.
  3. Click Next and configure the PDF sylings you want.
  4. Repeat step 3 until you get to the Metadata page.

    Step Information
  5. Complete the following fields:

    1. In the Plug-in ID field, enter a name for the plugin.
    2. In the Transtype field, enter “pdf”.

      Step Information
      Take note of this transtype name because you’ll need it when you Set up a Publishing Scenario.
      Example
      For your first plugin, use your name. For example, “john.pdf”. Going forward, you can use your own naming structure, “whitepaper.pdf”.
    3. (Optional) In the Plug-in version, enter a version number for the plugin.
  6. Click Generate and save the ZIP folder containing the plugin you generated.
You created a plugin and downloaded it to your computer.
If you require additional customizations beyond those available in the PDF Plugin Generator, see easyDITA PDF Customizations. Otherwise, you’re ready to Upload a Plugin into easyDITA.
PDF Plugin Generator Customizations

Possible PDF output customizations using the PDF Plugin Generator.
The PDF Plugin Generator enables you to preview PDF customizations before generating a plugin with your selected customizations. You can use the PDF Plugin Generator to customize your PDF output in the following ways:

Pages

Customization Options
Size A4, A5, Executive, JIS B5, Tabloid, US Legal, US Letter, or PA4
Orientation Portrait or Landscape
Margins Top, Outside, Bottom, Inside, and Mirror Margins
Columns Column gap, and amount of body and index columns
Header Based on chapter title or empty
Footer Place page number in footer
Chapters start on Start chapter on new, odd, or even page
Chapter layout Use a chapter TOC
Cover page Use an image
Table of Contents Number of levels to display
PDF Bookmarks Initial node state as collapsed or expanded
Task labels Generate titles for task steps and sections
Linking Generate related links for topics

Style

Customization Options Additional Options
Normal
  • Formatting
    • Font family
    • Font size
    • Bold
    • Italic
    • Underline
    • Font color
    • Background color
  • Indents and Spacing
    • Alignment
    • Indentation
    • Spacing
    • Padding
    • Border
Heading 1 Title numbering
Heading 2
Heading 3
Heading 4
Example
Example title
Note Note icon
Performatted
Code block
Ordered list Numbering style, character before and after
Unordered list Character
Definition list List type
Table Numbering and position
Figure
Link
  • Formatting
    • Font family
    • Font size
    • Bold
    • Italic
    • Underline
    • Font color
    • Background color
Page number and show URL
Trademark Symbol scope