DITA Profiling / Conditional Text
DITA offers support for conditionally profiling content by using profiling attributes. With Oxygen XML Editor Eclipse plugin, you can define values for the DITA profiling attributes and they can be easily managed to filter content in the published output. You can switch between profile sets to see how the edited content looks like before publishing.
Oxygen XML Editor Eclipse plugin includes a Attributes and Condition Sets preferences page where you can create and manage profiling attributes and condition sets. Oxygen XML Editor Eclipse plugin also offers convenient support for customizing and controlling profiling attribute values with a subject scheme or DITAVAL file.
Profiling Attributes
You can profile content elements or map elements by adding one or more of the default DITA
profiling attributes (@product
, @platform
,
@audience
, @rev
, @props
, and
@otherprops
). You can also create your own custom profiling attributes and
profiling condition sets. The profiling attributes may contain one or more tokens that
represent conditions to be applied to the content when a publication is built.
For example, you could define a section of a topic that would only be included for a
publication related to the Windows platform by adding the @platform
profiling attribute:
<section platform="windows">
For information about creating and editing profiling attributes, see Creating and Editing Profiling Attributes in DITA.
Profiling Conditions
DITA allows you to conditionally profile parts of a topic so that certain parts of the topic are displayed when certain profiling conditions are set. Profiling conditions can be set both within topics and in maps. When set in a topic, they allow you to suppress an element (such as paragraph), step in a procedure, item in a list, or even a phrase within a sentence. When set in a map, they allow you to suppress an entire topic or group of topics. You can then create a variety of publications from a single map by applying profiling conditions to the build.
For information about creating and editing condition sets, see Creating and Editing Profiling Condition Sets in DITA .