The <topicSubjectTable> element is a specialized relationship table which allows a map to use relationship tables to associate topics with subjects. Tools (such as search tools) may use these classifications to retrieve content that is relative to a specific subject or combination of subjects.
In a <topicSubjectTable>, the first column is reserved for references to content. Subsequent columns are reserved for subjects that classify the content, each column supplying the subjects for a different category as identified in the header. The table resembles a traditional relationship table in which the first column identifies the source and the other columns identify the targets, but the relationship reflects the subjects covered by the content rather than linking between documents.
Doctype | Content model |
---|---|
classifyMap | ( (title) then (topicmeta) (optional) then (topicSubjectHeader) (optional) then (topicSubjectRow) (one or more) ) |
The topic subject table below classifies topics with goals for retrieval and with operating systems for filtering. The map makes use of definitions in a subject scheme map, defined separately.
<subjectScheme> <hasKind> <subjectdef href="goalType.dita" keys="goal"> <subjectdef href="performanceGoal.dita" keys="performance"/> <subjectdef href="reliabilityGoal.dita" keys="reliability"/> </subjectdef> <subjectdef href="operatingSystem.dita" keys="os"> <subjectdef href="linuxOS.dita" keys="linux"/> <subjectdef href="unixOS.dita" keys="unix"/> <subjectdef href="windowsOS.dita" keys="windows"/> </subjectdef> </hasKind> </subjectScheme>
<map> ... <topicSubjectTable> <topicSubjectHeader> <topicCell type="task"/> <subjectCell> <topicsubject keyref="goal"/> </subjectCell> <subjectCell> <topicapply keyref="os"/> </subjectCell> </topicSubjectHeader> <topicSubjectRow> <topicCell> <topicref href="webServerStart.dita" navtitle="Configuring cron for efficient startup"/> <topicref href="dbDisk.dita" navtitle="Allocating raw storage"/> </topicCell> <subjectCell> <topicsubject keyref="performance"/> </subjectCell> <subjectCell> <topicapply keyref="linux"/> <topicapply keyref="unix"/> </subjectCell> </topicSubjectRow> <topicSubjectRow> <topicCell> <topicref href="webLogAnalyze.dita" navtitle="Analyzing web logs for service issues"/> <topicref href="webDenialService.dita" navtitle="Detecting denial-of-service attacks"/> </topicCell> <subjectCell> <topicsubject keyref="reliability"/> </subjectCell> <subjectCell> <topicapply keyref="linux"/> <topicapply keyref="unix"/> <topicapply keyref="windows"/> </subjectCell> </topicSubjectRow> ... </topicSubjectTable> </map>
A table view of this <topicSubjectTable> might look as follows. This is only one of many possible views; to aid in understanding the example, the content topics in the first column are displayed using only their titles, and related subjects are displayed using only their keyref attribute value.
task | goal | os |
---|---|---|
Configuring cron for efficient startup |
performance |
linux |
Analyzing web logs for service issues |
reliability |
linux |
Name | Description | Data Type | Default Value | Required? |
---|---|---|---|---|
topicref-atts-no-toc attribute group (collection-type, processing-role, type, scope, locktitle, format, linking, toc, print, search, chunk) | A related set of attributes. See topicref-atts, topicref-atts-no-toc, and topicref-atts-without-format attribute groups. | |||
univ-atts attribute group (includes select-atts, id-atts, and localization-atts groups) | A set of related attributes, described in univ-atts attribute group | |||
global-atts attribute group (xtrf, xtrc) | A set of related attributes, described in global-atts attribute group | |||
class | A common attribute described in Other common DITA attributes |
Return to main page.
OASIS DITA Version 1.2 -- OASIS Standard, 1 December 2010
Copyright © OASIS Open 2005, 2010. All Rights Reserved.