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.
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 name="book" href="urn:isbn:0156983508"> <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>
Doctype | Content model |
---|---|
ditabase, topic, task, reference, concept, glossary, map, bookmap | ( ( data) then ( data or data-about) (any number) ) |
- topic/data-about
Name | Description | Data Type | Default Value | Required? |
---|---|---|---|---|
href | A hyperlink to an external Web page (URL) or other non-DITA resource,
or to another DITA topic in the same file or in another file. The format attribute
identifies the format of the target. Non-DITA targets use standard URL syntax.
DITA topics are targetted as follows:Target elsewhere in the same file: href="#topicid" First topic in different file: href="filename.dita" Specific topic in different file: href="filename.dita#topicid" If the URL contains an ampersand character, the ampersand symbol (&) should be used to indicate that character |
CDATA | #IMPLIED | No |
format | The format attribute identifies the format of the resource being cross referenced. See The format attribute for details on supported values. | CDATA | #IMPLIED | No |
type | Describes the target of a cross-reference. See The type attribute for detailed information on supported values and processing implications. | CDATA | #IMPLIED (Processed as if the target were of type "topic", or inherited from an ancestor) | No |
scope | The scope attribute identifies the closeness of the relationship
between the current document and the target resource.
|
(local | peer | external | -dita-use-conref-target) | #IMPLIED | No |
%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.