Gretyl's Portal

Heretto Help

Publish a PDF Comparison with DITA Open Toolkit

You can publish a PDF that compares the current content with the content in a branch or release.

Create a release or branch a map.
Note:

This functionality may not be available by default in Heretto CCMS. For more information, contact your Customer Success Manager.

  1. In the Content Library, click a map and in the right pane select Output > Publish.
  2. From the list on the left, select a DITA-OT publishing scenario.
    Publishing scenarios are configured by your CCMS Administrator. For more information, see Create a DITA-OT Scenario.
    Important: You can only publish a PDF comparison by using a PDF publishing scenario based on DITA Open Toolkit version 2.x or greater.
  3. Optional: In the Enter description field, add a meaningful description of the publishing job.
    Once you publish the document, you can see that description in the list of completed publishing jobs.
  4. From the Compare to drop-down menu , select a branch or release to compare the current content with.
  5. Set the rest of the publishing parameters.
    The publishing scenario can include the following parameters.
    DITAVAL (args.filter)
    Optional parameter. Enables you to select a DITAVAL file for conditional processing. This parameter may be pre-set and fixed in a publishing scenario.
    Webhooks
    Enables you to send webhooks on successful publish or any publish.
    Debug publish
    Generates additional files that are added in the debug folder to the output ZIP file. You can use those files to troubleshoot publishing issues in your publication. This option is only available in DITA-OT and PDF Generator publishing scenarios for those users with Administrator privileges.

    For more information about the DITA Open Toolkit (DITA-OT) parameters, see https://www.dita-ot.org/dev/parameters/parameters_intro.html.

  6. Click Publish.
    The resource publishes in the In progress section. A progress bar provides details about the publishing process.
  7. Download a ZIP file with all publication-related resources by hovering over the publishing job and clicking Download .
    Figure 1. Successfully Completed Publishing Job
    A Successfully Completed Publishing Job
The PDF output file highlights content differences with red and green.