Configure custom DITA map template id1774F04F05Z
AEM Guides comes with two out-of-the-box map templates — DITA map and Bookmap. You can create maps based on these templates; or, you can define your own map templates that can then be used to create new maps.
The following tabs provide instructions to configure custom DITA map template based on your Experience Manager Guides setup: Cloud Service or On-Premise.
Perform the following steps to add your custom map templates:
-
Log into Adobe Experience Manager as an administrator.
-
In the Assets UI, navigate to the folder configured to store the map template files. By default, all map templates are stored in the /content/dam/dita-templates/maps folder.
note note NOTE To configure a custom location to store topic or map templates, see Configure custom DITA template folder path -
Click Create > DITA Template.
-
On the Blueprint page, select the type of the map template that you want to create.
note note NOTE You can use the Map or Bookmap template as the base for your new template. -
Click Next.
-
On the new template Properties page, enter a Title and Name for the template.
note note NOTE The name is automatically suggested based on the Title of your template. If you want to manually specify the name, then ensure that the Name does not contain any spaces, apostrophe, or braces and ends with .ditamap. -
Click Create.
Perform the following steps to add your custom map templates:
-
Log into Adobe Experience Manager as an administrator.
-
In the Assets UI, navigate to the folder configured to store the map template files. By default, all map templates are stored in the /content/dam/dita-templates/maps folder.
note note NOTE To configure a custom location to store topic or map templates, see Configure custom DITA template folder path -
Click Create > DITA Template.
-
On the Blueprint page, select the type of the map template that you want to create.
note note NOTE You can use the Map or Bookmap template as the base for your new template. -
Click Next.
-
On the new template Properties page, enter a Title and Name for the template.
note note NOTE The name is automatically suggested based on the Title of your template. If you want to manually specify the name, then ensure that the Name does not contain any spaces, apostrophe, or braces and ends with .ditamap. -
Click Create.
The Map Created message appears.
You can choose to open the template for editing in the Map Editor, or save the template file in the template store location. Once the template is created, you can use the Map Editor to customize the template as per your authoring needs. Once a template is in place, ensure that you associate it either with a global or folder-level profile.
Next time you create a new map, your template shows up in the Blueprint page. For more information about creating a DITA map, see the Using Adobe Experience Manager Guides.
Customize the number of references in a DITA map (Only for Cloud Service)
You can configure the threshold for asynchronous processing based on the number of references in the DITA map. By default, maps with more than 5 references will be created via asynchronous operations, while maps with fewer references will continue using synchronous operations.
Use the instructions given in Configuration overrides to create the configuration file. In the configuration file, provide the following (property) details to specify number of references in the DITA map template to keep the process synchronous:
Default value: 5
When creating a DITA map with large topic references using a custom template, the map creation would fail on the cloud server if the total processing time exceeds 60 seconds.
To prevent this, configure asynchronous dita map creation in XmlEditorConfig that allows tasks to run in parallel and reduce processing times for larger DITA maps.
Parent topic: Configure topic and map templates