When adding an xref cross-reference to a variant of topic generated using DITAVAL-references, Fluid Topics needs to know which version of the topic it should target. Adding elements such as dvrResourceSuffix to the DITAVAL-references adds a suffix to each newly generated topic that helps differentiate one topic from another.
If no suffix is defined through the dvrResourceSuffix parameter, the first variant of the topic has the original filename, e.g., c_time_capacitor.dita, the second variant has the original filename to which -1 is added, e.g., c_time-capacitor-1.dita, and so on.
To apply the DITAVAL-references OD1000.ditaval and OD2000.ditaval to the topic c_time_capacitor.dita, for each DITAVAL-reference, define a suffix as follows:
- For the topic in version OD1000, dvrResourceSuffix is set to _od1000.
- For the topic in version OD2000, dvrResourceSuffix is set to _od2000.
The following lines show how to assign a dvrResourceSuffix in a ditavalmeta element at the ditavalref level:
Two topics are generated by the DITAVAL-references with the following filenames:
In Fluid Topics, it is possible to check the metadata associated with a topic using the view metadata option as follows:
In the same way, it is possible to define prefixes for variant filenames using dvrResourceSuffix,prefixes for the key scope names of the map branch using dvrKeyscopePrefix, and suffixes for the key scope names of the map branch using dvrKeyscopeSuffix.