equation

equation — A displayed mathematical equation.

Synopsis

equation ::=

Attributes

Common attributes and common linking attributes.

Additional attributes:

  • floatstyle
  • label
  • pgwide (enumeration)
    • “0”
    • “1”

Additional Constraints

  • example must not occur among the children or descendants of equation
  • figure must not occur among the children or descendants of equation
  • table must not occur among the children or descendants of equation
  • equation must not occur among the children or descendants of equation
  • If this element is the root element, it must have a version attribute.

Description

An equation is a formal mathematical equation (with an optional rather than a required title).

If the MathML Module is used, equation can also contain the mml:math element.

Processing expectations

Formatted as a displayed block. For an inline equation, use inlineequation.

Processing systems that number equations or build a table of equations at the beginning of a document may have difficulty correctly formatting documents that contain both equations with titles and equations without titles. You are advised to use informalequation for equations without titles.

Attributes

Common attributes and common linking attributes.

floatstyle

Specifies style information to be used when rendering the float

label

Specifies an identifying string for presentation purposes

pgwide

Indicates if the element is rendered across the column or the page

Enumerated values:
“0”

The element should be rendered in the current text flow (with the flow column width).

“1”

The element should be rendered across the full text page.

Children

The following elements occur in equation: alt, caption (db.caption), info (db.titleforbidden.info), info (db.titleonly.info), mathphrase, mediaobject, mml:*, title, titleabbrev.

Examples

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example equation</title>

<equation xml:id="eq.fermat">
<title>Fermat's Last Theorem</title>
  <alt>x^n + y^n ≠ z^n ∀ n ≠ 2</alt>
  <mediaobject>
    <imageobject condition="print">
      <imagedata fileref="figs/print/db5d_refeqn01.pdf"/>
    </imageobject>
    <imageobject condition="web">
      <imagedata fileref="figs/web/db5d_refeqn01.png"/>
    </imageobject>
  </mediaobject>
</equation>

</article>
Equation 1. Fermat's Last Theorem

Alternatively, for relatively simple equations such as Fermat's Last Theorem, mathphrase is often sufficient:

<article xmlns='http://docbook.org/ns/docbook'>
<title>Example equation</title>

<equation xml:id="eq.fermat.mathphrase">
<title>Fermat's Last Theorem</title>
  <alt>x^n + y^n ≠ z^n ∀ n ≠ 2</alt>
  <mathphrase>x<superscript>n</superscript>
+ y<superscript>n</superscript>
≠ z<superscript>n</superscript>
∀ n ≠ 2</mathphrase>
</equation>

</article>
xn + yn ≠ zn ∀ n ≠ 2
Equation 2. Fermat's Last Theorem
Last revised by Norman Walsh on (git hash: 4a070f84c9fc7bc85cf9f71d71fa54f4db18f973 a835fdf61c7f87ce1038e2869080d80ea67d3696)