9.3 Including flags for ditaval conditions

By default, DITA2Go includes, in output, flags based on conditional processing attributes in any ditaval files associated with your DITA document, or on settings you specify in your project configuration file.

To omit conditional flags from output:

[ConditionOptions]
; UseConditionalFlagging = Yes (default, set flags per ditaval file
; or flag-related sections below), or No (do not include flags)
UseConditionalFlagging = No

If UseConditionalFlagging=Yes and you are producing HTML output, you might want to include conditional flagging in CSS. DITA2Go can flag classes, and optionally create a special CSS file for flagged classes.

To name a special CSS file for flagged classes:

[ConditionOptions]
; CSSFlagsFile = name of CSS file to use for flagging classes for
; HTML outputs.  If not specified, related settings below ignored.
CSSFlagsFile = flags.css

If your project configuration file includes a value for CSSFlagsFile, by default DITA2Go creates a CSS file for flagged classes, places this file in your output directory, and causes the flags file to be referenced in the <head> section after your main CSS file.

To prevent DITA2Go from writing a CSS flags file:

[ConditionOptions]
; WriteFlagsFile = Yes (default, write in output directory) or
; No (do not write)
WriteFlagsFile = No

To prevent DITA2Go from including a reference to a CSS flags file:

[ConditionOptions]
; ReferenceFlagsFile = Yes (default, reference after main CSS file
; in output document head) or No (do not reference).
ReferenceFlagsFile = No

By default, the CSS file for flags remains a separate file; however, you can have DITA2Go append the CSS flags file to your main CSS file:

[ConditionOptions]
; AppendFlagsFile = No (default, keep separate from usual CSS) or
; Yes (append to regular CSS file if that file is being written)
AppendFlagsFile = Yes

JavaHelp CSS breaks flagging

If you are producing JavaHelp, be aware that JavaHelp does not recognize multiple classes, but instead uses the first class encountered in the CSS file (regardless of the order in the class attribute itself) and ignores the rest. This breaks flagging for everything except image (where DITA2Go inserts the image in the HTML output).

See also:

§9.2 Defining conditional actions

Previous Topic:  9.2.5 Passing attribute values through in output

Next Topic:  9.4 Configuring conditional flags

Parent Topic:  9. Specifying conditional processing

Sibling Topics:

9.1 Extracting conditions from ditaval files

9.2 Defining conditional actions

9.4 Configuring conditional flags

9.5 Assigning attributes with conditional flags

9.6 Scoping and filtering within maps