History | Edit

You can move or rename resources on disk directly from Oxygen XML Editor and you have the option of updating all the references to the moved or renamed resources. For DITA resources (such as topics and maps), you can do this from the DITA Maps Manager view. For non-DITA resources (such as folders, images, html files, audio, video, text files, Markdown documents), you can do this from the Project view.

Moving or Renaming DITA Resources (Topics or Maps)

To move or rename normal DITA resources (such as topics or maps), use one of the following actions available in the Refactoring submenu of the contextual menu when invoked on the resource in the DITA Maps Manager view:
Refactoring > Move resource
This action allows you to change the location of a resource linked in the edited DITA map, using the Move resource dialog box. This dialog box contains the following options:
  • Destination - Specifies the target location of the edited resource.
  • File name - Allows you to change the name of the edited resource.
  • Update references - Select this checkbox to update all references of the file in the edited DITA map and in the files referenced from the DITA map, preserving the completeness of the DITA map.
  • Preview - Select this button to display a preview of the changes Oxygen XML Editor is about to make.
  • Move - Moves the edited resource in the target location on disk.
  • Cancel - Cancels the Move resource operation. No changes are applied.
Refactoring > Rename resource
This action allows you to change the name of a resource linked in the edited DITA map, using the Rename resource dialog box. This dialog box contains the following options:
  • New name - Presents the current name and allows you to change it.
  • Update references - Select this checkbox to update all references of the file in the edited DITA map and in the files referenced from the DITA map, preserving the completeness of the DITA map.
  • Preview - Select this button to display a preview of the changes Oxygen XML Editor is about to make.
  • Rename - Executes the Rename resource operation.
  • Cancel - Cancels the Rename resource operation. No changes are applied.
Note: If a root DITA map is not defined, the move and rename actions are executed in the context of the current DITA map.

Moving or Renaming Non-DITA Resources and Updating the References to Them

To move or rename non-DITA resources (such as folders, images, html files, audio, video, text files, Markdown documents), you can simply follow the procedures described in Moving/Renaming Resources in the Project View. However, this approach will not give you the option to update the references to the moved or renamed resources.

To perform move or rename operation on non-DITA resources while also updating all the references to them, use the following sets of procedures:
  1. Enable Master Files support and add your root DITA map to the Master Files folder by following the procedure found here: How to Enable Master Files Support in DITA.
  2. Move or rename resources and update the references to them by following the procedure found here: Moving or Renaming Non-DITA Resources and Updating the References to Them.