Enabling the Mode for Editing DITA Map Content in One Document
Oxygen XML Web Author offers a feature that can be enabled for Git integrations for displaying a DITA map with all of its referenced topic content expanded and editable in one document. This editing mode is supported for all Git repository providers except for Bitbucket Server.
To enable this feature, a custom connector must set the
editReferencesInPlace
LoadingOption to true. When this feature is enabled, you need to take several
aspects into account:
- Depending on the user workflow, you may need to add UI elements (such as form controls or contextual menu entries) to lock/unlock or check-in/check-out each topic reference.
- If the connector implements a custom save behavior, you will need to use the UnsavedReferencesManager API to save the content in modified topic references.
Once enabled, users can trigger this mode by selecting Edit Topic Content from the DITA Map Display Mode drop-down menu.
- For performance reasons, only modified topics are validated.
- Only top-level topics in a DITA file can be edited.
Document Type Customization
When a DITA map is open for editing with topics expanded, the document type that is used is DITA Map with Resolved Topics. This is a built-in document type that can be customized according to your needs.