Attach a File to a DITA Map with a DITAVAL - Fluid Topics - 3.9 - Technical Notes

Manage Map Attachments in Fluid Topics

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

The following lines show how to attach the Pufferfish Song audio file to the Novice instance 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>pufferfish_song</originId>
<displayName>Pufferfish Song</displayName>
<filePath>pufferfish-song.mp3</filePath>
</attachment>
</attachments>
</instance>
</instances>
</resource>
</resources>
</controlFile>

Once published to Fluid Topics, the Pufferfish Song audio file appears in the Attachment tab of the Reader page when users view the Novice instance 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.