24.7.2 Specifying what to include in a <fig> wrapper

When DITA2Go wraps image and title in a <fig> element, by default DITA2Go closes the <fig> element before moving on to the following content. To direct DITA2Go to include in <fig> any following elements that are valid:

[DITAOptions]
; CloseFigAfterImage = Yes (default) or No (leave fig open for more)
CloseFigAfterImage = No

By default, DITA2Go wraps all contiguous images and their titles in a single <fig> element. To make sure each of a series of images is wrapped in its own <fig> element:

[DITAOptions]
; MultiImageFigures = Yes (default)
; or No (allow only one image in a fig)
MultiImageFigures = No

To specify that figure titles precede their images:

[DITAOptions]
; FigureTitleStartsFigure = No (default, title is below image),
; or Yes (title is above image)
FigureTitleStartsFigure = Yes

To prevent an image from being wrapped in a <fig> element, assign the NoFig format property to the enclosing paragraph format. For example:

[HTMLParaStyles]
; NoFig is used in DITA for a graphic anchor para to prevent wrapping
; of the image inside it in a fig tag.
GraphAnchor = NoFig

This works only if the enclosing format is used consistently for images that should not be wrapped, and not for any that should be wrapped.

To make sure images with one particular enclosing format are wrapped, when the rest are not (for example):

[HTMLParaStyles]
; Figure is used in DITA for a graphic anchor para to ensure wrapping
; of the image inside it in a fig tag.
SpecialGraphAnchor = Figure
* = NoFig

See §3.6 Using wildcards in configuration settings.

Previous Topic:  24.7.1 Designating ancestors for <image> and <fig> elements

Next Topic:  24.7.3 Omitting size attributes from images for DITA output

Parent Topic:  24.7 Specifying options for images in DITA XML

Sibling Topics:

24.7.1 Designating ancestors for <image> and <fig> elements

24.7.3 Omitting size attributes from images for DITA output