equation-number

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

Document
Darwin Information Typing Architecture (DITA) Version 1.3 Part 2: Technical Content Edition
Version
1.3
Author
OASIS DITA Technical Committee

Use the equation-number element to indicate that a block equation is numbered and, optionally, to specify the number to use for the block equation.

When the equation-number element has empty or whitespace-only content, the equation number SHOULD be generated. When the equation-number element has non-whitespace-only content the content SHOULD be used as the equation number. For explicit numbers the content of the element SHOULD be the number value without any surrounding punctuation, for example, "3.2a" rather than "(3.2a)". Processors SHOULD add punctuation or decoration to the number as appropriate.

In normal usage a block equation will have at most one number. However, equation-number can occur multiple times within equation-block, for example, to allow numbers with different (and exclusive) conditional properties.

The details of equation numbering and number presentation are processor-specific. However, common practice is to present the equation number to the right of the equation, centered vertically within the vertical extent of the block equation.

Content models

See appendix for information about this element in OASIS document type shells.

Inheritance

+ topic/ph equation-d/equation-number

Example

An equation with a generated number:
<p>A block equation using an image:</p>
<equation-block id="eq-001">
  <equation-number/>
  <image keyref="equation-image-01">
    <alt>a squared plus b squared.</alt>
  </image>
</equation-block>
An equation with an explicit number:
<p>A block equation using an image:</p>
<equation-block id="eq-3.2a">
  <equation-number>3.2a</equation-number>
  <image keyref="equation-image-01">
    <alt>a squared plus b squared.</alt>
  </image>
</equation-block>

Attributes

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