Use a control file to attach a URL to a DITA map - Fluid Topics - Latest

Map Attachments

Category
Technical Notes
Audience
public
Version
Latest

When using a control file to attach a URL to a DITA map, add the following lines to the FluidTopicsControlFile.xml file:

<?xml version='1.0' encoding='utf-8'?>
<controlFile>
  <resources>
    <resource>
      <filePath>my_map.ditamap</filePath>
      <attachments>
        <attachment>
          <originUrl>$URL_TO_ATTACH</originUrl>
          <originId>my_attachment</originId>
          <displayName>My link</displayName>
          <mimeType>$MIMETYPE_OF_THE_URL_TARGET</mimeType>
        </attachment>      
      </attachments>
    </resource>
  </resources>
</controlFile>

In the attachment sub node, the only parameter that must be set manually is the originURL parameter. If values for the originId and/or displayName parameters are not set manually, Fluid Topics extracts their values from that set for the originURL parameter. If a value is not set for the mimeType parameter, Fluid Topics computes it automatically.

In the resources sub node, filePath expects the absolute path to the DITA map file in the archive used to upload the DITA map to Fluid Topics. It can be retrieved in the dita:mapPath field of the document's Metadata journal.