184.108.40.206 Concept topic
Concept topics are specialized from topic. They include the standard topic elements, including the short description, prolog, a body, and related links.
The purpose of the concept information type
Concepts provide background that helps readers understand essential information about a product, a task, a process, or any other conceptual or descriptive information. A concept might be an extended definition of a major abstraction such as a process or function. Conceptual information might explain the nature and components of a product and describe how it fits into a category of products. Conceptual information helps readers to map their knowledge and understanding to the tasks they need to perform and to provide other essential information about a product, process, or system.
The structure of the concept topic
The concept topic is
specialized from the base topic information type. The top-level element for a
DITA concept topic is the
<concept> element. Every
concept topic contains the standard topic elements, including title, short
descriptions or abstract, prolog, a body, and related links.
<conbody> element holds the main body-level elements of
the concept topic. Like the
<body> element of a base topic, the
allows paragraphs, lists, tables, figures and other general elements. It also
provides two key elements that allow authors to subdivide the topic into parts,
with or without titles. These subdivisions are called sections and examples.
<conbody> also allows
facilitate grouping elements in the
<conbody> provides for an
unlimited number of subdivisions in the form of sections and examples. However, once
an author decides to incorporate a section or example in the
<conbody>, only additional sections or examples are
allowed. Sections and examples can not nest, meaning
that only one level of subdivision is permitted in the concept topic.
Concept body primary subdivisions
- Represents an organizational division in a concept topic. Sections organize subsets of information within a larger topic. You can only include a simple list of peer sections in a topic; sections cannot be nested. A section can have an optional title.
- Provides examples that illustrate or support the current topic.
<example>element has the same content model as
Following is an example of a simple concept topic. Note that once an example is used, it can be followed only by another example or by a section.
<concept id="concept"> <title>Bird Songs</title> <shortdesc>Bird songs are complex vocalizations used to attract mates or defend territories. <conbody> <p>Bird songs vary widely among species, from simple songs that are genetically imprinted to complex songs that are learned over a lifetime.</p> <example> <p>Flycatchers know their songs from birth:</p> <ul> <li>Flycatcher songs are simple sequences of notes.</li> <li>Flycatcher songs never vary but are unique to each member of the Flycatcher family.</li> </ul> </example> </conbody> </concept>