Table of Contents
User Guide
Publishing
Publishing Overview
The Publishing interface enables you to transform your DITA content into other formats.
Publishing with the DITA Open Toolkit
Use the Publishing interface to publish a topic or map using the DITA Open Toolkit.
Viewing and Downloading Previous Publishes
View previous publish jobs on a topic or map and download the output and log files for the publish.
Publishing Overview

The Publishing interface enables you to transform your DITA content into other formats.
Publishing is how you transform content in DITA into document formats such as Adobe Acrobat (PDF), HTML, and web help that you can deliver to your customers. You can use the Publishing interface to:
  1. Create a new publish
  2. View and download past publishes
12
easyDITA publishes DITA content through a variety of services. Included in every instance of easyDITA is the DITA Open Toolkit (DITA OT), an Open Source project that is maintained by a community of software developers. The DITA OT uses plugins to transform DITA content into a number of output formats.
You can publish content to all the DITA Open Toolkit output formats, including:
  • PDF
  • HTML
  • HTML5
  • XHTML
  • HTML Help ePub
  • eBook
  • JavaHelp
  • RTF
easyDITA supports the addition of any standards-complaint plugin for the DITA OT. easyDITA also supports any version of the DITA OT.
Besides the DITA OT, you can also publish directly to MindTouch, WordPress, and Desk.com.
Publishing with the DITA Open Toolkit

Use the Publishing interface to publish a topic or map using the DITA Open Toolkit.
You’re in the Content Manager and want to publish a topic or map.
  1. Right-click the topic or map and select Preview.

    Expected Result
    The Preview Tab displays.

  2. Click Publish.

    Step Information
    The Publishing interface displays.
    Note:Available options vary based on your configuration.

  3. Click DITA Open Toolkit.
  4. Click New Publish.
  5. Enter a Description. This is what will appear in the list of previous publishes.
  6. Click Add > > next to the publishing scenario you want to use.

    Step Information
    The default publishing scenarios are Basic 1.5.2 and Basic 1.5.3. The numbers refer to versions of the DITA OT.
    To create multiple outputs from one map in a single publishing operation, add multiple publishing scenarios. For example, you could add Basic 1.5.3 twice – once for HTML, and once for PDF.

  7. Set the parameters for each publishing scenario you have selected.

    Step Information

    Note that parameters are specific to each publishing scenario as defined by your system administrator. Typical parameters are Transformation Type (transtype, which defines the output format), locale, or DITAVal file which lets you select a configuration file in the DITAVal format.

  8. (Optional) If you have any active localizations for the map to be published, you can select them from the drop-down menu in the parameters section.
  9. Click Publish

    Expected Result
    The Publishing Manager screen and the status of the publication job are displayed.

The publish job is complete and displays as a previous publish job for the topic or map. You can click on the publish job to view more information about it or download the output files (e.g. PDF) and log files generated by the DITA OT.
Viewing and Downloading Previous Publishes

View previous publish jobs on a topic or map and download the output and log files for the publish.
You’re in the Content Manager and want to view and download a previous publish for a topic or map.
  1. Right-click the topic or map and select Preview.

    Expected Result
    The Preview Tab displays.

  2. Click Publish.

    Step Information
    The Publishing interface displays.
    Note:Available options vary based on your configuration.

  3. Click DITA Open Toolkit.

    Expected Result
    The previous publishes display.
  4. Select a previous publish.

    Expected Result
    The Publish Record window displays any error or warning messages generated by the DITA Open Toolkit.

  5. Click Download to download a ZIP file containing the output of the DITA Open Toolkit. This will include any output files (e.g. PDF) plus any log files generated by the DITA OT.
The previous publish is downloaded to your computer.