Let's look at an example of how setting a context map resolves content key references (conkeyref). In the following example, the conkeyref vars/productName shows, but the content being referenced doesn't. This is because maps contain key names and definitions, so when a context map is not selected, the conkeyref isn't referencing any content.
However, once you set a context map, the keys and key references defined in the map are used to resolve the conkeyrefs. For example, selecting m_classic_toaster_user_guide.ditamap as the context map shows the vars/productName key as the Classic Toaster.
If you change the context map, and the keys and key references use the same ID but link to different content, the keys are maintained but the content being referenced changes. For example, selecting _m_lightning_toaster_user_guide.ditamap as the context map shows the vars/productName key as the Lightning Toaster.
Apply a Context Map
Apply a context map and use the selected map's key names, key definitions, variable warehouse topics, and warehouse topics to resolve dependencies such as key references (keyrefs) and content key references (conkeyrefs).
- In the content library, from the Context Map drop-down menu, select Select a context map.
- Navigate to and select a map.
- Click Select.