Add existing topics to a map in Oxygen

When you're organizing topics into a map's hierarchy, you can add references to topics that you've already created. The link references an entire topic to be included in the output publication through the href attribute.

Tips and tricks

You can insert one or more references at a time.
Although there are a few ways to insert a topic in a map, these instructions tell you how to do it using the insert button on the toolbar. By default, this inserts the references you choose as child references. If you don't want to insert child references, you can:
- Move the references after inserting them.
- Use the right-click menu on the Outline pane on the left side, inline with the content, or the breadcrumb on the bottom of the screen. The right-click menu allows you to first choose where the references should be inserted (Append child, Insert Before, Insert After).
You can reuse specific blocks of content from another document.
If you want to reuse a specific part of a component's content and make it appear (exactly as it is) inline where you reference it, you can insert a content reference (conref). Follow the instructions in: Add a conref to a map in Oxygen.
You can also add a new topic or a placeholder (empty) topic.
When you use the left side panel in the Oxygen map editor, Inspire remembers your Folders and Outline options. This helps you get to the structure quicker so you don't have to set it every time you open a map.
- If you want to add a reference to a topic you haven't created yet, follow the instructions in Create a new topic in a map using Oxygen.
- To add a placeholder in the map without creating a new topic, follow the instructions in Add an empty topic in a map using Oxygen.

To add an existing topic to a map in Oxygen:

Click Components.
On the Folders pane, navigate to the map that you want to update.
On the Components pane, right-click the map component and then select Edit ...
You can also open the map by:
- Double-clicking
- Clicking the Options menu, and then selecting Edit ...
In the map content pane, place your cursor where you want to insert a reference.
By default, you see a Display mode of Topic titles.
- You can go to the toolbar and select the Display mode option to change the view.
- If you select View Topic References and leave it on that mode when you save or close the map, the next time you open it, all the references in the map are expanded for you.
- If you select View Topic Content and leave it on that mode when you save or close the map, the next time you open it all the references in the map are collapsed due to memory and performance concerns.
On the toolbar, click the Insert a DITA Topic Reference button .
On the Select Components dialog, browse the Folders or use Advanced Search to find the components you want, and then select the checkbox for each component you want to add.
On the Select Components dialog, click Select.
To save your changes and close the map, in the toolbar, click the Save and Submit icon .