Initial DITA Configuration
Prior to uploading existing DITA sets or creating new ones, CMS administrators must configure Ingeniux CMS to process DITA. A typical DITA configuration should take no more than a few minutes. Use the diagram below as a basic DITA configuration guide and to get a sense of where in the CMS DITA configuration takes place and in what order. You can click the links in the diagram to learn more about each configuration step.
The DITA publishing environment within the CMS requires the following steps at a minimum. Click any of the links below to learn more about these steps and about additional options you can set.
Install Java: The DITA Open Toolkit requires Java SDK to be installed on the server where Ingeniux CMS resides.
See Oracle's Java SDK installation instructions for details. To complete the Java environment installation, you may need to restart the CMS server.TroubleshootingWe recommend installing Oracle's Java SDK. An issue occurs with Microsoft's OpenJDK 17, where temp folder cleanup fails during DITA-OT transformation processes.
Create DITA Root Folder: This will be the asset folder where all DITA content will reside in order for them to be published. Set DITA Root Folder: CMS administrators must set the asset ID of the DITA root folder in . Install DITA-OT: CMS administrators must install a version of the DITA Open Toolkit in . Select DSS Schema (Rendering DITA Schema for DSS): CMS administrators must set the appropriate schema for DITA in . Select Output: CMS administrators must select the required output formats in . Configure Post-Publish Processing: CMS administrators must configure the appropriate processing application in . Upload DITA Assets: Users must upload DITA assets to Ingeniux CMS (or create them in the CMS). Check In DITA Assets: All DITA maps and their dependent content must be checked in prior to publishing. Mark Map(s) for Publish: All DITA maps and their dependent content must be marked for publish for the intended publishing target(s). Publish Map(s): Users with administrative rights publish DITA maps in the desired output formats.