Custom id205BEF00PX0

The Custom output presets are available for custom DITA-OT plug-ins. You can create a custom DITA-OT output preset to publish output using your custom DITA-OT plug-in.

You can create the Custom preset in two ways:

From the Web Editor: In the Repository panel, open the DITA map file in Map View, then in the Output tab, select the + icon to create an output preset, and then select Custom from the type drop-down in the Add preset dialog.

In the Web editor the configurations have been organized under General and Advanced tabs:

General

The General tab contains the following configurations:

  • DITA-OT Command Line Arguments
  • Transformation Name
  • File Name
  • Output Path
  • Apply Conditions Using (If the conditions are defined for a map)
  • Use Baseline (If a baseline is created for a map)
  • Post Generation Workflow

Advanced

The Advanced tab contains the following configurations:

  • Clean DITA-OT Temporary Files
  • File Properties

For details, refer to Custom configuration.

From the map dashboard

To open output presets for PDF, click on a DITA map file from the Assets UI, then click on Output Presets, and then click on the HTML5 option. In the Map dashboard, click Edit on the top to update the various configurations, and then click Save.

Custom configuration

The following options are available for the Custom output preset:

Custom output options
Description
Output Type
The type of output you want to generate. To generate output using custom DITA-OT plug-in, choose the Custom option.
Setting Name
Give a descriptive name for the output settings you are creating. For example, you can specify Internal customers output or end-users output.
DITA-OT Command Line Arguments
Specify the additional arguments that you want DITA-OT to process while generating output. For details about the command-line arguments supported in DITA-OT, see DITA-OT documentation.
Transformation Name
Specify the type of output you want to generate. This is required if you want to generate output using your own custom plug-in, which is integrated in the DITA-OT plug-in. For example, if you want to generate XHTML output, specify xhtml. For a list of transformations available in DITA-OT, see DITA-OT transformations (output formats) in OASIS DITA-OT User Guide.
File Name
Specify the file name with which you want to save the output.

Note: If you do not provide a file name, then the DITA map’s title is used to generate the final output file name. If the map does not have a title, then the DITA map’s file name is used to name is the final output. The file name is sanitized using the rules configured in the system to handle any invalid character.
Apply conditions using
Select one of the following options:

* None applied: Select this option if you do not want to apply any condition on the published output.
* DITAVal file: Select DITAVal file(s) to generate personalized content. You can select multiple DITAVal files using the browse dialog or by typing file path. Use the cross icon near the file name to remove it. DITAVal files are evaluated in the order specified, so the conditions specified in the first file take precedence over the matching conditions specified in later files. You can maintain the file order by adding or deleting files. If the DITAVal file is moved to some other location or is deleted, it is not automatically deleted from the map dashboard. You need to update the location in case files are moved or deleted. You can hover over the file name to see the path in the AEM repository where the file is stored. You can only select DITAVal files and an error is displayed if you have selected any other file type.
* Condition preset: Select a condition preset from the drop-down to apply a condition while publishing the output. The option is visible if you have added a condition present in the Condition Presets tab of the DITA map console. To know more about condition preset, see Use condition presets.
Destination Path
The path within your AEM repository where the EPUB output is stored.
Clean DITA-OT Temporary Files
Select this option to clean the temporary files generated by DITA-OT. The location where DITA-OT stores temporary files can be found in the output generation log.

If you are experiencing errors while generating output through DITA-OT, you can deselect this option to retain the temporary files. You can then use those files to troubleshoot output generation errors.
Run Post Generation Workflow
When you choose this option, a new Post Generation Workflow drop-down list is displayed containing all workflows configured in AEM. You must select a workflow that you want to execute after completion of the output generation workflow.

Note: For more information about creating a custom post-output generation workflow, see Customize post-output generation workflow in Install and configure Adobe Experience Manager Guides as a Cloud Service.
Use Baseline
If you have created a Baseline for the selected DITA map, select this option to specify the version that you want to publish.

See Work with Baseline for more detail.
File Properties
Select the properties that you want to process as metadata. These properties are set from the Properties page of the DITA map or bookmap file. The properties you select from the dropdown list appear under the File Properties field. Select the cross icon next to the property to remove it.

Note: You can also pass on the metadata to the output using DITA-OT publishing. For more details see, Pass on the metadata to the output using DITA-OT.

Parent topic:Understanding the output presets

recommendation-more-help
11125c99-e1a1-4369-b5d7-fb3098b9b178