Des légendes qui correspondent au numéro

Placez label après caption pour que le numéro soit le bon.

Des légendes qui correspondent au numéro

Les références croisées font partie des choses que LaTeX fait mieux qu’un traitement de texte. Vous ne tapez jamais « Figure 3 » à la main. Vous attachez plutôt une étiquette à la figure et laissez LaTeX mettre le numéro partout où elle est mentionnée, de sorte que les numéros restent justes quels que soient les déplacements, insertions ou suppressions. Le mécanisme comporte une règle qui piège presque tout le monde au moins une fois : l’ordre de \caption et de \label compte.

Pourquoi l’ordre compte

La commande \caption fait deux choses. Elle imprime le texte de la légende sous votre figure ou votre tableau, et elle incrémente le compteur, ce qui fait de ce flottant la Figure 3. La commande \label fait quelque chose de plus bête qu’on ne le croit : elle enregistre le dernier numéro attribué, quel qu’il soit. Elle ne sait pas qu’elle se trouve « dans une figure ». L’étiquette doit donc venir après la légende :

\caption{A neat diagram.}
\label{fig:neat}

Si vous mettez \label avant \caption, la légende n’a pas encore incrémenté le compteur de figures, donc l’étiquette capture le dernier numéro attribué ailleurs, généralement celui de la section courante. Votre texte dit alors « voir la Figure 2.4 » alors que la figure est en réalité la Figure 7. C’est le symptôme classique : des références qui pointent vers des numéros de section au lieu de numéros de figure signalent presque toujours une étiquette placée trop tôt. L’habitude la plus sûre est d’écrire \label sur la ligne qui suit immédiatement \caption, à chaque fois, dans les figures comme dans les tableaux.

Référencer l’étiquette

Dans votre texte, écrivez la référence ainsi :

Figure~\ref{fig:neat}

\ref{fig:neat} se développe en un simple numéro, et c’est à vous de fournir le mot « Figure ». Le ~ entre les deux est une espace insécable, qui empêche LaTeX de terminer une ligne après « Figure » et de commencer la suivante par « 3 ». Des préfixes comme fig:, tab:, sec: et eq: relèvent de la pure convention, LaTeX ne les interprète pas, mais ils gardent vos étiquettes lisibles et évitent qu’une figure et un tableau portent par accident le même nom.

Notez que \pageref{fig:neat} donne le numéro de la page où la figure a atterri, utile dans les longs documents où un flottant peut s’éloigner beaucoup de l’endroit où on le mentionne. Pour un tour complet des commandes de référencement, voir chaque commande expliquée.

Compiler deux fois, et autres pièges

Les références se résolvent d’une exécution du compilateur à l’autre : la première passe écrit la position des étiquettes dans le fichier .aux, et la deuxième les relit. Jusqu’à cette deuxième passe, les références s’impriment sous forme de points d’interrogation en gras, donc ?? dans votre PDF signifie généralement « compilez à nouveau », pas que quelque chose est cassé. La plupart des éditeurs, dont Oleafly, relancent les passes automatiquement. Si ?? survit à des compilations répétées, l’étiquette n’existe pas. Les causes probables sont une faute de frappe dans le nom de l’étiquette, ou une \caption supprimée alors que le \label est resté.

Retour à Flottants et encre