Moving and Renaming Resources

You can move or rename resources referenced in your DITA project on disk directly from Oxygen XML Author Eclipse plugin and you have the option of updating all the references to the moved or renamed resources. If the resources are referenced in the DITA map, you can do this from the DITA Maps Manager view. You can also move and rename resources (DITA topics, maps, or other resources such as folders, images, HTML files, audio, video, text files, Markdown documents) from the Project Explorer view. If you have enabled Main Files support, you will also have the option to update all the references to the moved or renamed resource.

Moving or Renaming DITA Resources (Topics or Maps)

To move or rename resources (such as topics, maps, or other referenced non-DITA resources) referenced directly in the DITA map, 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.
Preview - Select this button to display a preview of the changes Oxygen XML Author Eclipse plugin 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.
Preview - Select this button to display a preview of the changes Oxygen XML Author Eclipse plugin 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 Resources and Updating the References to Them Using the Project View

To move or rename DITA (topics, maps) or 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 Explorer 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 resources while also updating all the references to them, use the following sets of procedures:

Enable Main Files support and add your root DITA map to the Main Files folder by following the procedure found here: How to Enable Main Files Support in DITA.
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.