Lesson 3: Advanced conrefs

Objectives

• Create and use a conkeyref.
• Reference a range of elements with conrefend.
• Add an element to a topic with conref push (conaction).

• Conkeyrefs, in which the file path portion of a conref uses a key
• Content reference ranges, which allow content references to pull in multiple elements (and their content)
• Content reference push, which allows maps to insert elements into topics in arbitrary locations

Additional reading

DITA Specification, Complex attribute definitions

DITA Style Guide, Advanced conref principles

Unsung heroes of DITA

A simple use case for DITA conkeyrefs

Contributors

• Simon Bate
• Jake Campbell
• Gretyl Kinsey