Table of Contents
User Guide
Content References
Content References
Use content references to identify elements in a topic to reuse.
Inserting a Conref
Use the Reuses feature to select and insert content for reuse.
Creating Conref Push
A quick and easy method to create conref push content.
Content References

Use content references to identify elements in a topic to reuse.
Rather than copying and pasting content, use Content References (conref) to reference content that can be reused. So when you need to update the content, you only need to update the source content and all the files that reference the source inherit the change. This way, you can write something once and reference it in many other topics.
Keep the following things in mind when inserting conrefs:
  • You can only conref similar elements. If you want to reuse the text in a Step, you can conref it from another Step. However, you cannot reuse a Paragraph as a Step.

  • You can only conref elements that are valid. If you want to conref a Paragraph, you can only reference it in areas where it is valid, such as in a Section or an Example.

  • You cannot conref a Shortdesc.

In easyDITA, reused content is highlighted in gray, indicating that the content cannot be edited here. Clicking on the reused content will open a Content Reference toolbar below the content. Here you can change the reference or view the source content by clicking on the link.

Inserting a Conref

Use the Reuses feature to select and insert content for reuse.
Note:Verify that the topic you want to reuse content from is not locked. If the topic is locked by you or another user, you will not be able to select the element for reuse.
You have a topic open and want to reuse content from another topic.
  1. Place your cursor where you want to insert the conref.

    Expected Result
  2. Click Re-use Content -> Insert Conref.

    Step Information
    Expected Result
    The Select Content window displays.
  3. Navigate to and select the topic you want to reuse content from.

    Expected Result
    The selected topic displays.
  4. Select the element you want to insert.

    Expected Result
    The navigation tree dialog displays.
  5. In the navigation tree, select the element you want to insert.

    Step Information
    If the element doesn’t have an ID attribute, you will be prompted to set one. The default value is a unique ID containing the element name appended by a random number. However, you can set your own ID if you want to.
    Expected Result
    The element is selected.
  6. Click Select.
The element is inserted into the topic as reuse content.
Reused context is highlighted in gray, indicating that the context cannot be edited here. Clicking on the reused content will open an Content Reference toolbar below the content. Here you can change the reference or view the source content by clicking on the link.
Creating Conref Push

A quick and easy method to create conref push content.
You created a topic to hold the push content, generally these are referred to as warehouse topics.
You want to create a conref push.
  1. Open the warehouse topic.
  2. Place your cursor in the topic.
  3. Click Re-use Content -> Insert Conref.
  4. Navigate to and select the content you want to replace.

    Expected Result

    You should see the target content placed into the current editing window.

  5. Click on the conref’ed content and then click on Properties.
  6. In the Content Action drop-down menu, select pushreplace.

    Expected Result

  7. Go back to your content and make the changes you want to be pushed into the other topic.
You created a pushreplace.
Add the warehouse topic to your map as resource-only so it displays in your publication.