11.5. Équations

Equation = ( ( Title, TitleAbbrev? )?,
             ( InformalEquation |
               ( Alt?, (Graphic+ | MediaObject+ ))
             )
           )

InformalEquation = ( Alt?, ( Graphic+ | MediaObject+ ) )

Éléments : Equation, Title, TitleAbbrev, InformalEquation, Alt, Graphic, MediaObject.

Les éléments Equation et InformalEquation permettent de définir respectivement une équation et une équation sans titre. On notera qu'un équation avec titre ne contient pas obligatoirement un titre, contrairement aux autres objets formels qui, eux, contiennent obligatoirement un titre.

Il est préférable, lorsque vous utilisez un élément Equation, de toujours donner un titre. Si vous ne voulez pas donner de titre à une équation, utilisez plutôt l'élément InformalEquation. Une future version de DocBook rendra obligatoire l'utilisation d'un titre dans l'élément Equation.

L'élément Equation est constitué :

• d'un titre (Title) et titre abrégé (TitleAbbrev), facultatifs,

• d'une équation sans titre (InformalEquation), ou directement du contenu d'un élément InformalEquation.

Un élément InformalEquation est constitué :

• d'un texte de remplacement (Alt), facultatif,

• d'un graphique (Graphic) ou d'un objet multimédia (MediaObject).

Le graphique ou l'objet multimédia contiendra l'équation elle-même, et le texte de remplacement contiendra une représentation textuelle de l'équation, pour les cas où l'équation elle-même ne peut pas être affichée.

<equation>
  <title>Un titre est-il vraiment nécessaire&nbsp;?</title>
  <alt>e = mc^2</alt>
  <mediaobject>
    <imageobject>
      <imagedata fileref="../figures/emc2.eps" format="eps">
    </imageobject>
    <imageobject>
      <imagedata fileref="../figures/emc2.gif" format="gif">
    </imageobject>
  </mediaobject>
</equation>