`<no-topic-nesting>`

The <no-topic-nesting> element is a placeholder in the DITA architecture.

Usage information

The <no-topic-nesting> element is not intended for use in DITA source files.

The <no-topic-nesting> element is designed for use only when configuring a document-type shell. It enables the DITA practitioner to disallow topic nesting for the topic type.

Attributes

The following attribute is available on this element: @class.

Example

The following code sample shows how the <no-topic-nesting> can be used in a document-type shell to disallow topic nesting.

In the DTD document-type shell that is distributed by OASIS for the base topic, the %topic-info-types; entity is set to topic. This means that <topic> elements can nest other <topic> elements. The following code sample shows how a DITA practitioner redefines the entity to no-topic-nesting:

<!ENTITY % topic-info-types
              "no-topic-nesting"
>

Now, topics that use that document-type shell can no longer nest other topics. DTD grammar rules require that some element be specified in this entity, so <no-topic-nesting> is used as a placeholder.