tuteurs.ens.fr/logiciels/latex/bibtex.tml

160 lines
5.4 KiB
Text
Raw Normal View History

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE html
PUBLIC "-//ENS/Tuteurs//DTD TML 1//EN"
"tuteurs://DTD/tml.dtd">
<html>
<head>
<title>Bibliographie</title>
</head>
<body>
<h1>Faire une bibliographie avec BibTeX</h1>
<h2>Pourquoi BibTeX<65>?</h2>
<p>Il peut sembler bizarre de devoir recourir <20> un programme externe pour
g<EFBFBD>n<EFBFBD>rer quelques lignes de texte <20> la fin d'un m<>moire. N<>anmoins
l'int<6E>r<EFBFBD>t de BibTeX apparaitra tr<74>s rapidement <20> l'utilisateur d<>sireux
de construire sa bibliographie au fur et <20> mesure de la r<>daction du
texte, tout en respectant les conventions, par exemple dans le cas d'une
th<EFBFBD>se...</p>
<p>De plus, la plupart des bibliographies d'ouvrages scientifiques se
doivent d'<27>tre au format BibTeX, afin de ne pas voir <20> taper les entr<74>es
bibliographiques, mais de pouvoir utiliser les bases de donn<6E>es
existantes.</p>
<h2>Le principe</h2>
<p>BibTeX va chercher ses r<>f<EFBFBD>rences dans une base de donn<6E>es que
l'utilisateur cr<63>e, de mani<6E>re tr<74>s simple, en attribuant une
<EFBFBD><EFBFBD><EFBFBD>tiquette<EFBFBD><EFBFBD> <20> chaque r<>f<EFBFBD>rence, puis en remplissant un certain nombre
de champs (auteurs, titre, revue, ann<6E>e, <20>diteur, etc.). Cette base de
donn<EFBFBD>e est stock<63>e sous forme de fichier texte, avec comme extension
<code>.bib</code>. Elle peut <20>tre commune <20> plusieurs documents LaTeX,
comme on le verra plus tard.</p>
<p>Lorsque l'utilisateur veut citer une r<>f<EFBFBD>rence dans le fichier LaTeX,
il appelle l'<27>tiquette qui identifie cette r<>f<EFBFBD>rence dans le fichier
<code>.bib</code>, par la commande <code>\cite{}</code>. Lors de la
compilation du fichier par LaTeX, la liste des r<>f<EFBFBD>rences demand<6E>es
s'inscrit alors dans le fichier <code>.aux</code> correspondant. On peut
alors lancer BibTeX, qui fera le lien entre les requ<71>tes du document et
la base de donn<6E>es, en g<>n<EFBFBD>rant au passage un fichier <code>.bbl</code>,
qui sera, lui, sp<73>cifique au document LaTeX tel qu'on vient de le
compiler.</p>
<p>Enfin, une nouvelle compilation via LaTeX sera n<>cessaire pour
afficher correctement la bibliographie ainsi que les renvois du
texte.</p>
<h2>En pratique</h2>
<h3>Construire la base de donn<6E>es</h3>
<p>Voici un extrait de base de donn<6E>es<65>:</p>
<pre>
@article{Johnson,
author = {Edgar G. Johnson and Alfred O. Nier},
title = {Angular Aberrations in Sector Shaped
Electromagnetic Lenses for Focusing Beams of Charged Particles},
journal = {Physical Review},
volume = {91},
number = {1},
month = {jul},
year = {1953}
}
@phdthesis{Zoran,
author = {Zoran Racic},
title = {\'Etude et essais du spectrom<6F>tre <20> plasma {DYMIO}
de la mission {MARS 96}},
publisher = {Universit<69> Pierre et Marie Curie},
year = {1996}
}
</pre>
<p>Toute entr<74>e commence par un @, suivi par un descripteur. Entre
accolades, se trouve l'<27>tiquette, puis les champs, compos<6F>s d'un
sous-descripteur et de la valeur de celui ci, entre accolades. <em>Les
champs sont s<>par<61>s par des virgules,</em> l'oubli de celles ci <20>tant
vraisemblablement la source d'erreurs la plus courante<74>!</p>
<p><em>A priori</em>, BibTeX s'occupe des majuscules, et n'h<>site pas <20> en
supprimer si tel est son bon plaisir. Il y a moyen de lui faire savoir
qui c'est le chef, en enfermant les mots qu'on d<>sire laisser en
majuscule entre accolades. Les commandes TeX sont autoris<69>es.</p>
<p>N'h<>sitez pas <20> fournir un maximum d'informations, BibTeX s'arrangera
pour tout faire rentrer (ou donnera des messages d'avertissement s'il en
manque...) </p>
<p>Sauvegardez le fichier sous un nom se terminant par
<code>.bib</code></p>
<h3>Afficher la biblio dans le document LaTeX</h3>
<p><3E> l'emplacement pr<70>vu dans le fichier .tex, ins<6E>rez les lignes<65>:</p>
<pre>
\addcontentsline{toc}{section}{R<>f<EFBFBD>rences}
\bibliographystyle{plain}
\bibliography{stlong}
</pre>
<p>La commande <code>\addcontentsline</code> n'est pas obligatoire, mais
elle permet de r<>f<EFBFBD>rencer la bibliographie dans la table des
mati<EFBFBD>res.</p>
<p><code>\bibliographystyle</code> permet de choisir le style de
bibliographie.</p>
<p><code>\bibliography</code> permet d'indiquer quelle base de donn<6E>es
doit <20>tre utilis<69>e. On indique le nom du fichier, sans l'extension
<code>.bib</code></p>
<h3>Citer une r<>f<EFBFBD>rence dans le texte</h3>
<p>LaTeX n'affiche pas toutes les r<>f<EFBFBD>rences contenues dans la base de
donn<EFBFBD>es, seulement celle qui sont cit<69>es dans le texte. Par cons<6E>quent il
est normal <20> ce stade de ne rien voir s'afficher... La commande <20>
utiliser pour citer une r<>f<EFBFBD>rence est tout simplement</p>
<pre>\cite{<em>label</em>}</pre>
<p class="continue">o<> <em>label</em> est l'<27>tiquette attribu<62>e lors de
la construction de la base de donn<6E>es. Dans le style <code>plain</code>,
cette commande appara<72>t alors dans le fichier <code>.dvi</code> sous la
forme <code>[X]</code>, o<> X est le num<75>ro utilis<69> dans la bibliographie,
ou un <code>?</code> si l'<27>tiquette est erron<6F>e, ou qu'il manque une
compilation de LaTeX et/ou de BibTeX.</p>
<p>On peut n<>anmoins faire appara<72>tre une r<>f<EFBFBD>rence dans la bibliographie
sans la citer explicitement dans le texte, <20> l'aide de la commande<64>:</p>
<pre>\nocite{label}</pre>
<h3>Compilation(s)</h3>
<p>Il ne reste plus qu'<27> compiler le tout<75>:</p>
<pre>
latex mon_fichier.tex
bibtex mon_fichier.tex
latex mon_fichier.tex
</pre>
<div class="attention">Ce n'est pas le fichier <code>.bib</code> qu'on
indique <20> BibTeX, mais le fichier <code>.tex</code><3E>!</div>
2002-11-13 14:53:01 +01:00
<div class="metainformation"> Auteurs<72>: Fr<46>d<EFBFBD>ric Meynadier (2001).
Derni<EFBFBD>re modification le 2002-11-13 par Fran<61>ois-Xavier Coudert. </div>
</body> </html>