The DITA reference document type uses the reference information type. Reference topics are specialized from the base topic information type. They contain the standard topic elements, including title, short descriptions or abstract, prolog, a body, and related links.
Reference topics that provide data in support of the performance of a task. Reference topics may provide lists and tables that include product specifications, parts lists, constraints on use or performance, and other data that is often “looked up” rather than memorized. A reference topic may also describe regular constituents of a subject or product, such as commands in a programming language. or required tools for a series of maintenance tasks.
Reference topics provide quick access to fact-based information. In technical information, reference topics are used to list product specifications and parameters, provide essential data, and provide detailed information on subjects such as the commands in a programming language. Reference topics may hold any subject matter that has regular content, such as ingredients for food in recipes, bibliographic lists, catalogue items, and so on.
The top-level element for a reference topic is the <reference> element.
The <refbody> element holds the main body-level elements of the reference topic. Reference topics limit the body to tables (both simple and complex), property lists, syntax sections, and generic sections and examples.
All of the elements of <refbody> are optional and may appear in any sequence and number.
The <refbody> provides for an unlimited number of subdivisions in the form of sections, examples, syntax sections, property lists, and tables. However, once an author decides to incorporate a section, example, property list, or syntax section in the <refbody>, only additional sections, examples, property lists, or syntax sections are allowed. Simple and complex tables may appear within sections, examples, and syntax sections. They may not appear within the property list or simple or complex table sections. Sections, examples, syntax sections, table subdivisions, and property lists may not nest, meaning that only one level of subdivision is permitted in the reference topic.
<reference id="boldproperty"> <title>Bold property</title> <shortdesc>(Read-write) Whether to use a bold font for the specified text string.</shortdesc> <refbody> <refsyn> <synph> <var>object</var><delim>.</delim><kwd>Font</kwd><delim>.</delim> <kwd>Bold</kwd><delim> = </delim><var>trueorfalse</var> </synph> </refsyn> <properties> <property> <proptype>Data type</proptype> <propvalue>Boolean</propvalue> </property> <property> <proptype>Legal values</proptype> <propvalue>True (1) or False (0)</propvalue> </property> </properties> </refbody> </reference>
<reference id="oiltypes"> <title>Oil Types</title> <shortdesc>The tables provide the recommended oil types.</shortdesc> <refbody> <properties> <property> <prophead> <proptypehd>Oil type</proptypehd> <propvaluehd>Oil brand</propvaluehd> <propdeschd>Appropriate use</propdeschd> </prophead> <property> <proptype>Primary oil</proptype> <propvalue>A1X<propvalue> <propdesc>Appropriate for one-cylinder engines</propdesc> </property> <property> <proptype>Secondary oil</proptype> <propvalue>B2Z</propvalue> <propdesc>Appropriate for two-cylinder engines</propdesc> </property> </properties> </refbody> </reference>
The following DITA modules are provided for the reference topic.
Return to main page.
OASIS DITA Version 1.2 -- OASIS Standard, 1 December 2010
Copyright © OASIS Open 2005, 2010. All Rights Reserved.