5.7.1 \caption

Synopsis :

\caption{texte-légende}

ou

\caption[texte-légende-bref]{texte-légende}

Fabrique une légende pour un environnement flottant, tel que les environnements figure ou table (voir figure ou table).

Dans l’exemple suivant, LaTeX place une légende sous l’espace blanc vertical laissé par l’auteur pour l’inclusion ultérieur d’une image.

\begin{figure}
  \vspace*{1cm}
  \caption{Alonzo Cushing, Battery A, 4th US Artillery.}
  \label{fig:CushingPic}
\end{figure}

La commande \caption crée une étiquette pour la légende texte-légende du genre de ‘Figure 1 – ’ pour un document article ou ‘Figure 1.1 – ’ pour un document book. Le texte est centré s’il est plus court que la largeur du texte, ou composé comme un paragraphe sans retrait s’il prend plus d’une ligne.

En plus de placer le texte-légende dans la sortie, la commande \caption sauvegarde également cette information pour qu’elle soit utilisée dans une liste de figures ou un liste de tableaux (voir Table of contents etc.).

Ci-dessous la commande \caption utilise l’argument optionnel texte-légende-bref, de sorte que le texte plus bref apparaisse dans la liste des tableaux plutôt que la version longue texte-légende.

\begin{table}
  \centering
  \begin{tabular}{|*{3}{c}|}
    \hline
    4  &9  &2 \\
    3  &5  &7 \\ 
    8  &1  &6 \\
    \hline
  \end{tabular}
  \caption[Carré de \textit{Lo Shu}]{%
    Le carré de \textit{Lo Shu}, il est unique parmi les carrés
    d'ordre trois à la rotation ou réflexion près.}
  \label{tab:LoShu}
\end{table}

LaTeX crée une étiquette pour texte-légende du genre de ‘Table 1 – ’ pour un document article ou ‘Table 1.1 – ’ pour un document book.

La légende peut apparaître au sommet d’une figure ou table. Cela se produirait ainsi dans l’exemple précédent en mettant la \caption entre le \centering et le \begin{tabular}.

Les différents environnements flottants sont numérotés séparément, par défaut. Le compteur de l’environnement figure est nommé figure, et de même le compteur de l’environnement table est table.

Le texte qui est mis dans la liste des figures ou des tableaux est un argument mouvant. Si vous obtenez l’erreur LaTeX ‘! Argument of \@caption has an extra }’ alors vous devez précéder d’un \protect toute commande fragile. Voir \protect.

Le paquetage caption a beaucoup d’options pour ajuster l’apparence de la légende, par ex. changer la taille de la fonte, faire que la légende soit un texte en retrait plutôt qu’un paragraphe, ou faire que la légende soit toujours un paragraphe, plutôt qu’un texte centré quand elle est courte.