8.24.1 \bibitem

Synopsis :

\bibitem{clef_de_cite}

ou :

\bibitem[étiquette]{clef_de_cite}

La commande \bibitem génère un article étiqueté par défaut par un numéro généré en utilisant le compteur enumi. L’argument clef_de_cite est une clef de référence bibliographique consistant en une chaîne quelconque de lettres, chiffres, et signes de ponctuation (hormis la virgule).

Voir thebibliography, pour un exemple.

L’argument optionnel étiquette, lorsqu’il est présent, sert d’étiquette et le compteur enumi n’est pas incrémenté. Dans l’exemple suivant :

\begin{thebibliography}
\bibitem[Lamport 1993]{latexdps}
  Leslie Lamport.
  \textit{\LaTeX{}: a document preparation system}.
  Addison-Wesley, Reading, Massachusetts, 1993.
\bibitem{texbook}
  Donald Ervin Knuth.
  \textit{Le Texbook : Composition informatique}.
  Vuibert, 1er août 2017.
\end{thebibliography}

le premier article est formaté comme ‘[Lamport 1993] Leslie ...’ (la quantité d’espace horizontal que LaTeX laisse pour l’étiquette dépend de l’argument étiquette-la-plus-large de l’environnement thebibliography ; voir thebibliography). De même, ... s'appuyant sur \cite{latexdps} produit ‘... s'appuyant sur [Lamport 1994]’.

Si vous mélangez des articles \bibitem avec et sans étiquette, alors LaTeX numérote ces derniers séquentiellement. Dans l’exemple ci-dessus l’article texbook apparaît comme ‘[1] Donald ...’, bien que ce soit le deuxième article.

Si vous utilisez la même clef_de_cite deux fois, alors vous obtenez ‘LaTeX Warning: There were multiply-defined labels’.

En coulisse, LaTeX se souvient de l’information clef_de_cite et étiquette parce que \bibitem écrit dans le fichier auxiliaire jobname.aux (voir Jobname). Par exemple dans l’exemple ci-dessus ce fichier contient \bibcite{latexdps}{Lamport, 1993} et \bibcite{texbook}{1}. Le fichier .aux est lu par la commande \begin{document} et alors l’information devient disponible pour les commandes \cite. Ceci explique qu’il est nécessaire d’exécuter LaTeX deux fois pour que les références soient résolues : une pour l’écrire, et une pour le relire.

À cause de cet algorithme en deux passes, quand vous ajourez un \bibitem ou changez sa clef_de_cite vous pouvez obtenir ‘LaTeX Warning: Label(s) may have changed. Rerun to get cross-references right’. La solution est de recompiler.