Edit online

The Resource Hierarchy/Dependencies view displays the hierarchy or dependencies for resources included in an XML document. For DITA resources, it will only show direct references, so resources that are indirectly referenced through keys are not presented in the hierarchy or dependencies tree.

To see the hierarchy or dependencies for a DITA resource (maps or topics), right-click a resource in the Project view and either select Resource Hierarchy or Resource Dependencies.

If you want to view the dependencies for a media resource (such as images) directly referenced in a DITA topic, click the Show Dependencies button on the toolbar of the Resource Hierarchy/Dependencies view, select the All files filter in the file browser, find the particular resource, and double-click it.

Figure 1: Resource Hierarchy/Dependencies View
The following actions are available on the toolbar of the Resource Hierarchy/Dependencies view:
Refresh
Refreshes the Hierarchy/Dependencies structure.
Stop
Stops the hierarchy/dependencies from computing.
Show Hierarchy
Compute the hierarchy structure.
Show Dependencies
Compute the dependencies structure.
Configure dependencies search scope
Allows you to configure a scope to compute the dependencies structure. You can restrict the scope to the current project or to one or multiple working sets. If the Use only Master Files, if enabled checkbox is selected, the scope of the search is restricted to the Master Files directory.
History
Provides access to the list of previously computed dependencies. Use the Clear history button to remove all items from this list.
The contextual menu for a resource listed in the Resource Hierarchy/Dependencies view contains the following actions:
Open
Opens the resource. You can also double-click a resource in the Hierarchy/Dependencies structure to open it.
Go to reference
Opens the source document where the resource is referenced.
Copy location
Copies the location of the resource.
Move resource
Opens the Move resource dialog box where the following fields are available:
  • Destination - Presents the path to the current location of the resource you want to move and gives you the option to introduce a new location.
  • New name - Presents the current name of the moved resource and gives you the option to change it.
  • Update references of the moved resource(s) - As long as Master Files support is enabled, you can select this option to update the references to the resource you are moving, in accordance with the new location and name. A Preview option is available that allows you to see what will be updated before selecting Move to process the operation.
Rename resource
Opens the Rename resource dialog box where the following fields are available:
  • New name - Presents the current name of the edited resource and allows you to modify it.
  • Update references of the renamed resource(s) - As long as Master Files support is enabled, you can select this option to update the references to the resource you are renaming. A Preview option is available that allows you to see what will be updated before selecting Rename to process the operation.
Show Resource Hierarchy
Shows the hierarchy for the selected resource.
Show Resource Dependencies
Shows the dependencies for the selected resource.
Add to Master Files
Adds the currently selected resource in the Master Files directory.
Expand All
Expands all the children of the selected resource from the Hierarchy/Dependencies structure.
Collapse All
Collapses all children of the selected resource from the Hierarchy/Dependencies structure.
Tip: When a recursive reference is encountered in the Hierarchy view, the reference is marked with a special icon .