12.9 \newtheorem

Synopsis :

\newtheorem{nom}{titre}
\newtheorem{nom}{titre}[numéroté_au_sein_de]
\newtheorem{nom}[numéroté_comme]{titre}

Définit un nouvel environnement simili-théorème. Vous pouvez spécifier l’un seul de numéroté_au_sein_de ou numéroté_comme, ou ni l’un ni l’autre, mais non les deux à la fois.

La première forme, \newtheorem{nom}{titre}, crée un environnement qui sera étiqueté avec titre ; voir le premier exemple ci-dessous.

La seconde forme, \newtheorem{nom}{titre}[numéroté_au_sein_de], crée un environnement dont le compteur est subordonné au compteur déjà existant numéroté_au_sein_de, c.-à-d. qui est réinitialisé à chaque réinitialisation de numéroté_au_sein_de. Voir le second exemple ci-dessous.

La troisième forme \newtheorem{nom}[numéroté_comme]{titre}, avec l’argument optionnel entre les deux arguments obligatoires, crée un environnement dont le compteur partage le compteur déjà défini numéroté_comme. Voir le troisième exemple.

Cette déclaration est globale. Elle est fragile (voir \protect).

Arguments :

nom

Le nom de l’environnement. C’est une chaîne de lettres. Il ne doit pas commencer avec une controblique (‘\’). Il ne doit pas être le nom d’un environnement déjà existant ; en fait le nom de commande \nom ne doit pas être déjà défini de quelque façon que ce soit.

titre

Le texte imprimé au début de l’environnement, avant le numéro. Par exemple, ‘Théorème’.

numéroté_au_sein_de

Optionnel ; le nom d’un compteur déjà défini, d’ordinaire une unité sectionnelle telle que chapter ou section. Lorsque le compteur numéroté_au_sein_de est réinitialisé, alors le compteur de l’environnement nom l’est aussi.

Si cet argument optionnel est omis alors la commande \thenom est définie comme \arabic{nom}.

numéroté_comme

Optionnel ; le nom d’un environnement simili-théorème déjà défini. Le nouvel environnement se numérote en séquence avec numéroté_comme.

En l’absence des arguments optionnels les environnements sont numérotés en séquence. L’exemple suivant a une déclaration dans le préambule qui résulte en ‘Définition 1’ et ‘Définition 2’ en sortie.

\newtheorem{defn}{Définition}
\begin{document}
\section{...}
\begin{defn}
  Première déf.
\end{defn}

\section{...}
\begin{defn}
  Seconde déf.
\end{defn}

L’exemple suivant reprend le même corps de document que l’exemple précédent. Mais ici l’argument optionnel numéroté_au_sein_de de \newtheorem est spécifié comme section, aussi la sortie est du genre de ‘Définition 1.1’ et ‘Définition 2.1’.

\newtheorem{defn}{Definition}[section]
\begin{document}
\section{...}
\begin{defn}
  Première déf.
\end{defn}

\section{...}
\begin{defn}
  Seconde déf.
\end{defn}

Dans l’exemple suivant il y a deux déclarations dans le préambule, la seconde desquelles appelle le nouvel environnement thm pour utiliser le même compteur que defn. Cela donne ‘Définition 1.1’, suivi de ‘Théorème 2.1’ et ‘Définition 2.2’.

\newtheorem{defn}{Définition}[section]
\newtheorem{thm}[defn]{Théorème}
\begin{document}
\section{...}
\begin{defn}
  Première déf.
\end{defn}

\section{...}
\begin{thm}
  Premier théorème
\end{thm}

\begin{defn}
  Seconde déf.
\end{defn}
\section{...}