Skip to content


Folders and files

Last commit message
Last commit date

Latest commit



22 Commits

Repository files navigation

Plugin which allows referring to videos, embedded videos and audio resources in the DITA content. Using the "iframe" outputclass you can also embed other resources like PDF in DITA topics.

Media plugin which converts the DITA object element to various HTML 5 structures like <video>, <audio> or <iframe>.

The plugin works with DITA OT 1.8, 2.x and 3.x.

 1. The DITA structure:
        <object outputclass="audio" type="audio/mpeg" data="Sleep Away.mp3"/>
        is converted to:
        <audio controls="controls"><source type="audio/mpeg" src="Sleep Away.mp3"></source></audio>
 2. The DITA structure:
       <object outputclass="video" type="video/mp4" data="Clip_480_5sec_6mbps_h264.mp4"/>
      is converted to:
      <video controls="controls"><source type="video/mp4" src="Clip_480_5sec_6mbps_h264.mp4"></source></video>
3. The DITA structure:
      <object outputclass="iframe" data=""/>
      is converted to:
      <iframe controls="controls" src=""></iframe>
Instead of specifying the video reference using the @data attribute you can also specify it using a parameter like:
  <param name="src" value="clips/Clip_480_5sec_6mbps_h264.mp4"/>
All other parameter elements specified on the DITA <object> are set as attributes on the generated HTML 5 element. 
When producing the PDF output, the DITA <object> elements which have @outputclass audio/video or iframe are output as links.

The plugin was updated to also produce similar results from Lightweight DITA <audio> and <video> elements.
For example:
 1. The Lightweight DITA structure:
             <source value="Sleep Away.mp3" />

        is converted to:
        <audio controls="controls"><source src="Sleep Away.mp3"></source></audio>
 2. The Lightweight DITA structure:
            <source value="Clip_480_5sec_6mbps_h264.mp4" />

      is converted to:
      <video controls="controls"><source src="Clip_480_5sec_6mbps_h264.mp4"></source></video>
3. The Lightweight DITA structure:
           <source value=""/>

      is converted to:
      <iframe controls="controls" src=""></iframe>

If for a certain HTML type output (for example CHM) you want to add a plain link to the video instead of embedding it there is a parameter called "com.oxygenxml.xhtml.linkToMediaResources" which can be set to "true".

Copyright and License
Copyright 2018 Syncro Soft SRL.

This project is licensed under [Apache License 2.0](


DITA Open Toolki plugin which supports outputting HTML 5 video, audio and embedding YouTube videos




Code of conduct





No releases published


No packages published