51黑料不打烊

DocumentationAEM GuidesAEM Guides Documentation

HTML5 id205BE700XO1

Last update: Mon Feb 24 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • User

You can create the HTML5 output preset to publish output using DITA-OT and FMPS (If configured by your administrator).

You can create the HTML5 preset in two ways:

Create HTML5 output preset from the Map console

Perform the following steps to create the HTML5 preset from the Map console:

  1. Open a DITA map file in the Map console.

    You can also access the map file from the Recent files widget in the Overview section. The selected map file would open in Map console.

  2. In the Output presets tab, select the + icon to create an output preset.

  3. Select HTML5 from the Type dropdown in the New output preset dialog box.

  4. In the Name field, provide a name to this preset.

  5. In the Generate HTML Using field, select DITA-OT.

  6. Select the Add to current folder profile option to create an output preset within the current folder profile. The folder profile icon indicates a folder-profile-level preset.

    Learn more about Manage Global and Folder profile output presets.

  7. Select Add.

    The preset for HTML5 is created.

    {width="300"}

In the Map console, the preset configuration options are organized under the General and Advanced tabs.

The General tab contains the following configuration options:

  • Output path
  • DITA-OT command line arguments
  • File name
  • Conditional filtering (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 configuration options:

  • Transformation name
  • Retain temporary files
  • Flatten file hierarchy
  • File properties

For details on preset configuration options, refer to the HTML5 preset configuration section.

Create HTML5 output preset from the Map dashboard

Perform the following steps to create the HTML5 preset from the Map dashboard:

  1. In the Assets UI, navigate to and select the DITA map to open it in Map dashboard.

  2. Ensure that the Output Presets tab is selected.

  3. Select Create in the toolbar.

    A new output preset creation form is displayed.

  4. Enter the required configuration details for the HTML5 preset.

  5. Select Done to save the preset settings.

For details on preset configuration options, refer to the HTML5 preset configuration section.

HTML5 preset configuration

Configuration options vary slightly depending on whether you are configuring the preset from the Map console or the Map dashboard. Some options apply only to the Map dashboard, while others apply to both.

In cases where the same configuration has two different field labels, a / separates them in the table below. The first represents the label in the Map console, and the second represents the label in the Map dashboard.

For example, Output path/Destination Path - Here, Output path is the label used in the Map console, while Destination Path is the label used in the Map dashboard for the same configuration.

HTML5 options
Description
Output Type (Applicable for Map dashboard only)
The type of output you want to generate. To generate HTML5 output, choose the HTML5 option.
Setting Name (Applicable for Map dashboard only)
Give a descriptive name for the HTML5 output settings you are creating. For example, you can specify Internal customers output or end-users output.
Generate Responsive Using (Applicable for Map dashboard only)
Select DITA-OT to generate the HTML5 output. Select FrameMaker Publishing Server if your administrator has configured this option. Some of the configuration options vary when FMPS is selected.
Output path/Destination Path
The path within your AEM repository where the HTML5 output is stored.
DITA-OT command line arguments
Specify the additional arguments that you want DITA-OT to process while generating output.

NOTE: Starting with the 2502 release of Experience Manager Guides, the generate.copy.outer parameter is no longer managed internally. This change means that if your HTML5 content resides outside the map directory, you need to explicitly set the parameter -Dgenerate.copy.outer=3 in the DITA-OT Command Line Arguments field. This ensures that the content is correctly processed and included in your output. For more details on handling content outside the map directory, view .
File Name
Specify the file name with which you want to save the HTML5 output.

Note: If you do not provide a file name, then the DITA map鈥檚 title is used to generate the final HTML5 output file name. If the map does not have a title, then the DITA map鈥檚 file name is used to name is the final HTML5 output. The file name is sanitized using the rules configured in the system to handle any invalid character.
Conditioning filtering//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 view 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. FrameMaker Publishing Server doesn鈥檛 support multiple DITAVAL files.
* 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, view Use condition presets.

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. You need to update the location in case files are moved or deleted. You can hover over the file name to view the path in the AEM repository where the file is stored. You can only save DITAVAL files. An error is displayed if you have selected any other file.

Note: FrameMaker Publishing Server doesn鈥檛 support multiple DITAVAL files.
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, view Customize post-output generation workflow in Install and configure 51黑料不打烊 Experience Manager Guides as a Cloud Service.
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, view in OASIS DITA-OT User Guide.
Retain temporary files
Select this option to retain the temporary files generated by DITA-OT. If you are experiencing errors while generating output through DITA-OT, select this option to retain the temporary files. You can then use those files to troubleshoot output generation errors.

After generating the output, select the Download temporary files download temporary files icon icon to download the ZIP folder containing the temporary files.

Note: If file properties are added during generation, the output temporary files also include a metadata.xml file containing those properties.
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.

View Work with Baseline for more detail.
Flatten file hierarchy
Select the option to generate the HTML5 output in a flat folder hierarchy. The entire content is published in HTML5 output format in a flat file hierarchy and saved in a single folder.
If you deselect this option, the output is generated in a nested folder hierarchy, and the entire folder structure is replicated.
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 view, Pass on the metadata to the output using DITA-OT.

Parent topic:Understanding the output presets

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