refbodydiv

Darwin Information Typing Architecture (DITA) Version 1.3 Part 2: Technical Content Edition

version
1.3
author
OASIS DITA Technical Committee

The refbodydiv element is similar to the bodydiv element in that it provides an informal container for content that might be grouped within a reference. Reference topics place many restrictions on their content compared to generic topics; the refbodydiv element maintains these restrictions by only allowing elements that are already available within the body of a reference. There are no additional semantics attached to the refbodydiv element; it is purely a grouping element provided to help organize content.

The refbodydiv element can nest itself, which means that it can be specialized to create structured information within a specialized reference topic. Another common use case for the refbodydiv element is to group a sequence of related elements for reuse, so that another topic can reference the entire set with a single conref attribute.

Inheritance

- topic/bodydiv reference/refbodydiv

Example

<reference id="sample-refbodydiv" xml:lang="en">
 <title>Sample for refbody</title>
 <shortdesc>This shows how refbodydiv might be used.</shortdesc>
 <refbody>
  <refbodydiv id="widget1">
   <section>This is one part of the sample</section>
   <refsyn>Syntax for this part</refsyn>
  </refbodydiv> 
  <refbodydiv id="widget2">
    <section>This is another part of the sample</section>
    <refsyn>Syntax for this part</refsyn>
  </refbodydiv>
 </refbody>
</reference>

Attributes

The following attributes are available on this element: Universal attribute group and outputclass.