Différences

Ci-dessous, les différences entre deux révisions de la page.

--- composition:annexes:bibliographie:construire_une_bibliographie [2016/10/20 19:58] – jejust
+++ 3_composition:annexes:bibliographie:construire_une_bibliographie [2022/07/14 10:04] (Version actuelle) – Nom des packages pas en fonte à chasse fixe (pour l'homogénéité) dbitouze
@@ Ligne 1: / Ligne 1: @@
-====== Comment construire une bibliographie ? ======
+====== Comment générer une bibliographie? ======
+Il existe ici deux possibilités pour placer une bibliographie dans un document :
+  * soit en la saisissant directement dans le document ;
+  * soit en créant un fichier contenant les références bibliographiques (un fichier d'extension « ''.bib'' ») qui sera traité par une chaîne de compilation dédiée utilisant ''BibTeX''.
-$\Reponse$  Deux possibilités pour la liste des références :
+Dans les deux cas, la commande ''\cite'' permet de citer une référence de la bibliographie dans le corps document. Toutefois, dans le cas particulier de la chaîne avec ''BibTeX'', cette commande indique qu'il faut afficher la référence souhaitée dans la bibliographie, si elle existe. Toujours dans le cas de la chaîne avec ''BibTeX'', pour inclure une référence dans la bibliographie sans y faire référence explicitement dans le corps du document, il faut utiliser la commande ''\nocite''.
-\begin{itemize}
-\item soit en la mettant directement dans le document ;
-\item soit en créant un ''fichier.bib'' contenant les références
-bibliographiques et traité par \BibTeX{}.
-\end{itemize}
-Pour citer une référence dans le document, on utilise la commande
+===== Avec les commandes de base =====
-''cite'' (voir~\vref{cite}). Pour inclure une référence dans la
-bibliographie sans y faire référence explicitement, il faut utiliser
-la commande ''nocite'' (voir~\vref{nocite}).
+La méthode « directe » consiste à utiliser l'environnement ''thebibliography''. C'est un environnement semblable à ''itemize'', chaque entrée étant précédée d'un ''\bibitem''. En voici un exemple :
-$\Reponse$  La méthode \og~directe~\fg{} consiste à utiliser
+<file latex exemple.tex>
-l'environnement ''thebibliography''. C'est un environnement
-semblable à ''itemize'', chaque entrée étant précédée d'un
-''bibitem''. Voir l'exemple~\vref{bibsimple}.
-Exemple de bibliographie simple\label{bibsimple}
-<code latex>
 \documentclass{article}
 \usepackage[T1]{fontenc}
-\usepackage[latin1]{inputenc}
+\usepackage[french]{babel}
-\usepackage[francais]{babel}
 \begin{document}
-Les livres~\cite{Lamport} et~\cite{Companion} sont
+Les livres~\cite{Lamport} et~\cite{Companion} sont deux bons bouquins sur \LaTeX.
-deux bons bouquins sur <latex>\LaTeX</latex>.
 \begin{thebibliography}{MMM99}
 \bibitem[Lam99]{Lamport}
 L. Lamport,
-\textit{<latex>\LaTeX</latex>{}: A Document Preparation System},
+\textit{\LaTeX: A Document Preparation System},
 Addison-Wesley, 1994.
 \bibitem[GMS94]{Companion}
 M. Goossens, F. Mittelbach et A. Samarin,
-\textit{The <latex>\LaTeX</latex>{} Companion},
+\textit{The \LaTeX{} Companion},
 Addison-Wesley, 1994.
 \end{thebibliography}
 \end{document}
-</code>
+</file>
+La commande ''\bibitem'' a, en général, un argument obligatoire et un argument optionnel. L'argument obligatoire est la //clef interne//, c'est-à-dire le « nom » à utiliser dans le document pour faire référence à cette entrée. L'argument optionnel est la clé que <latex>\LaTeX</latex> utilisera dans le document. Ce qui suit le ''\bibitem'' est le contenu de la référence bibliographique. C'est du code <latex>\LaTeX</latex> normal.
-La commande ''bibitem'' a, en général, un argument obligatoire et un
+L'environnement ''thebibliography'' a un argument obligatoire, qui indique la taille du retrait à prévoir dans la liste. L'argument devra donc être, pour des raisons esthétiques, la plus longue clé apparaissant dans la bibliographie.
-argument optionnel. L'argument obligatoire est la \emph{clef interne},
-c'est-à-dire le \og~nom~\fg{} à utiliser dans le document pour faire
-référence à cette entrée. L'argument optionnel est la clef que <latex>\LaTeX</latex>
-utilisera dans le document. Ce qui suit le ''bibitem'' est le
-contenu de la référence bibliographique. C'est du code <latex>\LaTeX</latex> normal.
-L'environnement ''thebibliography'' a un argument obligatoire, qui
+===== Avec le programme BibTeX =====
-indique la taille du retrait à prévoir dans la liste. L'argument
-devra donc être, pour des raisons esthétiques, la plus longue clef
-apparaissant dans la bibliographie.
+La méthode précédente a l'inconvénient de ne pas être automatique : il faut recréer la liste des références pour chaque document. [[ctanpkg>bibtex|BibTeX]] permet de créer une fois pour toutes une liste de références bibliographiques et de lister, automatiquement et de manière configurable, les références utilisées dans le document.
-$\Reponse$  La méthode précédente a l'inconvénient de ne pas être
+==== Le fichier des références bibliographiques ====
-automatique : il faut recréer la liste des références pour chaque
-document. \BibTeX permet de créer une fois pour toutes une liste de
-références bibliographiques et de lister, automatiquement et de manière
-configurable, les références utilisées dans le document.
-\BibTeX est disponible sur https://www.ctan.org/{biblio/bibtex}.
-\BibTeX utilise plusieurs fichiers :
+L'automatisation passe par la constitution d'un fichier (ou de plusieurs fichiers) d'extension « ''.bib'' » contenant les références bibliographiques mises sous une forme cadrée, chaque référence étant composée d'une liste de données sous la forme « ''champ = "valeur"'' » séparées par des virgules. Pour notre exemple de début de page, ce fichier aurait la forme suivante :
-\begin{itemize}
-\item les références bibliographiques elles-mêmes, contenues dans des
-  fichiers d'extension ''.bib''. Le format de ces fichiers est
-  décrit au paragraphe~\vref{bib} ;
-\item un fichier, d'extension ''.bst'', définissant la mise en
-  page de la bibliographie. Il existe de nombreux fichiers
-  ''.bst'', les plus courants étant ''abbrv.bst'',
-  ''alpha.bst'', ''apalike.bst'', ''plain.bst'' et
-  ''unsrt.bst'' (qui existent aussi en version
-  \og~francisée~\fg{} : ''alpha-fr.bst'', ''plain-fr.bst'',
-  etc.). Leurs principales caractéristiques sont données au
-  paragraphe~\vref{bst}.
-\end{itemize}
-Pour inclure une bibliographie dans un document, on doit donc définir
+<file bibtex mabiblio.bib>
-le style voulu et le(s) fichier(s) contenant les références
+@book{Lamport,
-bibliographiques. Cela se fait avec les commandes
+  title     = "\LaTeX: A Document Preparation
-''bibliographystyle'' et ''bibliography''. Par exemple :
+              System",
+  author    = "Lamport, Leslie",
+  publisher = "Addison-Wesley",
+  year      = 1994
+}
+@book{Companion,
+  title     = "\LaTeX{} Companion",
+  author    = "Goossens, Michel and Mittelbach,
+              Frank and Samarin, Alexander",
+  publisher = "Addison-Wesley",
+  year      = 1994
+}
+</file>
+La question « [[3_composition/annexes/bibliographie/construire_un_fichier_bibtex|Comment construire un fichier de références bibliographiques (.bib) ?]] » développe ce sujet.
+==== Le fichier de style bibliographique ====
+Afin de pouvoir simplement passer d'un style bibliographique à un autre, ces styles sont contenus dans un fichier d'extension « ''.bst'' ». Il existe de nombreux fichiers de ce type, les plus courants étant ''abbrv'', ''alpha'', ''apalike'', ''plain'' et ''unsrt'' (qui existent aussi en version francisée : ''alpha-fr'', ''plain-fr'', etc.).
+Les principales caractéristiques de ces styles sont présentées à la question « [[3_composition/annexes/bibliographie/choisir_un_style_de_bibliographie|Comment choisir un style de bibliographie ?]] ».
+==== Les commandes à placer dans le document principal ====
+Pour inclure une bibliographie dans un document, il faut utiliser la commande ''\bibliography'' qui indique également à <latex>\LaTeX</latex> qu'il doit placer la bibliographie à l'endroit du texte où se trouve cette commande. Mais, comme vu ci-dessus, on doit donc définir le style voulu et le(s) fichier(s) contenant les références bibliographiques. Cela se fait respectivement avec les commandes ''\bibliographystyle'' et ''\bibliography'' (encore elle). Par exemple :
 <code latex>
 \bibliographystyle{alpha}
-\bibliography{fichier1,fichier2,fichier3}
+\bibliography{mabiblio,bibliofac,commun}
 </code>
+Notez ici l'absence d'espaces après les virgules dans la commande ''\bibliography'' (qui permet dans le cas présent d'aller chercher les données des fichiers ''mabiblio.bib'',''bibliofac.bib'' et ''commun.bib'').
-Noter l'absence d'espaces après les virgules dans la commande
+==== La chaîne de compilation et d'utilisation de BibTeX ====
-''bibliography''.
-À la compilation, plusieurs passes sont nécessaires :
+À la compilation, plusieurs passes sont nécessaires. Les voici toutes détaillés, sachant que certaines pourront être à répéter, par exemple si la bibliographie elle-même contient des références (dans ce cas, les deux premières étapes ci-dessous seront répétées autant de fois que nécessaire).
-  * une première passe de <latex>\LaTeX</latex>, qui permet d'avoir la liste des références citées et qui devront apparaître dans la bibliographie ;
-  * une passe de \BibTeX pour créer la bibliographie ;
-  * une passe de <latex>\LaTeX</latex> qui inclura la bibliographie ;
-  * une dernière passe de <latex>\LaTeX</latex> pour que les références croisées soient correctes.
-Il se peut que la bibliographie elle-même inclue de nouvelles
+=== Première compilation ===
-références. Dans ce cas, les deux premières étapes seront répétées
-autant de fois que nécessaire.
-Lorsqu'il est exécuté, \BibTeX lit le fichier ''.aux'' qui lui est
+Lors de la première compilation de votre document par <latex>\LaTeX</latex>, les différentes commandes ajoutent de l'information au fichier auxiliaire (« ''.aux'' ») à destination de ''BibTeX'' :
-passé en argument, afin de savoir quel style utiliser, quelle base
+  * la commande ''\bibliographystyle'' place une note indiquant le style de la bibliographie ;
-bibliographique et quelles entrées il doit citer. Il crée un fichier
+  * chaque commande ''\cite'' place une note indiquant quelle référence bibliographique est appelée ;
-d'extension~''.bbl'', contenant un environnement
+  * la commande ''\bibliography'' écrit une note indiquant quel est le fichier « ''.bib'' » qui doit être utilisé.
-''thebibliography'' et la liste des ''bibitem'' demandés. Ce
-fichier est inclus dans le document par <latex>\LaTeX</latex>, à l'endroit où est
-appelée la commande ''bibliography''.
+Notez qu'à ce stade, <latex>\LaTeX</latex> ne « résout » aucune des références : à chaque commande ''\cite'', il vous avertit de la présence d'une référence non définie, et lorsque le document sera terminé, il indique la présence générale de références indéfinies.
-$\Reponse$  \label{bib}{\makeatletter
+=== Utilisation de BibTeX ===
-\def\@cite#1#2{{[#1\if@tempswa , #2\fi]}}%
-\makeatother
-Les fichiers ''.bib'' contiennent une liste d'entrées
+Il faut alors appeler ''BibTeX'' et le faire traiter votre fichier auxiliaire :
-bibliographiques, chaque entrée contenant les données lui
-correspondant. Pour~\cite{latex-manual} et \cite{latex-comp}, cités
-dans l'exemple~\vref{bibsimple}, les entrées auraient la forme suivante:
+<code bash>
+bibtex monfichier
+</code>
-<code latex>
+Vous n'avez pas à préciser ici l'extension du fichier (« ''.aux'' »). Si vous indiquez ''bibtex monfichier.aux'', ''BibTeX'' tentera aveuglément de traiter ''monfichier.aux.aux''.
-@book{Lamport,
-  title     = "<latex>\LaTeX</latex>{}: A Document Preparation
-              System",
-  author    = "Lamport, Leslie",
-  publisher = "Addison-Wesley",
-  year      = 1994
-}
-@book{Companion,
+''BibTeX'' scanne alors le fichier auxiliaire :
-  title     = "<latex>\LaTeX</latex>{} Companion",
+  * il cherche le style de bibliographie qu'il doit utiliser et « compile » ce style ;
-  author    = "Goossens, Michel and Mittelbach,
+  * il note les références souhaitées ;
-              Frank and Samarin, Alexander",
+  * il cherche les fichiers bibliographiques dont il a besoin et les parcourt en faisant correspondre les références aux entrées de la bibliographie ;
-  publisher = "Addison-Wesley",
+  * il trie les entrées qui ont été citées (si le style de bibliographie spécifie qu'elles doivent être triées) ;
-  year      = 1994
+  * il constitue un fichier « ''.bbl'' » contenant le résultat de ces travaux, à savoir un environnement ''thebibliography'' et la liste des ''\bibitem'' demandés.
-}
-</code>
+=== Deuxième compilation ===
+Cette deuxième compilation de votre document par <latex>\LaTeX</latex> va permettre d'inclure le contenu du fichier « ''.bbl'' » à l'endroit où se trouve la commande ''\bibliography''.
+Une nouvelle fois, <latex>\LaTeX</latex> vous avertit que chaque référence bibliographique est indéfinie. Cependant, lorsqu'il rencontre chaque commande ''\bibitem'' dans le fichier, il note la définition de ces références.
+=== Troisième compilation ===
+Cette dernière compilation permet à <latex>\LaTeX</latex> de pouvoir faire proprement toutes les références croisées à la bibliographie.
+==== ====
+Si, lors de l'édition, vous modifiez l'une des références ou en ajoutez de nouvelles, vous devez suivre tout le processus de compilation décrit ci-dessus pour que le document se stabilise à nouveau. Ces quatre exécutions obligatoires de <latex>\LaTeX</latex> rendent le traitement d'un document avec une bibliographie plus fastidieux que dans le cas où vous traitez des [[3_composition/texte/renvois/start|références croisées]] ou dans celui où vous insérez une [[3_composition/annexes/tables/generer_une_table_des_matieres|table des matières]]. Cependant, nombre de programmes d'édition de document <latex>\LaTeX</latex> propose des raccourcis pour exécuter la totalité de cette chaîne de compilation.
-La syntaxe précise et le rôle des différentes entrées sont donnés dans toute
+-----
-bonne documentation sur <latex>\LaTeX</latex>.
+//Source:// [[faquk>FAQ-usebibtex|Normal use of BibTeX from LaTeX]]
+{{htmlmetatags>metatag-keywords=(LaTeX,bibliographie,références bibliographique,compiler une bibliographie,fichier bib)
+metatag-og:title=(Comment générer une bibliographie)
+metatag-og:site_name=(FAQ LaTeX francophone)
+}}