Attach a URL to an Ftmap - Fluid Topics - 3.10 - Technical Notes

Manage Map Attachments in Fluid Topics

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

To attach one or more URLs to an Ftmap, prepare a ZIP archive with following elements:

  • The HTML or Markdown topics referred to in the Ftmap file.
  • All URLs to attach.
  • An Ftmap file with each URL between <ft:attachment> tags as follows:

<ft:map xmlns:ft="http://ref.fluidtopics.com/v3/ft#" ft:lang="en-US" ft:originID="ftmap_id" ft:title="My Map Title"
<ft:toc>
<ft:node ft:originID="first_topic" href="topics/topic_1.html" ft:title="My Topic 1" type="topic">
<ft:node ft:originID="origin_id" href="topics/topic_2.html" ft:title="My Topic 2" type="topic">
</ft:node>
</ft:node>
</ft:toc>
<ft:attachments>
<ft:attachment>
<ft:originID>Linked_image_1</ft:originID>
<ft:url>https://www.webpage.com/image.jpg</ft:url>
<ft:displayName>Linked image</ft:displayName>
<ft:mimeType>image/jpeg</ft:mimeType>
</ft:attachment>
</ft:attachments>
</ft:map>

Where:

  • ft:attachment expects all the information related to the attachment as follows:

Tag

Description

Mandatory?

Default value

ft:originID

The identifier of the attachment. Should be unique among all content uploaded through the FTML source.

No

ft:url

ft:filePath

The URL to attach to the Ftmap.

Yes

ft:displayName

The name displayed in the Reader page.

No

Extracted from ft:url

ft:mimeType

The MIME type indicating the nature and format of the content.

No

Extracted from ft:url

Be careful not to confuse the ft:originID metadata associated with a map attachment and the ft:originID metadata associated with a topic or map. The first is defined at the attachment level within the <ft:attachment> node of an Ftmap file, whereas the second two can be retrieved in the Metadata journal.