Business need
Companies often rely on platforms such as YouTube for the hosting of promotional or educational videos.
To provide users with a unified documentation experience, it is possible to embed YouTube videos in Fluid Topics.
Overview of the solution
This solution consists in uploading videos as articles through the default FTML connector.
For more information, see the FTML Connector Reference Guide.
Procedure
-
Create an FTML map (
.ftmap
file), as in the following example:<?xml version='1.0' encoding='UTF-8'?> <ft:map ft:title="Fluid Topics showcase" ft:lang="en-US" ft:editorialType="article" xmlns:ft="http://ref.fluidtopics.com/v3/ft#" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:noNamespaceSchemaLocation="ftmap.xsd"> <ft:metas> <ft:meta key="Category">YouTube videos</ft:meta> <ft:meta key="audience">public</ft:meta> </ft:metas> <ft:toc> <ft:node ft:title="Fluid Topics - Introduction to the Discovery Portal" href="youtube_video.html"/> </ft:toc>
Modify the title, metadata, and filenames as needed.
-
Create an HTML file, as in the following example:
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> </head> <body> <p>Here is a simple YouTube video published to Fluid Topics using the FTML source. The publication is an article.</p> <iframe width="560" height="315" src="https://www.youtube.com/embed/-sXyFuEZPYg?si=rzYVY6gbW3faCD8Z" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" allowfullscreen></iframe> </body> </html>
The filename of the HTML file must match the one referenced in step 1 (for example,
youtube_video.html
). -
Replace the
<iframe>
element with the one corresponding to the video to embed:- Go to the address of the video on YouTube.
- Select Share, then Embed, and copy the content of the
<iframe>
. - Paste it in the HTML file.
- Save the file.
-
Compress the HTML file and the FTML map.
-
Publish the archive to Fluid Topics using the default FTML connector.
Example
This video has been embedded using this procedure: