Oxygen XML Editor plugin
provides a special view for
editing DITA maps. The DITA Maps Manager view presents a map in a
simplified table-of-contents manner allowing the user to navigate easily to the referred
topics and maps, make changes and perform transformations to various output formats using the
DITA-OT framework bundled with
Oxygen XML Editor plugin
.
You can open a map file from
Project in the DITA Maps Manager view by right
clicking it and choosing Open in DITA Maps Manager. The titles of the
referenced resources are resolved and displayed in the view dynamically when navigating the
tree. After the map is opened in the view, you can open it in the main editor for further
customization using the Open map in editor toolbar action.
Drag and drop operations are allowed inside the view. You can move topics inside the same map
or between different maps by dragging and dropping them into the desired position. Also, you
can copy topics by dragging them while pressing the Ctrl (Meta on Mac OS)
key.
The toolbar includes the actions which are also available on menu DITA
Maps:
Open - Allows opening the
map in the DITA Maps Manager view. You can also open a map by
dragging it in the DITA Maps Manager view from the file system
explorer.
Open URL - Allows opening
remote maps in the DITA Maps Manager view. See Open URL for details.
Save
(Ctrl+S) - Saves the current DITA map.
Validate and Check for
Completeness - Checks the validity and
integrity of the map.
Apply Transformation
Scenario - Applies
the DITA map transformation scenario that is associated with the current map from
the view.
Configure Transformation
Scenario - Allows associating a DITA map transformation scenario with the current map.
Refresh References
- You can use this action to manually trigger a refresh and update of all titles of referred
topics. This action is useful when the referred topics are modified externally. When they
are modified and saved from the
Oxygen XML Editor plugin
Author, the DITA Map is
updated automatically.
Open Map in
Editor with Resolved Topics - Opens the result of expanding all topic
references in Author editor.
Open Map in Editor
- For complex operations which cannot be performed in the simplified DITA maps view (like
editing a relationship table) you can open the map in the main editing area.
Link with Editor -
Disables/Enables the synchronization between the file path of the current editor and the
selected topic reference in the DITA Maps Manager view.
Profiling/Conditional
Text menu with the following actions:
- Show Profiling Attributes - Enables/Disables displaying the
values of the profiling attributes at the end of the titles of topic references. When
enabled, the values of the profiling attributes are displayed both in the
DITA Maps Manager view and in the Author
editor.
Configure Profiling Condition
Sets ... - Opens the preferences panel for adding and editing the
profiling conditions that can be applied in the DITA Maps Manager
view and the Author editor.
Tip: If your map references other DITA maps they will be shown expanded in the DITA
Maps tree and you will also be able to navigate their content. For editing you will have to
open each referenced map in a separate editor. You can choose not to expand referenced maps in
the
DITA Maps Manager view or referenced content in the opened editors
by unchecking the
Display referred content checkbox available in the
Author preferences page.
Tip: The additional edit toolbar can be shown by clicking the "Show/Hide additional
toolbar" expand button located on the general toolbar.
The following edit actions can be performed on an opened DITA Map: