Remove a DITA Map Attachment - 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

To remove an attachment from a DITA map:

  1. In the ditamap file, delete the topicref corresponding to the attachment to be removed.
  2. Reupload the DITA archive in the Knowledge Hub.

Example

In this scenario, the following ditamap file was used to publish a map with a PDF document and a video as attachments:

<?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"/>
</map>

The ZIP archive used to publish this map and its attachments contained the following elements:

pufferfish.ditamap
pufferfish-definition.dita
pufferfish-natural-defenses.dita
Pufferfish-story.pdf
Pufferfish-video.mp4

In Fluid Topics, the Pufferfish Story and Pufferfish Video map attachments are available for the Pufferfish map.

The steps to remove the Pufferfish Story map attachment are as follows:

  1. Remove the topicref corresponding to the PDF attachment in the ditamap file:

    <?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 Video" href="Pufferfish-video.mp4" type="ft:attachment" processing-role="resource-only"/>
    </map>

    Only the video reference remains in the ditamap file.

  2. Upload a new ZIP archive with the updated ditamap file and without the PDF file:

    pufferfish.ditamap
    |_ pufferfish-definition.dita
    |_ pufferfish-natural-defenses.dita
    |_ Pufferfish-video.mp4

Once published to Fluid Topics, only the Pufferfish Video is attached to the Pufferfish map.