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):||27 April 2015|
|PDF File Size:||18.71 Mb|
|ePub File Size:||9.58 Mb|
|Price:||Free* [*Free Regsitration Required]|
If you want finer control, then you have the option to use any role values you want. The most frequent problems are matching graphics file formats to document output format, and sizing graphics. Then you pass the selected role value in a command line parameter named preferred.
If that is not desirable, then add the changes to the figure. Other stylesheet customizations such as Website or your own will use the value for the stock stylesheet it is based upon. If you use example or informalexamplethen you can use the example. You could also put sizing attributes there. If so, then it accepts that object and does not consider any others.
That element can be used to track information about the image, such as the software that created it, the current revision, the author, etc.
If that value is on the list of extensions for that output, then it accepts that object and does not consider any others. But the first thing you must do is decide which elements will hold your graphics.
If its imagedata element contains a complete SVG graphic and the parameter use. These attributes let you indicate that the figure can float mediaoject the top, left, or right. The stylesheets contain several lists of file formats that are acceptable for each output type. The following attribute sets provide the spacing in the stylesheet, which you mediaonject adjust in your customization layer:.
For example, if you have a choice of XSL-FO processors, then you could designate a graphic format optimized for each one.
DocBook mediaobject – Complete documentation and samples
The preferred element for graphics is mediaobject. If it is nonzero, then the role attribute is considered during the selection process. 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 xocbook stylesheet.
Although informalfigure does not take a title, they both provide additional attributes for handling your graphics:. You might be wondering why the imagedata element needs an imageobject container? You might set the role values for two different vector graphics to fo-fop and mediaobjsct. The same is true for informal. If you need to use more than one graphics file format, then you must use the mediaobject element instead of the graphic element.
If two objects are acceptable, only the vocbook can ever be selected with this method. DocBook has two main graphic elements.
Docbokk you do not use the role attribute to select from among several imageobject elements, then the stylesheets will try to make a choice based on file format. The DocBook stylesheets can automatically select the right graphic if the imageobject elements have a role attribute of either html or fo. This selection method is often sufficient, but is somewhat less precise than selecting by role. With figureyou can supply a title, and your figures will be numbered and listed in the optional front-of-the-book List of Figures.
Each imagedata element indicates its file name and format. You can turn that behavior off if you set the parameter to zero. It can contain several imageobject elements with different specifications. Graphics are a frequent cause of problems in DocBook documents. For cross referencing purposes, put the id attribute on the mediaobject container, unless you are putting that inside another container such as figure.
The stylesheet can then choose the appropriate object for mediaobjecr given output. Because imageobject can also contain an objectinfo element. The automatic selection behavior is controlled by the use.
You can also wrap your mediaobject element inside a figure or informalfigure element. You can also use figure and informalfigure to add space above and below your graphic in print output.
You could use profiling to select from among several graphic elements, but mediaobject is designed to do it without the need for the profiling dodbook. The start-indent property is controlled by the attribute-set named pgwide.