3.3.2.6 <topicset>

The <topicset> element defines a complete unit of content that can be reused in other DITA maps or other <topicset> elements. Unlike the base <topicref> element, the <topicset> is explicitly intended to define a set of topics that are often or always used as a unit; it can be especially useful for task composition in which larger tasks are composed of smaller tasks. The @id attribute on a <topicset> is required, which ensures that the complete unit is available for reuse in other contexts.

A <topicset> is similar to a source file that contains nested topics, in that the combination of topics constitutes a complete self-contained unit. That unit of content can stand independently of the containing, prior, and following content within the original map context.

Content models

See appendix for information about this element in OASIS document type shells.

Inheritance

+ map/topicref mapgroup-d/topicset

Example

This <topicset> represents a set of overview information about SQL. The information is reusable as a unit.

<topicset id="sqlbasics" href="sqlOverview.dita">
  <topicref href="sqlSelection.dita"/>
  <topicref href="sqlJoin.dita"/>
  <topicref href="sqlFilter.dita"/>
  <!-- ... -->
</topicset>

Attributes

The following attributes are available on this element: Universal attribute group (with a narrowed definition of @id, given below), Link relationship attribute group (with a narrowed definition of @href, given below), Attributes common to many map elements , Topicref element attributes group , outputclass, @keys , and @keyref .

@id (REQUIRED)
This ID is the target for references by to the current set of information. The ID is required in order to ensure that a <topicset> is defined as a reusable unit of information. See ID attribute for more details.
@href
A pointer to the resource represented by the <topicref>. See The href attribute for detailed information on supported values and processing implications. References to DITA content cannot be below the topic level: that is, you cannot reference individual elements inside a topic. References to content other than DITA topics should use the @format attribute to identify the kind of resource being referenced.