Edit online

How to Add Video and Audio Objects in DITA WebHelp Output

You can insert references to video and audio media resources (such as videos, audio clips, or embedded HTML frames) in your DITA topics and then publish them to WebHelp output. The media objects can be played directly in all HTML5-based outputs, including WebHelp systems.

To add media objects in the WebHelp output generated from DITA documents, follow the procedures below.

Adding Videos to DITA WebHelp Output

  1. Edit the DITA topic and insert a reference to the video by adding an <object> element, as in one of the following examples:
    <object outputclass="video" type="video/mp4" data="MyVideo.mp4"/>
    or, instead of the @data attribute, you can specify the video using a parameter like this:
    <object outputclass="video">
      <param name="src" value="videos/MyVideo.mp4"/>
    </object>
  2. Apply a DITA to WebHelp transformation to obtain the output.
Result: The transformation converts the <object> element to an HTML5 <video> element.
<video controls="controls"><source type="video/mp4" src="MyVideo.mp4"></source>
</video>

Adding Audio Clips to DITA WebHelp Output

  1. Edit the DITA topic and insert a reference to the audio clip by adding an <object> element, as in one of the following examples:
    <object outputclass="audio" type="audio/mpeg" data="MyClip.mp3"/>
    or, instead of the @data attribute, you can specify the video using a parameter like this:
    <object outputclass="audio">
      <param name="src" value="audio/MyClip.mp3"/>
    </object>
  2. Apply a DITA to WebHelp transformation to obtain the output.
Result: The transformation converts the <object> element to an HTML5 <audio> element.
<audio controls="controls"><source type="audio/mpeg" src="MyClip.mp3"></source>
</audio>

Adding Embedded HTML Frames (such as YouTube videos) to DITA WebHelp Output

  1. Edit the DITA topic and insert a reference to the embedded object by manually adding an <object> element, as in one of the following examples:
    <object outputclass="iframe" data="https://www.youtube.com/embed/m_vv2s5Trn4"/>
    or, instead of the @data attribute, you can specify the object using a parameter like this:
    <object outputclass="iframe">
      <param name="src" value="http://www.youtube.com/embed/m_vv2s5Trn4"/>
    </object>
  2. If you want the video to be allowed to play in full screen mode once the document is converted to XHTML output, also add an allowfullscreen parameter and set its value to true:
    <object outputclass="iframe" data="https://www.youtube.com/embed/m_vv2s5Trn4"/>
      <param name="allowfullscreen" value="true"/>
    </object>
  3. Apply a DITA to WebHelp transformation to obtain the output.
Result: The transformation converts the <object> element to an HTML5 <iframe> element.
<iframe controls="controls" src="https://www.youtube.com/embed/m_vv2s5Trn4">
</iframe>