Below is a list of tags related to graphical objects:
ScreenInfo - Information about how a ScreenShot was produced |
ScreenShot - Representation of what the user sees or might see on a computer screen |
Graphic - Graphical data, or a pointer to an external entity containing such data, to be rendered as an object, not in-line |
InlineGraphic - Graphical data, or a pointer to an external entity containing such data, to be rendered in-line |
Documentation for graphical applications demands screenshots, pictures of icons and buttons, and other graphical elements. DocBook has tags to support screenshots, graphics, and inline graphics. The examples below contain the same picture as a screenshot and as an inline graphic.
![]() | Please do not use GIF files in KDE documentation because the compression algorithm used in the GIF format has problematic patent issues. The preferred format is now PNG. |
Example 3-11. An Inline Graphic
<para> Here are a bunch of rectangles: <inlinegraphic fileref="rectangles.png" format="png" align="center"></inlinegraphic> </para> |
The <InlineGraphic> tag is a graphic to be displayed alongside text. The FileRef attribute contains the name of the graphic file, the Format attribute contains the type of the graphic file, and the optional Align attribute changes the alignment of the graphic. The example will look something like this when converted to HTML:
Here are a bunch of rectangles:
Example 3-12. A Screenshot
<screenshot> <screeninfo>Colored Rectangles</screeninfo> <graphic fileref="rectangles.png" format="png"></graphic> </screenshot> |
The <ScreenShot> tag designates a screenshot with the <ScreenInfo> tag providing a textual description of the screen shot. The heart of the ScreenShot is the Graphic tag which points to a graphic file as explained in the first example. A screen shot looks something like this when converted to HTML: