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
  • note must not occur among the children or descendants of equation

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, 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: c3457cab689d8fd89ba4252de204cf9a14e40acd 6a501344525f32f9834f0e4a5c3c3f8131803fa4 47fe34b28bad7941a61b9c1c17d47f6eed36cd04)