Cluster Topics from Different Sources - Fluid Topics - 3.10 - Technical Notes

Empower Metadata with Fluid Topics

Fluid Topics
Fluid Topics Version
Technical Notes
Target Audience

It is possible to manually assign any value to ft:clusterId metadata key on the condition that this value is the same for all the topics to be clustered.

The ft:clusterId metadata element is case-sensitive. If case does not match, the cluster will not work.

The following example shows how to set the value for the ft:clusterId metadata key in order to cluster the La Fontaine's Fables Ftmap and the Features DITA topic.

  1. Add the ft:clusterId metadata key with the value Foo to the Ftmap topic node in an ft:meta element as follows:

    <?xml version="1.0" encoding="UTF-8"?>
    <ft:map ft:editorialType="book" ft:lang="en-US" ft:originID="la_fontaine_fables" ft:title="La Fontaine’s Fables" xmlns:ft="">
    <ft:rights accessLevel="public" />
    <ft:meta key="Category">Leaflet</ft:meta>
    <ft:node ft:title="Time Machine v1.0" href="time_machine_1_0.html" ft:originID="time_machine_1_0"/>
    <ft:node ft:title="Time Machine v2.0" href="time_machine_2_0.html" ft:originID="time_machine_2_0">
    <ft:meta key="ft:clusterId">Foo</ft:meta>

  2. Add the ft:clusterId metadata key with the value Foo to the DITA topic file in a metadata element as follows:

    <?xml version="1.0" encoding="UTF-8"?>
    <!DOCTYPE topic PUBLIC "-//OASIS//DTD DITA Topic//EN" "topic.dtd">
    <topic id="concept_fgr_qnk_rdb">
    <othermeta name="ft:clusterId" content="Foo"/>

Once uploaded, Fluid Topics clusters the two documents as one search result with a selector.