The subjectHead element provides a heading for a group of subjects, for use if the scheme is displayed. For instance, a schememight be displayed to let a user select subjects as part of faceted browsing. The subjectHead element itself does not reference a file and cannot be referenced as a key, so it does not define any controlled values.
Content models
See appendix for information about this element in OASIS document type shells.
Inheritance
- map/topicref subjectScheme/subjectHead
Example
In this example the “Server setup” label doesn't classify content but, when selected, is equivalent to the union of its child subjects. That is, the heading covers content about planning for any application, installing for any application, any task for web servers, or any task for database servers.
<subjectScheme toc="yes" search="no"> <!-- ... --> <subjectHead> <subjectHeadMeta> <navtitle>Server setup</navtitle> </subjectHeadMeta> <subjectdef href="planningTaskType.dita"/> <subjectdef href="installingTaskType.dita"/> <subjectdef href="webServerApp.dita"/> <subjectdef href="databaseApp.dita"/> </subjectHead> <!-- ... --> </subjectScheme>
Attributes
- collection-type
- Collection types describe how links relate to each other. The processing default is "unordered",
although no default is specified in the DTD or Schema. Allowable values for
collection-type on this element are:
- unordered
- Indicates that the order of the child topics is not significant.
- sequence
- Indicates that the order of the child topics is significant; output processors will typically link between them in order.
- -dita-use-conref-target
- See Using the -dita-use-conref-target value for more information.
- linking
- Defines some specific linking characteristics of subject topics. "normal" is the only valid value, and is specified as the default in the DTD, XSD Schema, and RELAX NG implementations. When attribute values cascade, this causes a linking value of "normal" to cascade to the subjects.