- Figures and images
Images are placed in topic content using the image element. The image element can stand alone, or can be contained within a figure (fig) element.
- Image file formats
Where there is no strong reason to choose another image file format, you should use SVG or PNG file formats in DITA topics.
- Image alignment, placement, and sizing
The align, placement, width, and height attributes of the image element are used to specify the placement and size of images when generated to an output delivery format.
- Images in titles
Images in topic, figure, and other titles, while technically valid, should not be used.
- Callouts
Callouts with keys, rather than text labels, should be used when identifying parts of an illustration.
- Localising graphics
Where possible, graphics that include text should be managed in SVG format to simplify localisation.
- Multimedia in DITA topics
The object element is used to embed multimedia in DITA topics.
- Figures containing tables
Simple tables can be contained within figures instead of, or in addition to, images.
- Image maps
The imagemap element is used to define image maps (hotspot graphics) in DITA topics.
- WAI compliance
So that output from your DITA source meets accessibility responsibilities, you must include alternative text representations of all images in DITA content.