Faire référence à d’autres parties du PDF
label et ref, puis cleveref pour des noms automatiques.
Faire référence à d’autres parties du PDF
Taper « voir la figure 3 » à la main est une promesse que vous ne pouvez pas tenir. Ajoutez une figure plus tôt dans l’article, et chaque numéro saisi à la main après elle devient faux. LaTeX règle le problème avec un mécanisme en deux parties : \label attache un nom de votre choix à un élément numéroté, et \ref affiche le numéro que cet élément a fini par recevoir. Vous faites référence à des noms, et le compilateur veille à ce que les numéros restent exacts.
Label et ref
\section{Methods}\label{sec:methods}\begin{equation}\label{eq:main} ... \end{equation}\begin{figure} ... \caption{...}\label{fig:pipeline}\end{figure}
See Section~\ref{sec:methods}, Eq.~\eqref{eq:main}, and Figure~\ref{fig:pipeline}.\label{sec:methods} enregistre le dernier numéro attribué, ici celui de la section, sous la clé sec:methods. Plus loin, \ref{sec:methods} affiche ce numéro, et \eqref est la variante d’amsmath qui ajoute la convention des parenthèses pour les équations : elle affiche « (1) » plutôt que « 1 ».
Deux détails de cet exemple comptent beaucoup. Premièrement, dans une figure, le label doit venir après \caption, car c’est la légende qui incrémente le compteur de figures ; un label placé avant récupère silencieusement le numéro de la section en cours. Deuxièmement, le ~ dans Figure~\ref{...} est une espace insécable, qui garde le mot et son numéro sur la même ligne au lieu de laisser « Figure » terminer une ligne et « 3 » commencer la suivante.
Les préfixes sec:, fig: et eq: relèvent de la pure convention. LaTeX ne les exige pas, mais ils rendent les clés lisibles et permettent à l’autocomplétion de l’éditeur de regrouper vos labels par type.
Pourquoi vous voyez « ?? »
Lors de la première compilation après l’ajout d’un label, \ref affiche ??. Les numéros sont résolus grâce au fichier .aux écrit lors de l’exécution précédente ; un nouveau label demande donc une compilation de plus pour apparaître. Pourquoi on compile plusieurs fois explique le mécanisme. Un ?? qui survit à deux compilations consécutives signifie presque toujours que la clé de \ref ne correspond pas à celle de \label.
cleveref écrit le mot à votre place
Avec cleveref (à charger après hyperref) :
\usepackage{cleveref}\cref{fig:pipeline}\cref{fig:pipeline} affiche « Figure 3 », nom du type compris, et s’adapte si le label désigne finalement un tableau ou une équation. \Cref met une majuscule en début de phrase, et \cref{eq:a,eq:b,eq:c} condense une liste en plage. Notez l’ordre de chargement : cleveref est l’un des rares packages à devoir venir après hyperref, à l’inverse de la règle habituelle. Adoptez-le tôt. Intégrer \cref après coup dans un article rempli de « Figure~\ref » écrits à la main est fastidieux.