<concept>
The <concept>
element is the top-level
element for a topic that answers the question what is?
Concepts
provide background information that users must know before they can
successfully work with a product or interface. Often, a concept is
an extended definition of a major abstraction such as a process or
function. It might also have an example or a graphic, but generally
the structure of a concept is fairly simple.
See appendix for information about this element in OASIS document type shells.
- topic/topic concept/concept
<concept id="concept">
<title>Introduction to Bird Calling</title>
<shortdesc>If you wish to attract more birds to your Acme Bird Feeder,
learn the art of bird calling. Bird calling is an efficient way
to alert more birds to the presence of your bird feeder.</shortdesc>
<conbody>
<p>Bird calling requires learning:</p>
<ul>
<li>Popular and classical bird songs</li>
<li>How to whistle like a bird</li>
</ul>
</conbody>
</concept>
The following attributes are available on this element: Universal attribute group (with a narrowed definition of @id
, given
below), Architectural attribute group, and outputclass.
@id
(REQUIRED)@href
or
@conref
syntax when cross
referencing or reusing content within the topic;
it also enables <topicref>
elements in DITA maps to optionally reference a
specific topic within a DITA document. This attribute is defined
with the XML Data Type ID.