7 Des renvois

Une des raisons pour numéroter des choses telles que les figures ou les équations est d’indiquer au lecteur une référence vers elles, comme dans « Voir la figure 3 pour plus de détails. »

Souvent on désire écrire quelque chose du genre de ‘Voir théorème~31’. Mais Inclure manuellement le numéro est une mauvaise pratique. Au lieu de cela, il vaut mieux écrire une étiquette du genre \label{eq:ThmGreens} puis lui faire référence avec Voir l'équation~\ref{eq:ThmGreens}. LaTeX se charge de déterminer automatiquement le numéro, de le produire en sortie, et de le changer par la suite si besoin est.

Cela apparaîtra avec le théorème~\ref{th:ThmGreens}. % référence déclarée en aval
...
\begin{theorem} \label{th:ThmGreens}
  ...
\end{theorem}
...
Voir le théorème~\ref{th:ThmGreens} page~\pageref{th:ThmGreens}.

LaTeX garde trace de l’information de renvoi dans un fichier avec le même nom de base que le fichier contenant le \label{...} mais avec une extension .aux. Ainsi si \label est dans calcul.tex alors cette information est dans calcul.aux. LaTeX met cette information dans ce fichier à chaque fois qu’il rencontre un \label.

L’effet secondaire le plus courant du paragraphe précédent se produit lorsque votre document a une référence déclarée en aval, c.-à-d. un \ref qui apparaît avant le \label associé. Si c’est la première fois que vous compilez le document alors vous obtiendrez un message LaTeX Warning: Label(s) may have changed. Rerun to get cross references right. et dans la sortie la référence apparaîtra comme deux points d’interrogation ‘??’ en caractères gras. Ou, si vous modifiez le document de telle façon que les références changent alors vous obtiendrez le même avertissement et la sortie contiendra l’information de référence de la fois précédente. La solution dans les deux cas est juste de recompiler le document encore une fois.

Le paquetage cleveref élargit les possibilités de faire des renvois de LaTeX. Vous pouvez faire en sorte que si vous saisissez \begin{thm}\label{th:Nerode}...\end{thm} alors \cref{th:Nerode} produit en sortie ‘théorème 3.21’, sans que vous ayez à saisir le mot « théorème ».