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>
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) ) |
Doctype | Parents |
---|---|
bookmap | map, topicref, relcell, frontmatter, backmatter, draftintro, preface, chapter, part, appendix, notices, glossarylist, topichead, topicgroup |
map | map, topicref, relcell, topichead, topicgroup |
+ map/topicref mapgroup-d/topicgroup
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 |
Return to main page.
OASIS DITA Language Specification v1.1 -- Committee Draft 02, 8 May 2007
Copyright © OASIS Open 2005, 2007. All Rights Reserved.