Edit online

Inserting Topic Groups

The <topicgroup> element identifies a group of topics (such as a concepts, tasks, or references) or other resources. A <topicgroup> can contain other <topicgroup> elements, allowing you to express navigation or table-of-contents hierarchies, as well as implying relationships between the containing <topicgroup> and its children. You can set the collection-type of a container <topicgroup> to determine how its children are related to each other. Relationships end up expressed as links in the output (with each participant in a relationship having links to the other participants by default).

You can insert a topic group by doing the following:
  • Select Topic Group from the Append Child, Insert Before, or Insert After submenus when invoking the contextual menu in the DITA Maps Manager view.
  • Open the DITA map in the XML editor and select the Insert Topic Group action from the main toolbar (or from the Insert submenu of the contextual menu).

Those actions open the Insert Topic Group dialog box that allows you to easily insert a <topicgroup> element and various attributes can be specified (such as Collection type, Type, Scope, Format, etc.)

Figure 1. Insert Topic Group Dialog Box