topicset

Darwin Information Typing Architecture (DITA) Version 1.3 Part 1: Base Edition

version
1.3
author
OASIS DITA Technical Committee

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.