DITAVALs - Fluid Topics - 3.6

Upload DITA Content to Fluid Topics

Product
Fluid Topics
FT_Version
3.6
Category
Technical Notes

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.

The following lines show the DITAVAL file content for the novice audience version, which excludes the content tagged for the expert audience:
<?xml version="1.0" encoding="UTF-8"?>
<val>
  <prop action="exclude" att="audience" val="expert"></prop>
</val>
The following lines show the DITAVAL file content for the expert audience version, which excludes the content tagged for the novice audience:
<?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.

For example, the DITAVAL files can be named as follows:
  • Novice.ditaval
  • Expert.ditaval

Declare the dita:ditaval metadata element in the Home page and Search page configuration interfaces.

From the DITAVAL file names, Fluid Topics generates the following cluster selector displayed in the Search Results page:
Cluster Selector on the Audience information for a document 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".