Partie 2 : Bibliographie

Portrait de furet
Soumis par furet le dim, 09/11/2008 - 17:24

Il y a 2 manières pour créer une bibliographie avec latex :

  • La manière dégeulasse avec thebibliography
  • La manière propre avec BibTeX

Je vais détailler les 2 manières de faire, la première peut vous servir si vous moins de 3 références bibliographiques, si ce n'est pas votre cas, tournez vous vers BibTeX qui est bien plus puissant.

thebibliography

Faire un bibliographie avec thebibliography est assez simple. Il suffit de d'abord de construire sa bibliographie avec l'environnement thebibliography. Chaque référence doit être insérée à l'aide de la commande \bibitem{ref} avec entre acolades ref le nom de votre référence. Pour citer vos références il faut utiliser la commande \cite{ref} où ref est évidemment la référence à citer.

Voici un exemple concret :

\begin{document}
 
Un peu de blabla qui sert à rien…
 
Ce livre\cite{ol9} est un bon bouquin à mettre sur sa table de chevet.
 
\begin{thebibliography}{99}
\bibitem{ol1} "OpenLDAP, Main Page" . Internet : http://www.openldap.org . Mar. 28, 2008 [May. 1, 2008]
\bibitem{ol2} "OpenLDAP Software 2.4 Administrator's Guide: Introduction to OpenLDAP Directory Services" . Internet: http://www.openldap.org/doc/admin24/intro.html#Wha\
t\%20is\%20LDAP . [May. 1, 2008]
\bibitem{ol3}  "OpenLDAP Software 2.4 Administrator's Guide: A Quick-Start guide" . Internet: http://www.openldap.org/doc/admin24/quickstart.html. [May. 1, 2008]
\bibitem{ol4} "OpenLDAP Software 2.4 Administrator's Guide: The slapd Configuration File". Internet: http://www.openldap.org/doc/admin24/slapdconfig.html. [May. 1, 200\
8]
\bibitem{ol5} "OpenLDAP, Software, Man Pages: ldif" . Internet: http://www.openldap.org/software/man.cgi . [May. 12, 2008]
\bibitem{ol6} J.H.M. Dassen (Ray), Chuck Stickelman, Susan G. Kleinmann, Sven Rudolph, Santiago Vila, Josip Rodin, Javier Fernandez-Sanguino . (2006, June 17). The Deb\
ian GNU/Linux FAQ. version CVS . [On-line]. Available: http://www.debian.org/doc/FAQ/index.en.html. [May. 1, 2006]
\bibitem{ol7} Gustavo Noronha Silva . (2005, March). APT HOWTO. version 1.8.10.4. [On-line]. Available: http://www.debian.org/doc/manuals/apt-howto . [May 1, 2008]
\bibitem{ol8} "The Horde Project" . Internet: http://www.horde.org/ . [May. 12, 2008]
\bibitem{ol9}  G. Carter. "OpenLDAP: Building a Company white Pages" in LDAP System Administration, 2nd ed. O'Reilly Editions.
\end{thebibliography}
 
\end{document}

BibTeX

Avec BibTex, c'est un peu moins simple, il vous faut procéder en 3 étapes.

Étape 1 : créer le fichier bibli.bib

Ce fichier possède une syntaxe propre. Pour créer une nouvelle entrée, il faut commencer par décrire le type de référence dont il s'agit. Cela peut être un livre (book), un passage de livre (in-book), un manuel (manual), …
Chaque type d'entrée, commençant par un @. Ainsi si je veux insérer un livre, avec ast_tfot comme référence, je commencerai mon fichier par :

@book={ast_tfot,
 
}

Ensuite il faut indiquer l'auteur du livre, manuel, etc. Ceci étant fait grâce à la séquence author = {auteur}. On peut aussi renseigner le titre, title = {titre}. Il existe plein d'autres arguments, mais je ne vais pas tout détailler ici, ça serait trop long. Sachez juste qu'il existe des champs obligatoires, en général author, et que les champs qu'il est possible de renseigner changent en fonction du type d'entrée (book, manual, …). Donc je vous laisse chercher pour les autres types d'entrées.

Voici ce que donne une entrée complète de bibliographie, notez la virgule pour séparer chaque champs :

@book{ast_tfot,
author = {Van Meggelen, Jim \and Madsen,  Leif \and Smith,  Jared},
title = {Asterisk ; The Future of Telephony},
publisher = {O'Reilly},
isbn = {0-596-51048-9, 978-0-596-51048-0},
year = {2007},
edition = {second}
}

Étape 2 : Insérer la bibligraphie dans votre fichier .tex

Construire la bibliographie ne suffit pas ; il faut maintenant dire à LaTeX d'utiliser vos références.
Ceci est fait grâce à la commande \bibliography{blibli.bib}. Mais il faut aussi dire quel style nous allons utiliser pour construire notre bibliographie. On utilise la commande \bibliographystyle{plain} avant \bibliography{blibli.bib}, pour indiquer que l'on utilise le style plain pour construire la bibliographie.
Il existe de nombreux styles pour constuire une bibliographie, on retiendra en particulier : plain, abbrv, alpha. Je vous laisse découvrir l'effet de chaque style sur la bibliographie et les citations, qui se font aussi avec la commande \cite{ref} ; par exemple pour citer mon bouquin sur Asterisk, je vais procéder de la manière suivante : \cite{ast_tfot}.

Étape 3 : compiler le tout

La compilation d'un document comportant une bibliographie externe se fait en 3 passes latex et 1 passe bibtex :

pdflatex rapport.tex
bibtex rapport
pdflatex rapport.tex
pdflatex rapport.tex

Petite explication : lors du premier passage de pdflatex, le fichier rapport.aux va être généré, c'est de ce fichier dont bibtex a besoin pour fonctionner. Ensuite l'appel à bibtex va générer les fichiers, rapport.bbl et rapport.blg dont pdflatex va se servir pour insérer la bibliographie. Le dernier passage sert en fait à construire correctement les références croisées (comme dans le cas de la table des matières et les footnotes).

Le prochain chapitre portera sur la création d'un index/glossaire, qui arrivera quand j'aurais le courage de le rédiger.
Au passage, je vous conseille d'aller voir sur ce site pour appendre à gérer les compilations LaTeX avec GNU Make.