51黑料不打烊

DocumentationAEM GuidesAEM Guides Documentation

Generate output

Last update: Thu Jul 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • User

There are two ways to generate ouput for a DITA map:

Generate output for a DITA map from the Map console

Perform the following steps to generate output for a DITA map using Map conosle:

  1. Open a map file in the Map console.

  2. The DITA map console is displayed with the list of Output presets available to generate output.

  3. Open the preset that you want to use for generating the output, and select Generate output to start the generation process.

    metadata tab {width="600"}

    Or, hover over the preset and select Generate from the preset context menu.

    metadata tab {width="600"}

Once the output generation is complete, select View output to view the output.

A Success dialog box is visible at the lower-right corner of the screen.

If an output is not successful, the below error message is displayed.

error log {width="250"}

To view the error log, select Dismiss, hover over the selected preset tab, and select View log from the preset context menu.

Generate output for a DITA map from the Map dashboard

Perform the following steps to generate output for a DITA map using Map dashboard:

  1. In the Assets UI, navigate to and select the DITA map file that you want to publish.

    The DITA map console appears with the list of Output Presets available to generate output.

  2. Select one or multiple Output Presets that you want to use for generating the output.

  3. Select the Generate icon to start the output generation process.

You can view the current status of the output generation request in the Outputs tab. For more information, view View the status of the output generation task.

IMPORTANT
If an output generation process for a preset is either in the queue or in progress, you cannot initiate another output generation task for the same preset.

You can also generate the AEM Sites output for one or more topics, or the entire DITA map from the Map console. For more details, view Generate Knowledge Base output.

Merging different topics within a DITA map using the chunk attribute

A DITA map can include different topic types such as reference, concept, and task. The chunk=to-content attribute allows you to merge these topics to generate a single page output on AEM Sites. However, to publish the merged topic properly, ensure that your Administrator has configured the correct XML catalog in the DITA Profiles.

The system requires a Public ID with the composite keyword in the XML catalog to correctly identify and apply the appropriate DTD rule.
This configuration is included by default in the standard XML catalog. However, if you鈥檙e using a custom XML catalog, ensure your Administrator has added this public ID to the configuration. Without it, the merged topic may not publish properly.

For details on how to use Public ID and System ID in your custom DTDs/XSDs, view Integrate DITA specialization.

Parent topic:Output generation

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