Upload a DITA Map with an Attachment - Fluid Topics - 3.6 - Technical Notes

Manage Map Attachments in Fluid Topics

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

Users with the ADMIN or KHUB_ADMIN role can attach files or URLs to a DITA map when publishing it.

Example

The following DITA map is an exhaustive example of the types of attachments that can be added to a DITA map:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE map PUBLIC "-//OASIS//DTD DITA Map//EN" "http://docs.oasis-open.org/dita/v1.1/OS/dtd/map.dtd">
<map title="Pufferfish">
<title>Pufferfish</title>
<topicref href="pufferfish-definition.dita"/>
<topicref href="pufferfish-natural-defenses.dita"/>
<topicref navtitle="Pufferfish Story" href="Pufferfish-story.pdf" type="ft:attachment" processing-role="resource-only"/>
<topicref navtitle="Pufferfish Video" href="Pufferfish-video.mp4" type="ft:attachment" processing-role="resource-only"/>
<topicref navtitle="My little pufferfish" href="pufferfish.png" type="ft:attachment" processing-role="resource-only">
<topicmeta>
<othermeta name="ft:url" content="https://www.pufferfish.com/B91tozyQs9Mx.png"/>
</topicmeta>
</topicref>
<topicref navtitle="Pufferfish Love Explains..., on Live Science" type="ft:attachment" processing-role="resource-only">
<topicmeta>
<othermeta name="ft:url" content="https://www.livescience.com/40132-underwater-mystery-circles.html"/>
</topicmeta>
</topicref>
</map>

Once uploaded successfully, the map attachments are displayed in the Attachments tab of the Reader page. A Type icon appears to the left of the title of each attachment to help users know at a glance what type of content to expect before opening an attachment.

For example, when redirecting users to a PNG image available on a different web page, it can be helpful to display the PNG icon and an arrow in the Reader page. To do so, add the filename with the .png extension in the href attribute as in the following example:

...
<topicref navtitle="My little pufferfish" href="pufferfish.png" type="ft:attachment" processing-role="resource-only">
<topicmeta>
<othermeta name="ft:url" content="https://www.pufferfish.com/B91tozyQs9Mx.png"/>
</topicmeta>
</topicref>
...

This prompts Fluid Topics to display icons showing users that My little pufferfish is both an external link and a PNG image as follows:

A URL attachment with a PNG mime type