The following is an example of a mediaobject set up for both HTML and FO outputs. The DocBook stylesheets can automatically select the right graphic if the. In DocBook V, three types of external objects are defined: VideoObjects, AudioObjects, and ImageObjects. Additional textual descriptions may be provided. version, , xsd:anySimpleType, Specifies the DocBook version of the element and its descendants, from group utes · xml:lang, .
|Published (Last):||16 October 2007|
|PDF File Size:||2.66 Mb|
|ePub File Size:||8.28 Mb|
|Price:||Free* [*Free Regsitration Required]|
That element can be used to track information about the image, such as the software that created it, the current revision, the author, etc. DocBook has two main graphic elements. Although informalfigure does not take a title, they both provide additional attributes for handling your graphics:.
If all of these tests fail on the first imageobjectit repeats them on subsequent objects until it finds docbok acceptable one. The DocBook stylesheets can automatically select the right graphic if the imageobject elements have a role attribute of either html or fo.
When you process this example with the html stylesheet, you get the PNG graphic, and when you process it with the FO stylesheet, you get the PDF graphic. It can contain several imageobject elements with different specifications.
If you are processing with the FOP processor, then set the parameter preferred. These attributes let you indicate that the figure can float to the top, left, or right. If so, then it accepts that object and does not consider any others.
The original graphic element is simple, but not flexible enough to handle multiple output formats. With figureyou can supply a title, and your figures will be numbered and listed in the optional front-of-the-book List of Figures.
Remember that the role attribute goes on the imageobject element, not the docboom. Each imagedata element indicates its file name and format. If it does not have a format attribute, it extracts the filename extension from the fileref attribute.
Stylesheet’s selection process
If two objects are acceptable, only the first can ever be selected with this method. It looks at the first imageobject inside the mediaobject. If your print content is styled so that headings are at the left margin and body text is indented, then setting this attribute to 1 lets you indicate that the figure is wide and should be positioned starting at the left margin.
If you do not use the role attribute to select from among several imageobject elements, then the stylesheets will try to make a choice based medaobject file format.
If you use example or informalexamplethen you can use the example. The stylesheets contain several lists of file dcobook that are acceptable for each output type.
Because imageobject can also contain an objectinfo element. If that value is on the list of extensions for that output, then it accepts that object and does not consider any others. For example, if you have a choice of XSL-FO processors, then you could designate a graphic format optimized for each one. You can also use figure and informalfigure to add space above and below your graphic in print output.
Usually, the various images in a mediaobject are different formats of the same illustration, with the idea that only one of them at a time will be used by the stylesheet.
You could use profiling to select from among several graphic mediaobjext, but mediaobject is designed to do it without the need for the profiling step. The mediaobject element contains two graphical elements. The same is true for informal. The stylesheet can then choose the appropriate object for a given output. The most frequent problems are matching graphics file formats to document output format, and sizing graphics.
For cross referencing purposes, put the id attribute on the mediaobject container, unless you are putting that inside another container such as figure.
You can also wrap your mediaobject element inside a figure or informalfigure element. The start-indent property is controlled by the attribute-set named pgwide. The automatic selection behavior is controlled by the use. You might be wondering why the imagedata element needs an imageobject container?