DITAVAL elements

You can create a conditional processing profile to identify which values you want to conditionally process for a particular output, build, or other purpose. The profile has the extension .ditaval to identify it to conditional processing systems.

The .ditaval format has several elements: val, the root element, can contain a style-conflict element followed by prop or revprop elements; the prop and revprop elements can contain startflag and endflag elements; and the startflag and endflag elements can contain alt-text elements.

Notes on ditaval messages

It is recommended but not required that conditional processing code provide a report of any attribute values encountered in content that do not have an explicit action associated with them.

Note on ditaval flagging of images

If an image in DITA content becomes flagged using a background color, the color should be represented as a thick border. If a foreground color is expressed, it should be represented as a thin border.

val
<val> is the root element of a ditaval file.
style-conflict
The style-conflict element declares behavior to be used when one or more flagging methods collide on a single content element.
prop
Identifies an attribute, and usually values in the attribute, to take an action on. The attribute must be a conditional processing attribute: platform, product, audience, props. and otheprops; or a specialization of the props attribute. There can be at most one occurrence of a "prop" element with no attribute specified (setting a default action for every prop element), at most one for each attribute with no value specified (setting the default action for a specific attribute), and at most one with each attribute value specification (to avoid conflicting actions for the same attribute value).
revprop
Identifies a value in the rev attribute that should be flagged in some manner. Unlike the other conditional processing attributes, which can be used for both filtering and flagging, the rev attribute can only be used for flagging. There can be at most one occurrence of a "revprop" element for each attribute value specification (to avoid conflicting actions for the same attribute value).
startflag
The startflag takes an optional image reference and an optional alt-text element for identifying the beginning of flagged content. If an image is specified, the specified image will be used to flag the beginning of the content, with the alt-text contents as alternative text. If alt-text is specified without an image, that text will be used to flag the content instead of an image. If no image and no alt-text are specified, then this element has no defined purpose. The startflag element is allowed inside either prop or revprop.
endflag
The endflag takes an optional image reference and an optional alt-text element for identifying the end of flagged content. If an image is specified, the specified image will be used to flag the end of the content, with the alt-text contents as alternative text. If alt-text is specified without an image, that text will be used to flag the content instead of an image. If no image and no alt-text are specified, then this element has no defined purpose. The endflag element is allowed inside either prop or revprop.
alt-text
An element allowed inside either startflag or endflag to provide alternate text for an image, when the imageref attribute sets an image to be used for flagging. The default alternate text for revprop start of change is a localized translation of "Start of change". The default alternate text for revprop end of change is a localized translation of "End of change".

Previous topic: xNAL domain elements

Next topic: Commonly referenced attributes