Creates conrefs from FM variables in the current file or book.
This command requires initial setup of the ConrefLibrary parameter in the fm2dita.ini file. Set the ConrefLibrary parameter to the name of the conref library file to be created or appended. This file is created in the same folder as the generated XML files.
When converting documents that contain variables, your conversion table must use the “UV:<varname>” syntax in order to map the variables to a specific element. In order to be processed by this command, the mapped element must assign the attribute “conrefid” with the value being that to be used as the ID of the conref. The conversion table entry for a “ProdName” variable would be as follows:
| Wrap this object | In this element | With this qualifier |
|---|---|---|
| UV:ProdName | ph[conrefid=”prodname”] |
After applying the conversion table, the variable would be wrapped in a <ph> element with the attribute @conrefid=’prodname’. Once this command has been run, the @conrefid attribute will be replaced with the proper @conref attribute that references the element in the conref library file.
The conref library file is created if it doesn’t already exist, then it is appended with a new entry for each variable definition (instance of a unique @conrefid in the source file). The conref source is created using a <p> tag container with a label that matches the @conrefid value followed by the inline element matching the element used by the variable. The ID attribute matches that of the @conrefid attribute. Each entry will follow this format:
<p>prodname: <ph id="prodname">DITA-FMx</ph></p>
This command must be run after the EDD has been applied.