Attach a File to Several Instances of a DITA Map - Fluid Topics - 3.6 - Technical Notes

Manage Map Attachments in Fluid Topics

Product
Fluid Topics
FT_Version
3.6
Category
Technical Notes
language
English
audience
public

The following lines show how to attach the Pufferfish Swim image to the Novice and Expert instances of the Pufferfish DITA map:

<?xml version='1.0' encoding='utf-8'?>
<controlFile>
<resources>
<resource>
<filePath>_pufferfish.ditamap</filePath>
<instances>
<instance>
<filePath>Novice.ditaval</filePath>
<attachments>
<attachment>
<originId>Yellow</originId>
<displayName>Pufferfish Swim</displayName>
<filePath>pufferfish-yellow.png</filePath>
</attachment>
</attachments>
</instance>
<instance>
<filePath>Expert.ditaval</filePath>
<attachments>
<attachment>
<originId>Yellow</originId>
<displayName>Pufferfish Swim</displayName>
<filePath>pufferfish-yellow.png</filePath>
</attachment>
</attachments>
</instance>
</instances>
</resource>
</resources>
</controlFile>

Once published to Fluid Topics, Pufferfish Swim image is available in the Attachments tab of the Reader page when users view the Novice and Expert instances of the Pufferfish DITA map.

It is necessary to create one instance element for each DITAVAL variant:

- It is possible to provide more instances, and declare the map attachment only once for all of them.
OR

- It is possible to provide the instance only once, and then declare all attachments.
See the following section for use examples.