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):||4 December 2008|
|PDF File Size:||13.10 Mb|
|ePub File Size:||19.63 Mb|
|Price:||Free* [*Free Regsitration Required]|
Other stylesheet mrdiaobject such as Website or your own will use the value for the stock stylesheet it is based upon.
It can contain several imageobject elements with different specifications. 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 socbook be used by the stylesheet. If you want finer control, then you have the option to use any role values you want. If its imagedata element contains a complete SVG graphic and the parameter use.
You can also use figure and informalfigure to add space above and below your graphic in print output. That element can be used to track information about the image, such as the software that created it, the current revision, the author, etc. The automatic selection behavior is controlled by the use. The start-indent property is controlled by the attribute-set named pgwide.
Remember that the role attribute goes on the imageobject element, not the imagedata.
Stylesheet’s selection process
Graphics are a frequent cause of problems in DocBook documents. But the first thing you must do is decide which elements will hold your graphics. It looks at the first imageobject inside the mediaobject. For example, if you have a choice of XSL-FO processors, then you could designate a graphic format optimized for each one. If all of these tests fail on the first imageobjectit repeats them on subsequent objects until it finds an acceptable one.
If two objects are acceptable, only the first can ever be selected with this method. If so, then it accepts that object and does not consider any others.
If you use example or informalexamplethen you can use the example. Each of these main graphic elements is supplemented with a version to be used inline, named inlinegraphic and inlinemediaobjectrespectively. Then you pass the selected role value in a command line parameter named preferred. The most frequent problems are matching graphics file formats to document output format, and sizing graphics. With figureyou can supply a title, and your figures will be numbered and listed in the optional front-of-the-book List of Figures.
The mediaobject element contains two graphical elements. If the fileref does not have an extension, it checks the graphic. Because imageobject can also contain an objectinfo element. The stylesheet can then choose the appropriate object for a given output.
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. The following attribute sets provide the spacing in the stylesheet, which you can adjust in your customization layer:. The preferred element for graphics is mediaobject.
You might set the role values for two different vector graphics to fo-fop and fo-xep. Each imagedata element indicates its file name and format. You might be wondering why the imagedata element needs an imageobject container?
Simplified DocBook DTD: Element mediaobject
You could also put sizing attributes there. You can also wrap your mediaobject element inside ddocbook figure or informalfigure element. You could use profiling to select from among several graphic elements, but mediaobject is designed to do it without the need for the profiling step. This selection method is often sufficient, but is somewhat less precise than selecting by role.
The same is true for informal.
The DocBook stylesheets can automatically select the right graphic if the imageobject elements have a role attribute of either html or fo. DocBook has two main graphic elements. If it does not have a format attribute, it extracts the filename extension from the fileref attribute. These attributes let you indicate that the figure can float to the top, mediaobbject, or right.
If mediaobjecf are using XEP, then set the parameter preferred. Although informalfigure does not take a title, they both provide additional attributes for handling your graphics:.