DocBook: The Definitive Guide

docbook: the definitive guide
By Norman Walsh & Leonard Muellner
1st Edition October 1999
1-56592-580-7, Order Number: 5807
652 pages, $36.95 , Includes CD-ROM

DocBook: The Definitive Guide


MediaObject -- A displayed media object (video, audio, image, etc.)


Content Model

MediaObject ::= (ObjectInfo?,  (VideoObject|AudioObject|ImageObject),  (VideoObject|AudioObject|ImageObject|TextObject)*,  Caption?)


Common attributes

Tag Minimization

Both the start- and end-tags are required for this element.

Parameter Entities



This element contains a set of alternative "media objects." In DocBook V3.1, three types of external objects are defined: VideoObjects, AudioObjects, and ImageObjects. Additional textual descriptions may be provided with TextObjects.

Processing expectations

Formatted as a displayed block.

The primary purpose of the MediaObject is to provide a wrapper around a set of alternative presentations of the same information.

If possible, the processing system should use the content of the first object within the MediaObject. If the first object cannot be used, the remaining objects should be considered in the order that they occur. A processor should use the first object that it can, although it is free to choose any of the remaining objects if the primary one cannot be used.

Under no circumstances should more than one object in a MediaObject be used or presented at the same time.

For example, a MediaObject might contain a video, a high resolution image, a low resolution image, a long text description, and a short text description. In a "high end" online system, the video is used. For print publishing, the high resolution image is used. For other online systems, either the high or low resolution image is used, possibly including the short text description as the online alternative. In a text-only environment, either the long or short text descriptions are used.

(5.0) Future Changes

In DocBook V5.0, MediaObject will replace Graphic.


These elements contain MediaObject: Answer, Appendix, ArtHeader, Article, BiblioDiv, Bibliography, BlockQuote, BookInfo, Callout, Caution, Chapter, DocInfo, entry, Equation, Example, Figure, Footnote, Glossary, GlossDef, GlossDiv, Important, Index, IndexDiv, InformalEquation, InformalExample, InformalFigure, InformalTable, ListItem, MsgExplan, MsgText, Note, ObjectInfo, Para, PartIntro, Preface, Procedure, QandADiv, QandASet, Question, RefSect1, RefSect1Info, RefSect2, RefSect2Info, RefSect3, RefSect3Info, RefSynopsisDiv, RefSynopsisDivInfo, ScreenShot, Sect1, Sect1Info, Sect2, Sect2Info, Sect3, Sect3Info, Sect4, Sect4Info, Sect5, Sect5Info, Section, SectionInfo, SetIndex, SetInfo, Sidebar, SimpleSect, Step, Synopsis, Table, Tip, Warning.


The following elements occur in MediaObject: AudioObject, Caption, ImageObject, ObjectInfo, TextObject, VideoObject.

In some contexts, the following elements are allowed anywhere: BeginPage, IndexTerm.

See Also

Alt, AudioObject, Caption, Graphic, ImageObject, InlineGraphic, InlineMediaObject, TextObject, VideoObject


For examples, see AudioObject, ImageObject, InformalFigure, VideoObject.


Back to: DocBook: The Definitive Guide

O'Reilly Home | O'Reilly Bookstores | How to Order | O'Reilly Contacts
International | About O'Reilly | Affiliated Companies

© 1999, O'Reilly & Associates, Inc.

DocBook. The Definitive Guide
DocBook 5: The Definitive Guide
ISBN: 0596805020
EAN: 2147483647
Year: 1999
Pages: 412
Authors: Walsh Norman, Richard L. Hamilton

Similar book on Amazon
DocBook XSL: The Complete Guide (4th Edition)
DocBook XSL: The Complete Guide (4th Edition)
XSLT, 2nd Edition
XSLT, 2nd Edition
XSLT Cookbook: Solutions and Examples for XML and XSLT Developers, 2nd Edition
XSLT Cookbook: Solutions and Examples for XML and XSLT Developers, 2nd Edition
XML: Visual QuickStart Guide (2nd Edition)
XML: Visual QuickStart Guide (2nd Edition) © 2008-2017.
If you may any questions please contact us: