Adding Video, Audio, and Embedded HTML Resources
Edit online

You can insert references to media resources (such as videos, audio clips, or embedded HTML frames) in your DITA, DocBook, or XHTML topics. The media resources can be played directly in Author mode and in all HTML5-based outputs. There is a toolbar button () that allows you to insert and configure a reference to the media resource. You can also drag media files from your system explorer or the Navigator view and drop them into your documents (or copy and paste them).

Table 1. Supported Media Types
Media Description Type Supported Size Properties
mp3 Moving Picture Experts Group Layer-3 Audio audio Width
wav Windows Wave audio Width
pcm Pulse Code Modulation audio Width
m4a Moving Picture Experts Group Layer-4 Audio audio Width
aif Audio Interchange Format audio Width
mp4 Moving Picture Experts Group Layer-4 Video video Width & Height
flv Flash Video video Width & Height
m4v Itunes Video File video Width & Height
avi Audio Video Interleaved video Width & Height
embedded video (such as YouTube or Vimeo) Embedded Iframe Code iframe Width & Height

Adding a Media Resource

To insert a media resource in a document, use the following procedure:

  1. Place the cursor at the location where you want the media resource.
  2. Select the Insert Media Resource action from the toolbar. A Chose Media dialog box appears.
    Note: You can also drag media files from your system explorer or the Navigator view and drop them into your documents (or copy and paste them).
  3. Select the URL for the media resource and click Ok.

Result in Author Mode: A reference to the specified media object is inserted and rendered in Author mode so that it can be played directly from there.

Attention:
  • On Mac OS X, if you receive a Blocked Plug-in error message, you need to updated your Flash Player to the latest version.
  • On Ubuntu 17.10, if you receive an error when trying to play videos in Author mode, you need to install the libavformat57 library.

Result in Output: In the publishing stage, the media object is converted to an HTML5 element so that it can be rendered properly and played in all HTML5-based outputs.