Create a .ditaval File - Fluid Topics - 3.9 - Technical Notes

Upload DITA Content to Fluid Topics

Product
Fluid Topics
Fluid Topics Version
3.9
Category
Technical Notes
Language
English
Target Audience
public

Fluid Topics uses the metadata values defined in the .ditaval file to cluster content. Therefore, it is possible to reuse the content of a topic or map and define metadata values in the .ditaval file in order to group related content together.

Example

  1. To generate a cluster including two versions of a document, novice and expert:
  2. Create two .ditaval files (one file per document version).

    The following lines show the .ditaval file for the novice 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 for the expert 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>

  3. Name the .ditaval files. Fluid Topics retrieves the filenames to generate the values of the cluster selector.

    For example, the DITAVAL files can be named as follows:

    • novice.ditaval
    • expert.ditaval
  4. Declare the dita:ditaval metadata element in the Results tab of the Search page administration interface.

Fluid Topics generates the following cluster selector and displays it in the Search page:

Cluster Selector on the Audience information for a document in the Search Results page

Users can open the menu to select the version best suited to their level of experience.