Media

Capture information about non-XML content (such as video or audio files) outside the normal flow of text as media, in a floatGroup element.

//floatGroup/mediaGroup/media/@class

//floatGroup/mediaGroup/media[@class='MIME']/@mime

At the point where the media should be displayed, insert a processing-instruction in the text and set the ID value to the id attribute value of the corresponding mediaGroup element. For example:


      <?Insert-Media ID="acref-9780192831934-chapter-1-mediaGroup-1"?>

Within the mediaGroup element, each item consists of a media element containing a fileRef element identifying the file containing the actual content, an optional titleGroup, and a caption containing the caption text.

Do not capture multiple media elements inside a mediaGroup. For each media item, use a new mediaGroup element. Do not capture multiple fileRef elements inside of media elements – for each individual file use a new mediaGroup and media element.

Each media element must have a class attribute describing the content to which it refers. The following are valid values of class:

MIME
graphic
audio
video
document

When the value of class is MIME, capture the internet media (MIME) type of the attached file using mime.

Set the value of the fileName attribute of the fileRef element to the file name.

Do not include the folder name or any folder structure in the fileName attribute.

When the value of class is audio or video, capture the Brightcove ID of the media asset (the ID assigned by Brightcove, not the reference ID assigned by the user) in the mediaRef attribute of the fileRef element.

Where a placeholder image is supplied, specify it as a graphic sibling to fileRef; for instructions on how to capture graphic, see Figures.

Mark up references to media content in the same way as references to figures.

Cross-reference to a media object


      <p>(<xrefGrp>Fig. <xref ref="med-9780199566990-chapter-2-figureGroup-10">4.10</xref>
             </xrefGrp>; <xrefGrp>
                 <xref ref="med-9780199566990-chapter-3-mediaGroup-111">4.1</xref>
             </xrefGrp>)</p>

Example media group - Video


      <mediaGroup id="med-9780199566990-chapter-2-mediaGroup-22" doi="10.1093/med/9780199566990.003.0002.012.022">
        <media class="video" id="med-9780199566990-chapter-2-media-22"><caption>
 <p>
                         <enumerator>4.22</enumerator> En face view by transoesophageal three-dimensional
              echocardiography of a closure device for a patent foramen ovale in situ in the atrial
              septum. Also see 4.10 and 4.11.</p></caption><fileRef fileName="med-9780199566990-video-001.avi" id="med-9780199566990-chapter-2-fileRef-22" mediaRef="185958883000"/>
        </media>
      </mediaGroup>

Example media group - Sibelius music score using MIME, with placeholder image


      <mediaGroup id="omo-9780333608005-e-40023-mediaGroup-1" doi="10.1093/acref/9780333608005.023.40023.012.001">
        <media class="MIME" mime="application/x-sibelius-score"><titleGroup id="omo-9780333608005-e-40023-titleGroup-16">
 <title>
   <p>
                             <enumerator>Ex. 1</enumerator> Armstrong's solo in "Chimes Blues"</p>
 </title></titleGroup><graphic sysId="omo-9780333608005-e-40023-graphic-001.gif" id="omo-9780333608005-e-40023-graphic-001"/><fileRef fileName="omo-9780333608005-e-40023-file-001.sib"/>
        </media>
      </mediaGroup>

Cross-reference to a media object


      <p>(<xrefGrp>Fig. <xref ref="med-9780199566990-chapter-2-figureGroup-10">4.10</xref>
             </xrefGrp>; <xrefGrp>
                 <xref ref="med-9780199566990-chapter-3-mediaGroup-111">4.1</xref>
             </xrefGrp>)</p>

Cross-reference to a media object

Example media group - Video

Example media group - Sibelius music score using MIME, with placeholder image

Cross-reference to a media object

Sub-topics