Language reference : Base architecture : Specialization elements : data-about
   
data-about
The <data-about> element identifies the subject of a property when the subject isn't associated with the context in which the property is specified. The property itself is expressed by the <data> element. The <data-about> element handles exception cases where a property must be expressed somewhere other than inside the actual subject of the property. The <data-about> element is particularly useful as a basis for specialization in combination with the <data> element.
Do not use the <data-about> element to identify the object of a property. The href attribute of the <data> element serves that purpose.
Contains
Note: These models represent only the default document types distributed by OASIS. Actual content models will differ with each new document type.
Doctype
Content model
topic, map, concept, ditabase, glossary, glossentry, glossgroup, reference, task, bookmap, classifyMap, subjectScheme, machineryTask, learningAssessment, learningBookmap, learningContent, learningMap, learningOverview, learningPlan, learningSummary
( (data) then (data or data-about) (any number) )
Contained by
Doctype
Content model
topic (base)
map (base), learningMap
topic (technical content)
map (technical content)
concept
ditabase
glossary, glossentry, glossgroup
reference
task (strict), task (general)
bookmap
classifyMap
subjectScheme
machineryTask
learningAssessment, learningOverview, learningSummary
learningBookmap
learningContent
learningPlan
Inheritance
- topic/data-about
Example 187. Example
The full properties of a cited book can be maintained conveniently in the prolog:
<topic id="questions">
<title>Questions and answers</title>
<prolog>
<data-about href="urn:isbn:0156983508" scope="external">
<data name="title">The World Doesn't End</data>
<data name="author">
<data name="firstname">Charles</data>
<data name="lastname">Simic</data>
</data>
<data name="published" datatype="year">1989</data>
...
</data-about>
...
</prolog>
<body>
...
<lq href="urn:isbn:0156983508">In a forest of question marks ...
</lq>
...
</body>
</topic>
Attributes
Name
Description
Data Type
Default Value
Required?
href
Provides a reference to a resource. See The href attribute for detailed information on supported values and processing implications.
CDATA
#IMPLIED
No
format
The format attribute identifies the format of the resource being referenced. See The format attribute for details on supported values.
CDATA
#IMPLIED
No
type
Describes the target of a reference. See The type attribute for detailed information on supported values and processing implications.
CDATA
#IMPLIED
No
scope
The scope attribute identifies the closeness of the relationship between the current document and the target resource. See The scope attribute for more information on values.
(local | peer | external | -dita-use-​conref-​target)
#IMPLIED
No
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, outputclass
Common attributes described in Other common DITA attributes