Selecting a Root MapEdit online
Oxygen XML Editor plugin allows you to select a root
map (a master DITA
map) that defines a hierarchical structure of submaps and establishes a key space that defines the keys used in
all the other DITA maps and topics in the project. Specifying the correct
root map helps to prevent validation problems when you work with
keyrefs and also acts as the foundation for content completion. All the
keys that are defined in a root map are available in the submaps
that are contained within the root map.
There are several ways to select or change the root map:
- The easiest method is to use the Root map drop-down menu in the DITA Maps Manager toolbar to select the appropriate root map.
- If you insert a key reference using the Cross Reference
action from the
Link drop-down
menu (from the toolbar or Link submenu of the contextual menu) and
keys are not gathered from the expected DITA map, you can change the
root map by using the Change Root Map link in the
Choose Key dialog box that is opened when you click the
Choose Key Reference
button. - If you insert a content key reference or key reference using the
Reuse Content action (from
the toolbar, DITA menu, or Reuse submenu of
the contextual menu) and keys are not gathered from the expected DITA map,
you can change the root map by using the Change Root
Map link in the Choose Key dialog box that is opened
when you click the Choose Key
Reference button.
For more information about the DITA root map support, watch our video demonstration: