Filtering composite (ditabase) topics

Care must be taken when applying conditions to composite topics, as filtering a nested topic through the topicref element will not necessarily result in the topic being excluded.

Although you should avoid the use of composite topics in any case, there are some complications when filtering such content.

If you have a ditamap topicref element with a condition attribute pointing to a topic within a composite topic file, then excluding elements with that attribute in the build process will not result in the (nested) topic being excluded from the output, unless that (nested) topic also has the condition attribute. The processor will include the entire composite topic if any topic within that composite topic is included in the published output.

Even if the chunking feature is used to split the composite DITA topic into multiple HTML topics, for example, the entire contents of the DITA topic will be output unless condition attributes are applied within the topic.