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

Empower Metadata with Fluid Topics

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

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="http://ref.fluidtopics.com/3.5/ft#">
    <ft:rights accessLevel="public" />
    <ft:metas>
    <ft:meta key="Category">Leaflet</ft:meta>
    </ft:metas>
    <ft:toc>
    <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:metas>
    <ft:meta key="ft:clusterId">Foo</ft:meta>
    </ft:metas>
    </ft:node>
    </ft:toc>
    </ft:map>

  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">
    <title>Features</title>
    <prolog>
    <metadata>
    <othermeta name="ft:clusterId" content="Foo"/>
    </metadata>
    </prolog>
    <conbody>
    <p>...</p>
    </conbody>
    </concept>

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