In DITA, a topic or a map content can be used within several documents according to different metadata values specified in the DITAVAL.
Fluid Topics needs to know that a group of documents were in fact from the same origin. Two topics or maps that are present in a same top map, published in Fluid Topics with DITAVAL files, are considered as such.
Fluid Topics retrieves the DITAVAL file names, e.g., x1 and x2 are retrieved from x1.ditaval and x2.ditaval, associated to the top map to publish. From these names, Fluid Topics generates a cluster with both x1 and x2 as tag values.
To generate a cluster from two variants, novice and expert, for the document “Marvel Comics History”:
Create two DITAVAL files: one file per version of the document.
<?xml version="1.0" encoding="UTF-8"?> <val> <prop action="exclude" att="audience" val="expert"></prop> </val>
<?xml version="1.0" encoding="UTF-8"?> <val> <prop action="exclude" att="audience" val="novice"></prop> </val>
Name the DITAVAL files with the term or expression to display on the cluster selector. Fluid Topics retrieves the filenames to create values of the DITAVAL facet and to generate the cluster selector.
From the DITAVAL file names, Fluid Topics generates the following cluster selector displayed in the Search Results page:
Users can choose between two documents of the document: one for the version "novice" and another one for the version "expert".