Component Reuse

You can reuse topics and maps by adding them to multiple maps.

Overview

You reuse topics and maps by using topicref elements and mapref elements to insert that component into a map.

Figure 1. Component Reuse Operation.
The following diagram illustrates that:
  • “Topic A” is reused in “Map A” and “Map B”
  • “Topic B” is reused in “Map A” and “Map C”
  • “Map D” is reused in “Map B” and “Map C”
Tip: You can view detailed reuse information about every file in easyDITA by right-clicking a file and selecting Links . The Links tab shows incoming links, outgoing links, or all file dependencies.

Example

The following example shows the behavior of the topic and map reuse indicator in the content library when you reference a file in your map.
Note: When the indicator is black, that means the component is used in a map somewhere within the content library. When the indicator is green, that means the component is reused in the currently opened map. The number indicates how many times the component is globally reused.
Figure 2. Map A
Figure 3. Map B
Figure 4. Map C

Reuse Components in the Topic Editor

You can reuse components like topics or maps by using the topic editor.

  1. Open a map in the topic editor by clicking the Open icon or double-clicking the map.
  2. Right-click an element in a map.
    Tip: You can reuse elements from your easyDITA repository in a map by:
    • Appending elements under elements
    • Inserting elements before elements
    • Inserting elements after elements
  3. Do any of the following:
    • To insert a child element under an element in a map, select Append element > Select existing .
    • To insert an element before an element in a map, select Insert element before > Select existing .
    • To insert an element after an element in a map, select Insert element after > Select existing .
  4. In the Select File window, select a file.
  5. Click Select.

Reuse Components in the Map Editor

You can reuse components like topics or maps by using the map editor.

  1. In the content library, hover over a map and click the Dock button.
  2. In the content library, navigate to the component(s) that you want to add to the map.
  3. Drag and drop the component(s) from the content library into the map editor.
    Tip: A line appears that indicates where the component will be added. If you drop a component on another component, a green box appears. The green box indicates that the new component will be added as a child of the component that is already in the map.
  4. If prompted, from the Insert drop-down menu, select a relevant reference type and click Insert.
    Note: Your easyDITA instance can be configured to automatically select the appropriate reference type for you. If you want to select the reference type on your own, you can hold Shift while dragging and dropping a resource into the map tree.

    To disable or enable the intelligent drag and drop feature, contact a Customer Success Manager.

  5. Click Insert.