DITA Aliases


In Ingeniux CMS, DITA content is managed and edited as assets in the Asset Tree; whereas, HTML pages created by the CMS are managed in the Site Tree.

For customers who maintain a "mixed format" authoring environment and require DITA content to be assimilated with page content, the aliases feature may be very useful for both managing and publishing these collections.

For example, your organization may need DITA content to display on your website alongside CMS page (HTML) content or to be integrated with page content. It can be difficult to envision the overall organization of your website for these types of "mixed" integration scenarios. The aliases feature helps organizations model complex format integrations in the Site Tree prior to publishing the collection.

Note
While this section focuses on HTML page and DITA format integrations, the aliases feature can be extended and applied to integrations of other, non-DITA formats as well.

To create an alias, provided you have alias management permissions, you can move a DITA map, which resides in the Assets Tree, under a page or folder in the Site Tree. After this action completes, Ingeniux CMS leaves an alias of the DITA map and all of its dependencies under the targeted page or folder. Moving a DITA map to the Site Tree creates an alias of the DITA map; however, the actual DITA map remains in the Asset Tree, where it can continue to be edited and managed. In essence, an alias is a representation of a DITA map that can be updated to reflect changes in the actual DITA map.

Ingeniux CMS provides multiple ways to access and then manage aliases:

  • By navigating to the Alias Manager via Administration (i.e., Administration > DITA > DITA Map Manager > [DITA Map] > Manage Aliases).
  • By navigating to the Alias Manager via Assets (i.e., Assets > [DITA Map or Topic] > Alias Management).
  • By dragging DITA maps from the Asset Tree to the Site Tree in Site and then operating on these DITA structures from the context menu in the Site Tree.
Note
From the Alias Manager, you have access to the complete set of alias features; whereas, from the context menu in the Site Tree, you have access to the most frequently used alias features.

This section describes how to configure aliases by way of Administration.