Edit online

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.

When editing a DITA map in this mode, the editor provides actions for both editing topic content and editing map content. To implement this behavior, a special framework is used. This framework extends the DITA framework and adds some map-specific actions.
Notes:
  • 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.

This framework mixes configuration from the built-in DITA and DITA map document types. If you have a custom DITA framework extension, you have to make the same adjustments to the configuration of this framework.
Tip: To avoid duplicated configurations, you can use a framework extension script.