Edit online

Key References (Variables)

Radu Coravu
Read time: 1 minute(s)

You can reuse simple variables like product name, executable, and so on by defining keywords in the Dita Map and then using keyref's in topics to reuse those text fragments.

Reusing keywords

Defining the reused keyword in the DITA Map:

<!-- product name -->
  <keydef keys="product" product="editor">
    <topicmeta>
      <keywords>
        <keyword>Oxygen XML Editor</keyword>
      </keywords>
    </topicmeta>
  </keydef>

Reusing the keyword in a topic:

<title>Installation Options for <ph keyref="product"/></title>

In Oxygen you can create key definitions in the DITA Map by right clicking in the DITA Maps Manager and choosing Append Child->Key definition with keyword.... After this, in the topic you can use Oxygen's regular Reuse Content action to insert the keyref.