topicgroup

The <topicgroup> element is for creating groups of <topicref> elements without affecting the hierarchy, as opposed to nested <topicref> elements within a <topicref>, which does imply a structural hierarchy. It is typically used outside a hierarchy to identify groups for linking without affecting the resulting toc/navigation output.

In the following example, each of the topicref elements inherit the audience and linking attribute values. This way the attributes can be set in one place for a group of topicref elements, without affecting the navigation hierarchy.

<topicgroup audience="novice" linking="none">
  <topicref href="this.dita"/>
  <topicref href="that.dita"/>
  <topicref href="theother.dita"/>
</topicgroup>

Contains

Doctype	Content model
map	( ( topicmeta) (optional) then ( topicref or topichead or topicgroup or navref or anchor or data or data-about) (any number) )
bookmap	( ( topicmeta) (optional) then ( topicref or topichead or topicgroup or navref or anchor or data or data-about) (any number) )

Contained by

Doctype	Parents
bookmap	map, topicref, relcell, frontmatter, backmatter, draftintro, preface, chapter, part, appendix, notices, glossarylist, topichead, topicgroup
map	map, topicref, relcell, topichead, topicgroup

Inheritance:

+ map/topicref mapgroup-d/topicgroup

Attributes

Name	Description	Data Type	Default Value	Required?
%topicref-atts; (collection-type, type, scope, locktitle, format, linking, toc, print, search, chunk)	A set of related attributes. See %topicref-atts; and %topicref-atts-no-toc;.	parameter entity	PE not applicable	Not applicable
%univ-atts; (%select-atts;, %id-atts;, %localization-atts;)	A set of related attributes, described at %univ-atts;	parameter entity	PE not applicable	Not applicable
%global-atts; (xtrf, xtrc)	A set of related attributes, described at %global-atts;	parameter entity	PE not applicable	Not applicable
class, outputclass	Common attributes described in Other common DITA attributes