| Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédente |
| 3_composition:annexes:bibliographie:construire_une_bibliographie [2021/10/18 12:03] – Fin de la fusion/traduction. yannick.tanguy | 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 |
|---|
| ====== Comment générer une bibliographie? ====== | ====== Comment générer une bibliographie? ====== |
| |
| Il existe ici deux possibilités pour placer une bibliographie dans un document : | Il existe ici deux possibilités pour placer une bibliographie dans un document : |
| * soit en la saisissant directement dans le 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''. | * 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''. |
| |
| 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''. | 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{document} | \begin{document} |
| |
| Les livres~\cite{Lamport} et~\cite{Companion} sont deux bons bouquins sur \LaTeX. | Les livres~\cite{Lamport} et~\cite{Companion} sont deux bons bouquins sur \LaTeX. |
| |
| \begin{thebibliography}{MMM99} | \begin{thebibliography}{MMM99} |
| |
| \bibitem[Lam99]{Lamport} | \bibitem[Lam99]{Lamport} |
| L. Lamport, | L. Lamport, |
| \textit{\LaTeX: A Document Preparation System}, | \textit{\LaTeX: A Document Preparation System}, |
| Addison-Wesley, 1994. | Addison-Wesley, 1994. |
| |
| \bibitem[GMS94]{Companion} | \bibitem[GMS94]{Companion} |
| M. Goossens, F. Mittelbach et A. Samarin, | M. Goossens, F. Mittelbach et A. Samarin, |
| \textit{The \LaTeX{} Companion}, | \textit{The \LaTeX{} Companion}, |
| Addison-Wesley, 1994. | Addison-Wesley, 1994. |
| |
| ===== Avec le programme BibTeX ===== | ===== Avec le programme BibTeX ===== |
| |
| 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. | 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. |
| |
| ==== Le fichier des références bibliographiques ==== | ==== Le fichier des références bibliographiques ==== |
| |
| 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 : | 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 : |
| |
| <file bibtex mabiblio.bib> | <file bibtex mabiblio.bib> |
| @book{Lamport, | @book{Lamport, |
| title = "\LaTeX: A Document Preparation | title = "\LaTeX: A Document Preparation |
| System", | System", |
| author = "Lamport, Leslie", | author = "Lamport, Leslie", |
| @book{Companion, | @book{Companion, |
| title = "\LaTeX{} Companion", | title = "\LaTeX{} Companion", |
| author = "Goossens, Michel and Mittelbach, | author = "Goossens, Michel and Mittelbach, |
| Frank and Samarin, Alexander", | Frank and Samarin, Alexander", |
| publisher = "Addison-Wesley", | publisher = "Addison-Wesley", |
| </file> | </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. | 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 ==== | ==== 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 ''.bst'', les plus courants étant ''abbrv.bst'', ''alpha.bst'', ''apalike.bst'', ''plain.bst'' et ''unsrt.bst'' (qui existent aussi en version francisée : ''alpha-fr.bst'', ''plain-fr.bst'', etc.). | 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/changer_le_style_de_la_bibliographie|Comment changer le style de la bibliographie ?]] ». D'autres sont discutés en question « [[3_composition/annexes/bibliographie/choisir_un_style_de_bibliographie|Comment choisir un style de bibliographie?]] ». | 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 ==== | ==== Les commandes à placer dans le document principal ==== |
| </code> | </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''). | 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''). |
| |
| ==== La chaîne de compilation et d'utilisation de BibTeX ==== | ==== La chaîne de compilation et d'utilisation de BibTeX ==== |
| === Première compilation === | === Première compilation === |
| |
| 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'' : | 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'' : |
| * la commande ''\bibliographystyle'' place une note indiquant le style de la bibliographie ; | * la commande ''\bibliographystyle'' place une note indiquant le style de la bibliographie ; |
| * chaque commande ''\cite'' place une note indiquant quelle référence bibliographique est appelée ; | * chaque commande ''\cite'' place une note indiquant quelle référence bibliographique est appelée ; |
| * la commande ''\bibliography'' écrit une note indiquant quel est le fichier ''bib'' qui doit être utilisé. | * la commande ''\bibliography'' écrit une note indiquant quel est le fichier « ''.bib'' » qui doit être utilisé. |
| |
| 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. | 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. |
| |
| === Utilisation de BibTeX === | === Utilisation de BibTeX === |
| </code> | </code> |
| |
| 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''. | 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''. |
| |
| ''BibTeX'' scanne alors le fichier auxiliaire : | ''BibTeX'' scanne alors le fichier auxiliaire : |
| * il cherche le style de bibliographie qu'il doit utiliser et « compile » ce style ; | * il cherche le style de bibliographie qu'il doit utiliser et « compile » ce style ; |
| * il note les références souhaitées ; | * il note les références souhaitées ; |
| * 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 ; | * 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 ; |
| * il trie les entrées qui ont été citées (si le style de bibliographie spécifie qu'elles doivent être triées) ; | * il trie les entrées qui ont été citées (si le style de bibliographie spécifie qu'elles doivent être triées) ; |
| * il constitue un fichier ''bbl'' contenant le résultat de ces travaux, à savoir un environnement ''thebibliography'' et la liste des ''\bibitem'' demandés. | * il constitue un fichier « ''.bbl'' » contenant le résultat de ces travaux, à savoir un environnement ''thebibliography'' et la liste des ''\bibitem'' demandés. |
| |
| === Deuxième compilation === | === 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''. | 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. | 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 === | === Troisième compilation === |
