Documentation Center

Adding a DITA Output Format

To publish from Content Manager to DITA, you must configure a DITA output format. After it is created, it is available in Publication Manager to add as output for your publications.

Before you begin

To perform this task, the following must be true:
  • The user performing the task has an Output Formats Management privilege or a System Administrator privilege.
  • The style sheets for the output format being added are in place.

Procedure

  1. Sign in to Organize Space.
  2. On the top tab level, select the Settings tab.
  3. On the second tab level, select the System tab.
  4. On the third tab level, select the Output Formats tab.
  5. Select Add new at top right.
    The Add new output format dialog opens.
  6. In the GENERAL area, set the following properties:
    PropertyMandatory or optional? Description of value
    Output format nameMandatory The name of the output format. This is the name that users see in Publication Manager or in Organize Space when they publish. A good name for this output format is "DITA".
    Resolutions prioritizedMandatory A list of one or more resolutions to use for the output format. The first value in the list should be the resolution you want to see included in the topics. By default, the other resolutions are only used by custom publishing processes.
    Resolutions to exportMandatory You can ignore this property if Resolutions prioritized has only one value, or if you have no custom publishing processing that uses resolutions beyond the first one.
    If Resolutions prioritized has multiple values, and you have custom publishing using those values, select one of the values:
    All Resolutions
    This exports all resolutions listed under Resolutions and publishes them to output. Do not select this value if you are publishing your objects with logical IDs (that is, if you have set the ContentObjectIdLevel property to the value logical in the publish post-process plugin DitaDeliveryPrepareOverallPackage). This is because such a configuration would cause different resolutions of the same image to be published to the same output URL, which would lead to conflicts.
    First Matching Resolution Only
    This exports and publishes only one resolution of the image: the first resolution listed under Resolutions that exists as a resolution for the image.
    EDT of the outputMandatory The electronic data type of the output.For a DITA output format, select ZIP from the list.
    DITA-OT transformation typeOptional The DITA Open Toolkit transformation type.. For a DITA output format, select xml from the list.
    Style processorMandatory The engine that will apply the layout and style.. For a DITA output format, select MSXML 4.0 Parser from the list.
  7. Do the following in the Advanced section at the bottom of the window; select the appropriate checkboxes if you want to:
    1. Clean up. After publishing, Content Manager deletes temporary files from C:\InfoShare\DataDita\Publish\Data\.
    2. Resolve Variables. It is recommended that you select this option.
    3. Include missing objects. Inserts placeholder objects whenever referenced objects are missing. It is recommended that you select this option.
  8. Select OK to close the dialog and to add the new output format to the list of output formats that are available to assign to a publication version.
  9. Restart IIS on the Content Manager server.