summaryrefslogtreecommitdiff
path: root/info/formation-latex-ul/source/bibliographie.tex
diff options
context:
space:
mode:
Diffstat (limited to 'info/formation-latex-ul/source/bibliographie.tex')
-rw-r--r--info/formation-latex-ul/source/bibliographie.tex390
1 files changed, 178 insertions, 212 deletions
diff --git a/info/formation-latex-ul/source/bibliographie.tex b/info/formation-latex-ul/source/bibliographie.tex
index 1af57d5f23..91f52a4d0b 100644
--- a/info/formation-latex-ul/source/bibliographie.tex
+++ b/info/formation-latex-ul/source/bibliographie.tex
@@ -1,4 +1,4 @@
-%%% Copyright (C) 2020 Vincent Goulet
+%%% Copyright (C) 2015-2023 Vincent Goulet
%%%
%%% Ce fichier fait partie du projet
%%% «Rédaction avec LaTeX»
@@ -15,13 +15,14 @@
\nobibliography*
La production de la bibliographie d'un ouvrage d'une certaine ampleur
---- qu'il s'agisse d'un article scientifique, d'un mémoire, d'une
-thèse --- est une tâche d'une grande importance qui peut rapidement devenir
-laborieuse\dots\ lorsqu'elle n'est pas réalisée avec les outils appropriés.
+--- qu'il s'agisse d'un article scientifique, d'un livre, d'une thèse
+--- est une tâche d'une grande importance qui peut rapidement devenir
+laborieuse\dots\ lorsqu'elle n'est pas réalisée avec les outils
+appropriés.
L'ordinateur est bien meilleur qu'un humain pour accomplir certaines
-opérations propres à la production d'une bibliographie. Un auteur ne
-devrait se préoccuper que de colliger les informations
+opérations propres à la production d'une bibliographie. Vous ne
+devriez vous préoccuper que de colliger les informations
bibliographiques, puis de sélectionner les ouvrages à citer. La
machine peut ensuite se charger:
\begin{itemize}
@@ -57,14 +58,11 @@ lequel de ces outils utiliser.
Fort de plus de 25 années d'existence, {\BibTeX}\index{bibtex@\BibTeX}
\citep{bibtex} est le système standard de traitement des
-bibliographies dans {\LaTeX}. Il est stable et prévisible --- ce que
-certains considéreraient des bogues passent pour des caractéristiques
---- et, surtout, il existe un vaste catalogue de références
-bibliographiques en format {\BibTeX}. C'est généralement le seul
-format accepté par les revues scientifiques. Non qu'il s'agisse d'un
-argument massue, mais même Wikipedia, dans les rubriques «Citer cette
-page», et la Bibliothèque de l'Université Laval, dans les pages de
-notices bibliographiques, offrent les citations en format {\BibTeX}.
+bibliographies dans {\LaTeX}. Le système est stable et prévisible ---
+ce que certains considéreraient des bogues passent pour des
+caractéristiques --- et, surtout, il existe un vaste catalogue de
+références bibliographiques en format {\BibTeX}. C'est généralement le
+seul format accepté par les revues scientifiques.
{\BibTeX} est principalement un système de tri d'entrées
bibliographiques et d'interface avec la base de données. La
@@ -76,7 +74,7 @@ présentation des citations et de la bibliographie relève d'un
Fonctionnant de pair --- et exclusivement --- avec {\BibTeX},
\pkg{natbib} \citep{natbib} est un paquetage qui fournit des styles et
des commandes pour composer des bibliographies dans le format
-auteur-année fréquemment utilisé dans les sciences naturelles et
+auteur-date fréquemment utilisé dans les sciences naturelles et
sociales\footnote{%
C'est le style utilisé dans le présent document.}. %
Le paquetage est également compatible avec les styles de citation
@@ -85,45 +83,42 @@ standards mentionnés ci-dessus.
Parce qu'il est flexible et qu'il rend facile de produire des
extensions compatibles, \pkg{natbib} est en quelque sorte devenu un
standard \emph{de facto} pour la composition des bibliographies.
-D'ailleurs, la classe \class{ulthese} pour les thèses et mémoires de
-l'Université Laval charge par défaut le paquetage.
Il existe plusieurs autres paquetages pour rencontrer des exigences
particulières avec {\BibTeX}: bibliographies multiples, bibliographies
par chapitre, etc. \citet{Mori:bibliographies:2009} en offre un bon
-survol. Consulter aussi la section \emph{Bibliographies and citations}
-de la formidable %
-\doc[\emph{UK List of {\TeX} Frequently Asked Questions}]{letterfaq}{http://www.tex.ac.uk/}.
+survol. Consulter aussi la section \emph{Bibliographies} de la
+foire aux questions %
+\link{https://texfaq.org}{\emph{Frequently Asked Questions List for {\TeX}}}.
\subsection{Biber et biblatex}
\label{sec:bibliographie:systeme:biblatex}
-Au moment d'écrire ces lignes, un nouveau système de traitement des
-bibliographies dans {\LaTeX} est en émergence. Il est formé du moteur
-de traitement Biber\index{Biber} \citep{biber} et du paquetage \pkg{biblatex}\index{biblatex}
-\citep{biblatex}. Ensemble, ils visent tout à la fois à remplacer
-l'infrastructure bâtie autour de {\BibTeX} et à proposer des
-fonctionnalités additionnelles. Citons le support natif des caractères
-UTF-8 et de nombreux modes de citation, dont le mode
-auteur-titre populaire en sciences humaines.
+Un nouveau système de traitement des bibliographies dans {\LaTeX} est
+en émergence depuis quelques années. Il est formé du moteur de
+traitement Biber\index{Biber} \citep{biber} et du paquetage
+\pkg{biblatex}\index{biblatex} \citep{biblatex}. Ensemble, ils visent
+tout à la fois à remplacer l'infrastructure bâtie autour de {\BibTeX}
+et à proposer des fonctionnalités additionnelles. Citons le support
+natif des caractères UTF-8 et de nombreux modes de citation, dont le
+mode auteur-titre populaire en sciences humaines.
Le duo Biber-\pkg{biblatex} bénéficie d'un développement récent en
phase avec les technologies et les préoccupations actuelles. Certains
enjoignent aux débutants de sauter dans ce train. Difficile,
-cependant, de dire si ce système saura s'établir comme nouveau
+cependant, de dire si ce système saura s'établir comme le nouveau
standard, surtout compte tenu de la masse de matériel disponible pour
{\BibTeX}.
-Pour de l'information additionnelle, consulter %
-\link{https://tex.stackexchange.com/q/25701}{cette entrée} %
-du site {\TeX}--{\LaTeX} Stack Exchange qui fournit un excellent
-sommaire des mérites et des inconvénients respectifs des deux systèmes
-de traitement de bibliographie.
+Le site {\TeX}--{\LaTeX} Stack Exchange contient une %
+\link{https://tex.stackexchange.com/q/25701}{entrée} %
+qui fournit un excellent sommaire des mérites et des inconvénients
+respectifs des deux systèmes de traitement de bibliographie.
-En l'absence d'un consensus clair, nous avons choisi de traiter dans
-ce chapitre à la fois du système le plus répandu et de celui avec
-lequel nous sommes le plus familier, soit la combinaison {\BibTeX} et
+En l'absence d'un consensus clair, j'ai choisi de traiter dans ce
+chapitre à la fois du système le plus répandu et de celui avec lequel
+je suis le plus familier, soit la combinaison {\BibTeX} et
\pkg{natbib}.
\subsection{EndNote}
@@ -147,44 +142,41 @@ nécessaire pour réaliser la conversion.
\section{Processus de création d'une bibliographie}
\label{sec:bibliographie:processus}
-La création d'une bibliographie compte plusieurs étapes. Nous les
-présentons ici afin d'en avoir une vue d'ensemble avant d'aborder les
+La création d'une bibliographie compte plusieurs étapes. Je les
+présente ici afin d'en avoir une vue d'ensemble avant d'aborder les
détails dans les sections suivantes.
\begin{enumerate}
\item Construire une ou plusieurs bases de données contenant les
- informations bibliographiques. On utilise les mêmes bases de données
- pour tous ses documents. Par conséquent, le temps consacré à cette
- étape s'amenuise au fur et à mesure que l'on complète ses bases de
- données.
+ informations bibliographiques. Vous souhaiterez utiliser les mêmes
+ bases de données pour tous vos documents. Par conséquent, le temps
+ consacré à cette étape s'amenuisera au fur et à mesure que vous
+ garnirez vos bases de données.
\item Choisir un style de citation et de présentation de la
- bibliographie, généralement en se conformant aux us et coutumes dans
- sa discipline scientifique ou aux instructions d'un éditeur.
-\item Insérer dans le texte de son document des références à des
- ouvrages se trouvant dans ses bases de données bibliographiques.
-\item Insérer dans le code source du document les informations
- relatives au style de bibliographie et aux bases de données à
- utiliser, puis composer les références et la bibliographie avec
- {\BibTeX}.
+ bibliographie, généralement en vous conformant aux us et coutumes de
+ votre discipline scientifique ou aux instructions d'un éditeur.
+\item Insérer dans le texte d'un document des références à des
+ ouvrages se trouvant dans vos bases de données bibliographiques.
+\item Composer les références et la bibliographie avec {\BibTeX}.
\end{enumerate}
\section{Création d'une base de données}
\label{sec:bibliographie:bib}
-Il est tout à fait possible de citer des références et de construire
-une bibliographie avec {\LaTeX} sans avoir recours à une base de
-données bibliographiques et à {\BibTeX} pour traiter celles-ci. Nous
-recommandons toutefois fortement d'adopter cette approche.
-L'investissement requis en temps et en efforts demeure relativement
-faible, surtout au regard des avantages:
+Bien qu'il soit possible de citer des références et de construire une
+bibliographie avec {\LaTeX} sans avoir recours à une base de données
+bibliographiques, je vous recommande fortement de consacrer temps et
+efforts à construire une telle base de données et à apprendre à
+utiliser {\BibTeX} pour traiter ses enregistrements. L'investissement
+demeure relativement faible au regard des avantages:
\begin{itemize}
-\item on entre les informations dans une base de données une seule
- fois pour ensuite les utiliser à répétition;
+\item les informations sont saisies une fois dans une base de données,
+ puis utilisées à répétition;
\item le traitement automatisé des informations assure une
présentation uniforme de celles-ci;
-\item on peut changer le style de présentation de la bibliographie
- sans pour autant toucher aux informations bibliographiques.
+\item vous pouvez changer le style de présentation de la bibliographie
+ est sans pour autant toucher aux informations bibliographiques.
\end{itemize}
La base de données n'est en fait qu'un simple fichier texte dans
@@ -213,20 +205,20 @@ document.
Il est beaucoup plus facile de comprendre ce dont il est question ici
par le biais d'exemples. Des commentaires et précisions additionnels sur la
-préparation des entrées bibliographiques suivent l'\autoref*{ex:bibliographie:bib}.
+préparation des entrées bibliographiques suivent l'\autoref{ex:bibliographie:bib}.
\begin{exemple}
\label{ex:bibliographie:bib}
On trouvera ci-dessous les entrées bibliographiques d'un livre
\citep{Kopka:latex:4e}, d'un article scientifique
\citep{Mori:bibliographies:2009} et d'un manuel générique, en
- l'occurrence la documentation d'un paquetage \citep{natbib}. Pour
- faciliter la comparaison, chaque entrée est immédiatement suivie du
- texte de la notice tel qu'il apparait dans la bibliographie du
- présent ouvrage.
+ l'occurrence la documentation d'un paquetage {\LaTeX}
+ \citep{natbib}. Pour faciliter la comparaison, chaque entrée est
+ immédiatement suivie du texte de la notice tel qu'il apparait dans
+ la bibliographie du présent ouvrage.
\begin{lstlisting}[language=]
-@Book{Kopka:latex:4e,
+@book{Kopka:latex:4e,
author = {Kopka, Helmut and Daly, Patrick W.},
title = {Guide to {\LaTeX}},
publisher = {Addison-Wesley},
@@ -241,7 +233,7 @@ préparation des entrées bibliographiques suivent l'\autoref*{ex:bibliographie:
\end{framed}
\begin{lstlisting}[language=]
-@Article{Mori:bibliographies:2009,
+@article{Mori:bibliographies:2009,
author = {Lapo F. Mori},
title = {Managing bibliographies with {\LaTeX}},
journal = {{TUG}boat},
@@ -258,11 +250,11 @@ préparation des entrées bibliographiques suivent l'\autoref*{ex:bibliographie:
\end{framed}
\begin{lstlisting}[language=]
-@Manual{natbib,
+@manual{natbib,
author = {Patrick W. Daly},
title = {Natural Sciences Citations and References},
year = 2010,
- url = {https://www.ctan.org/pkg/natbib/},
+ url = {https://www.ctan.org/pkg/natbib},
language = {english}}
\end{lstlisting}
@@ -275,71 +267,59 @@ préparation des entrées bibliographiques suivent l'\autoref*{ex:bibliographie:
\begin{itemize}
\item Les types d'entrée bibliographique dans l'exemple ci-dessus sont
- \code{Book}, \code{Article} et \code{Manual}\footnote{%
+ \code{book}, \code{article} et \code{Manual}\footnote{%
Les identifiants des types d'entrée et des champs sont insensibles
à la casse. Par exemple, on pourrait tout aussi bien débuter une
entrée par \code{@Manual}, \code{@manual} ou \code{@MANUAL}.}. %
- On remarquera que les champs utilisés sont différents d'un type à un
- autre.
-
- On trouvera la liste de tous les types d'entrée et des champs
- obligatoires et optionnels pour chacun dans, entre autres, %
- \doc[Wikipedia]{}{https://fr.wikipedia.org/wiki/BibTeX}, %
- la %
- \doc[documentation de {\BibTeX}]{btxdoc}{http://texdoc.net/pkg/btxdoc} %
+ Vous remarquerez que les champs utilisés sont différents d'un type à
+ un autre. Vous trouverez la liste de tous les types d'entrée et des champs
+ obligatoires et optionnels pour chacun dans, entre autres, la %
+ \doc[documentation de {\BibTeX}]{btxdoc}{https://texdoc.net/pkg/btxdoc}, %
+ \doc[Wikipedia]{}{https://fr.wikipedia.org/wiki/BibTeX} %
ou la plupart des bons ouvrages de référence
- \citep[comme][]{Kopka:latex:4e}.
-\item On entre le nom d'un auteur soit sous la forme \code{\{Prénom
+ \citep[dont][]{Kopka:latex:4e}.
+\item Le nom d'un auteur est saisi soit sous la forme \code{\{Prénom
Nom\}}, soit sous la forme \code{\{Nom, Prénom\}}. La seconde
forme est surtout utile pour distinguer explicitement le nom du
prénom, par exemple dans le cas de prénoms ou de noms multiples.
\item Lorsqu'un ouvrage compte plusieurs auteurs, on distingue ceux-ci
- en séparant le nom complet de \emph{chacun} des auteurs par le
- mot-clé \code{and}.
-\item {\BibTeX} gère automatiquement les hauts et bas de
- casse (majuscules et minuscules), en particulier dans les titres
+ en séparant le nom complet de \emph{chacun} des auteurs par.
+\item {\BibTeX} gère automatiquement les hauts et bas de casse
+ (majuscules et minuscules), en particulier dans les titres
d'ouvrages. Pour préserver une casse particulière, il suffit de
- placer les lettres entre accolades.
-
- Par exemple, dans la seconde entrée de
- l'\autoref{ex:bibliographie:bib}, le titre du journal TUGboat est
- inscrit sous la forme \code{\{\{TUG\}boat\}} pour éviter que {\BibTeX}
- ne le transforme en «Tugboat».
-\item Les champs \code{isbn}, \code{url} et quelques autres
- \citep[section~2.8]{natbib} sont fournis par le paquetage
+ placer les lettres entre accolades. Par exemple, dans la seconde
+ entrée de l'\autoref{ex:bibliographie:bib}, le titre du journal
+ TUGboat est inscrit sous la forme \code{\{\{TUG\}boat\}} pour éviter
+ que {\BibTeX} ne le transforme en «Tugboat».
+\item Les champs \code{isbn}, \code{url}, \code{doi} et quelques
+ autres \citep[section~2.8]{natbib} sont fournis par le paquetage
\pkg{natbib}. Même si ces champs ne devaient pas s'afficher dans la
bibliographie pour le style choisi, c'est une bonne idée d'insérer
les informations dans la base de données pour référence future.
\item Le champ \code{language}, introduit par \pkg{babel}, permet de
- préciser la langue de l'entrée bibliographique. La césure de mots et
- la composition de certains éléments seront ainsi adaptées en
- conséquence.
-
- Par exemple, si l'entrée d'un document comporte le champ
- \code{edition = 2}, sa fiche bibliographique contiendra la mention
- «2{\ieme} édition» ou «2\up{nd} edition» selon que l'on a précisé
- que l'ouvrage est en français ou en anglais.
+ préciser la langue de l'entrée bibliographique. La coupure de mots
+ et la composition de certains éléments seront ainsi adaptées en
+ conséquence. Par exemple, si l'entrée d'un document comporte le
+ champ \code{edition = 2}, sa fiche bibliographique contiendra la
+ mention «2{\ieme} édition» ou «2\up{nd} edition» selon que l'on a
+ précisé que l'ouvrage est en français ou en anglais.
\item {\BibTeX} supporte les lettres accentuées ou autres caractères
spéciaux dans le texte des champs seulement si le document utilisant
la bibliographie supporte lui-même ces caractères; voir la
\autoref{sec:bases:francais}. Autrement, il faut entrer les
caractères spéciaux avec les commandes {\LaTeX} de base tel
- qu'expliqué sommairement à la \autoref{sec:bases:caracteres}.
-
- Notre recommandation: éviter les lettres accentuées dans les
- entrées susceptibles d'être utilisées dans un document entièrement
- en anglais.
+ qu'expliqué sommairement à la \autoref{sec:bases:caracteres}. Ma
+ recommandation: évitez les lettres accentuées dans les entrées
+ susceptibles d'être utilisées dans un document entièrement en
+ anglais.
\end{itemize}
\tipbox{Entretenir une base de données bibliographiques unique peut
- rapidement devenir pénible quand le nombre d'entrée devient grand.
-
+ rapidement devenir pénible quand son nombre d'entrées devient grand.
Mieux vaut alors scinder ses références dans plusieurs fichiers par
- thématique, un peu comme dans une bibliothèque:
- droit, finance, informatique, mathématiques, etc.
-
- On nommera ensuite les fichiers du nom de la thématique:
- \code{droit.bib}, \code{finance.bib},
+ thématique, un peu comme dans une bibliothèque: droit, finance,
+ informatique, mathématiques, etc. Vous pouvez alors nommer les
+ fichiers selon la thématique: \code{droit.bib}, \code{finance.bib},
\code{informatique.bib}, etc.}
@@ -354,16 +334,16 @@ bibliographie est contrôlé par un \emph{style} choisi avec la commande
composantes de la bibliographie:
\begin{enumerate}
\item le mode de citation dans le texte (numérique, alphanumérique,
- auteur-année, etc.);
+ auteur-date, etc.);
\item la présentation des notices bibliographiques (ordre des
éléments, ponctuation, mise en forme des caractères, etc.).
\end{enumerate}
-On trouvera des exemples de quelques styles de bibliographie dans le
-\autoref{tab:bibliographie:styles}.
+Le \autoref{tab:bibliographie:styles} contient des exemples de
+quelques styles bibliographiques.
\begin{table}
- \caption{Quelques styles de bibliographie et leur effet sur le mode de
- citation et le format des notices bibliographiques}
+ \caption{Quelques styles bibliographiques et leur effet sur le mode
+ de citation et le format des notices bibliographiques}
\label{tab:bibliographie:styles}
\small
\textbf{Styles standards numériques et alphanumériques} \\[0.5\normalbaselineskip]
@@ -394,7 +374,7 @@ On trouvera des exemples de quelques styles de bibliographie dans le
\end{tabularx} \\
\medskip
- \textbf{Styles auteur-année avec \pkg{natbib}} \\[0.5\normalbaselineskip]
+ \textbf{Styles auteur-date avec \pkg{natbib}} \\[0.5\normalbaselineskip]
\begin{tabularx}{1.0\linewidth}{p{0.16\linewidth}p{0.35\linewidth}X}
\toprule
style & mode de citation & format de notice \\
@@ -420,43 +400,31 @@ Les styles standards de {\LaTeX} sont \code{plain}, \code{unsrt},
\code{alpha} et \code{abbrv}. Ces styles ont été développés pour des
modes de citation numériques ou alphanumériques.
-Pour plus de flexibilité, nous recommandons d'utiliser le paquetage
+Pour plus de flexibilité, je recommande d'utiliser le paquetage
\pkg{natbib} pour la gestion des références et du style de la
bibliographie. Entre autres choses, ce paquetage supporte le style de
-citation auteur-année fréquemment employé en sciences naturelles et
+citation auteur-date fréquemment employé en sciences naturelles et
sociales, plusieurs commandes de citation, un grand nombre de styles
de bibliographie, ainsi que des entrées spécifiques pour les numéros
-ISBN et les URL. Le paquetage fournit des styles \code{plainnat},
+ISBN, les adresses URL et les identificateurs d'objets numériques
+(DOI). Le paquetage fournit des styles \code{plainnat},
\code{unsrtnat} et \code{abbrvnat} similaires aux styles standards,
mais plus complets. Il existe des %
-\doc[versions francisées]{}{https://mirrors.ctan.org/biblio/bibtex/contrib/bib-fr/} %
-de ces styles dans CTAN et dans {\TeX}~Live.
-Il est fortement recommandé de consulter la %
-\doc{natbib}{http://texdoc.net/pkg/natbib/} %
-de \pkg{natbib} pour les détails. On y trouvera également des
-informations sur l'utilisation de styles de citation autres que
-auteur-année.
-
-Également dans CTAN et dans {\TeX}~Live, le paquetage
-\pkg{francais-bst} \citep{francais-bst} fournit deux feuilles de style
-compatibles avec \pkg{natbib} permettant de composer des
-bibliographies auteur-année respectant les normes de typographie
+\doc[versions
+francisées]{}{https://mirrors.ctan.org/biblio/bibtex/contrib/bib-fr} %
+de ces styles dans CTAN et dans {\TeX}~Live. La consultation de la %
+\doc{natbib}{https://texdoc.net/pkg/natbib} %
+de \pkg{natbib} est fortement recommandé. Vous y trouverez également
+des informations sur l'utilisation de styles de citation autres que
+auteur-date.
+
+Également dans CTAN et dans {\TeX}~Live, mon paquetage
+\pkg{francais-bst} \citep{francais-bst} fournit deux styles
+bibliographiques compatibles avec \pkg{natbib} permettant de composer
+des bibliographies auteur-date respectant les normes de typographie
française proposées dans \citet{Malo:1996}; voir le dernier exemple du
\autoref{tab:bibliographie:styles}.
-Le paquetage \pkg{natbib} est chargé par défaut par la classe
-\class{ulthese}; consulter la section~6.6 de la %
-\doc{ulthese}{http://texdoc.net/pkg/ulthese/} %
-de la classe pour plus d'information sur l'interaction entre le
-paquetage et celle-ci.
-
-En terminant, notons que la plupart des journaux scientifiques et des
-maisons d'édition ont leur propre style que les auteurs sont tenus
-d'utiliser. En ce qui a trait aux thèses et mémoires de l'Université
-Laval, la Faculté des études supérieures et postdoctorales n'impose
-aucun style de bibliographie particulier. Nous recommandons
-d'utiliser le style usuel dans sa discipline scientifique.
-
\section{Insertion de références dans le texte}
@@ -479,16 +447,16 @@ L'effet de la commande est double:
\item ajouter le document dans la bibliographie.
\end{enumerate}
En somme, outre la phase de compilation qui fait l'objet de la section
-suivante, c'est tout ce qu'il y a à faire pour construire sa
-bibliographie.
+suivante, c'est tout ce qu'il y a à faire pour construire la
+bibliographie d'un document.
-Avec \pkg{natbib}, on utilisera plutôt les commandes
+Le paquetage \pkg{natbib} propose plutôt les commandes
\begin{lstlisting}
\citet`\marg{clé}'
\citep`\marg{clé}'
\end{lstlisting}
-Dans le style de citation auteur-année, ces commandes permettent
-respectivement d'insérer une référence au fil de la phrase ou en
+Dans le style de citation auteur-date, ces commandes permettent,
+respectivement, d'insérer une référence au fil de la phrase ou en
aparté:
\begin{demo}
\begin{texample}[0.55\linewidth]
@@ -497,7 +465,7 @@ aparté:
en offre un bon survol.
\end{lstlisting}
\producing
- \citet{Mori:bibliographies:2009},
+ \citet{Mori:bibliographies:2009}
en offre un bon survol.
\end{texample}
\begin{texample}[0.55\linewidth]
@@ -511,10 +479,10 @@ TUGboat a publié un bon survol
\end{texample}
\end{demo}
-On ne devrait \emph{jamais} entrer directement dans le texte des
+Vous ne devriez \emph{jamais} entrer directement dans le texte des
informations bibliographiques, même partielles. Pour insérer dans le
texte le nom d'un auteur ou l'année de publication d'un ouvrage,
-\pkg{natbib} offre les commandes:
+utilisez les commandes de \pkg{natbib} suivantes:
\begin{lstlisting}
\citeauthor`\marg{clé}'
\citeyear`\marg{clé}'
@@ -524,15 +492,16 @@ inadvertance, ou d'oublier de modifier dans le texte une année de
publication que l'on aura changé dans la base de données
bibliographique.
-Le paquetage fournit plusieurs autres commandes pour manipuler les
-informations bibliographiques et contrôler leur présentation;
-consulter la %
-\doc{natbib}{http://texdoc.net/pkg/natbib} %
-de \pkg{natbib}.
+Si vous utilisez le paquetage \pkg{natbib}, je vous recommande de
+jeter un œil à sa %
+\doc{natbib}{https://texdoc.net/pkg/natbib}. %
+Vous y trouverez des informations sur plusieurs autres commandes pour
+manipuler les informations bibliographiques et contrôler leur
+présentation.
Il arrive que l'on souhaite inclure dans la bibliographie un ou
plusieurs documents qui ne sont pas cités dans le texte. Pour ce
-faire, insérer dans le corps du document la commande
+faire, il suffit d'insérer dans le corps du document la commande
\begin{lstlisting}
\nocite`\marg{clé1,clé2,...}'
\end{lstlisting}
@@ -543,12 +512,14 @@ Le paquetage \pkg{hyperref} fait automatiquement d'une référence
bibliographique un hyperlien vers l'entrée dans la bibliographie.
C'est le cas dans le présent document. Or, il peut arriver que
l'hyperlien soit superflu ou indésirable. Pour le supprimer pour une
-référence particulière, utiliser l'environnement \Ie{NoHyper}:
+référence particulière, utilisez l'environnement \Ie{NoHyper}:
\begin{lstlisting}
\begin{NoHyper} \citet`\marg{clé}' \end{NoHyper}
\end{lstlisting}
+
+
\section{Composition de la bibliographie}
\label{sec:bibliographie:bibtex}
@@ -557,7 +528,7 @@ les ouvrages à inclure dans la bibliographie. C'est toutefois l'outil
externe {\BibTeX} qui se chargera de fournir à {\LaTeX} le texte des
références ainsi que le contenu de la bibliographie.
-À la \autoref{sec:presentation:processus}, nous avons représenté
+À la \autoref{sec:presentation:processus}, j'ai représenté
schématiquement comme suit le processus de création d'un document avec
pdf{\LaTeX} ou {\XeLaTeX}:
\begin{center}
@@ -606,7 +577,7 @@ une étape de compilation du document avec {\BibTeX}:
\begin{minipage}[t]{0.12\linewidth}
\centering
{\LARGE\faCogs}\;
- \raisebox{-2pt}{\parbox[b]{1em}{\centering\large\faRedo\tiny\\ $\times 2$}} \\ \medskip
+ \raisebox{2pt}{\small $\times 2$} \\ \medskip
\code{pdflatex} \\ \code{xelatex}
\end{minipage}
\quad\faArrowRight\quad
@@ -623,39 +594,35 @@ une bibliographie est le suivant.
\begin{enumerate}
\item Composer le texte et y insérer des références avec les commandes
de la section précédente.
-\item Ajouter dans le préambule ou près de la commande
- \cmdprint{\bibliography} ci-dessous la commande
+\item Définir le style bibliographique dans le préambule ou près de la
+ commande \cmdprint{\bibliography} avec la commande
\begin{lstlisting}
\bibliographystyle`\marg{style}'
\end{lstlisting}
- où \meta{style} est un nom de style bibliographique.
-\item Ajouter dans le texte la commande
+\item Insérer dans le texte la commande
\begin{lstlisting}
\bibliography{`\meta{base\_donnees1}', `\meta{base\_donnees2}', ...}
\end{lstlisting}
- à l'endroit où l'on veut qu'apparaisse la bibliographie
- (généralement à la fin du document). Les arguments
- \meta{base\_donnees1}, \meta{base\_donnees2}, séparés par des
- virgules, sont les noms (sans l'extension \code{.bib}) des fichiers
- de données bibliographiques.
+ à l'endroit où doit apparaitre la bibliographie (généralement à la
+ fin du document). Les arguments \meta{base\_donnees1},
+ \meta{base\_donnees2}, séparés par des virgules, sont les noms (sans
+ l'extension \code{.bib}) des fichiers de données bibliographiques.
\item \label{item:bibliographie:1} Compiler le document une première
- fois avec un moteur {\TeX} afin que {\LaTeX} détecte les ouvrages à
- insérer dans la bibliographie. À cette étape, les références dans le
- texte apparaissent sous forme d'un point d'interrogation
- «\textbf{?}».
+ fois afin que {\LaTeX} détecte les ouvrages à insérer dans la
+ bibliographie. À cette étape, les références dans le texte
+ apparaissent sous forme d'un point d'interrogation «\textbf{?}».
\item Compiler le document avec {\BibTeX} afin de préparer le texte
des références et composer la bibliographie.
\item \label{item:bibliographie:2} Compiler à nouveau le document au
- moins deux fois avec un moteur {\TeX} afin d'y insérer d'abord la
- bibliographie, puis le texte des références.
+ moins deux fois afin d'y insérer d'abord la bibliographie, puis le
+ texte des références.
\end{enumerate}
Il faut répéter les étapes
\ref*{item:bibliographie:1}--\ref*{item:bibliographie:2} chaque fois
qu'une nouvelle référence est ajoutée dans le document ou que l'entrée
bibliographique est modifiée. Autrement, tant que la bibliographie
-demeure inchangée, une compilation standard avec seulement le moteur
-{\TeX} suffit.
+demeure inchangée, une compilation standard suffit.
\begin{exemple}
La \autoref{fig:bibliographie:bibtex:1} présente le contenu d'un
@@ -663,7 +630,7 @@ demeure inchangée, une compilation standard avec seulement le moteur
d'un document simple contenant des références et une bibliographie.
\begin{itemize}
- \item Le document utilise le mode de citation auteur-année de
+ \item Le document utilise le mode de citation auteur-date de
\pkg{natbib}.
\item La présence du paquetage \pkg{fontspec} dans le préambule
indique que le document doit être compilé avec {\XeLaTeX}. Cela
@@ -715,20 +682,20 @@ demeure inchangée, une compilation standard avec seulement le moteur
\end{figure}
\end{exemple}
-\tipbox{Aux toutes dernières étapes avant de rendre un document, s'assurer
- d'exécuter {\BibTeX} une dernière fois et de compiler avec
- pdf{\LaTeX} ou {\XeLaTeX} au moins deux fois. Le journal de la
- compilation (\emph{log file}) ne devrait pas rapporter de références
+\tipbox{Lorsque vous en êtes aux toutes dernières étapes avant de
+ publier un document, assurez-vous d'exécuter {\BibTeX} et de
+ compiler le document au moins deux fois et que le journal de la
+ compilation (\emph{log file}) ne rapporte pas de références
manquantes (\emph{undefined references}).}
-Les logiciels intégrés de rédaction offrent généralement des raccourcis pour exécuter la
-compilation avec {\BibTeX}.
+Les logiciels intégrés de rédaction offrent généralement des
+raccourcis pour exécuter la compilation avec {\BibTeX}.
\begin{itemize}
-\item Dans TeXShop, on sélectionne un autre programme dans le menu à
+\item Dans TeXShop, sélectionner un autre programme dans le menu à
côté du bouton «Composition».
-\item Dans Texmaker, on choisit le programme approprié dans le menu de
+\item Dans Texmaker, choisir le programme approprié dans le menu de
composition rapide.
-\item Dans GNU~Emacs, on choisit \code{BibTeX} dans le menu
+\item Dans GNU~Emacs, choisir \code{BibTeX} dans le menu
\code{Command} ou après avoir lancé la commande
\code{TeX-command-master} avec \code{C-c C-c}.
\end{itemize}
@@ -747,11 +714,11 @@ interfaces.
\label{fig:bibliographie:editeurs}
\end{figure}
-On trouvera des informations additionnelles, notamment sur des sources
-de données bibliographiques et des outils de gestion des bases de
-données, dans la section %
-\doc[Gestion de la bibliographie]{}{https://fr.wikibooks.org/wiki/LaTeX/Gestion_de_la_bibliographie} %
-de \citeauthor{wikilivres:latex}.
+\citeauthor{wikilivres:latex} consacre toute une %
+\doc[section]{}{https://fr.wikibooks.org/wiki/LaTeX/Gestion_de_la_bibliographie} %
+à la gestion de la bibliographie. Vous y trouverez plusieurs
+informations additionnelles, notamment sur des sources de données
+bibliographiques et des outils de gestion des bases de données.
@@ -792,14 +759,14 @@ de \citeauthor{wikilivres:latex}.
avec la commande \cmdprint{\ss}.
\end{enumerate}
\begin{sol}
- On trouve les champs obligatoires et optionnels pour chaque type
- d'entrée dans %
- \doc[Wikipedia]{}{https://fr.wikipedia.org/wiki/BibTeX}. %
- La clé est laissée vacante dans les réponses ci-dessous.
+ L'\link{https://fr.wikipedia.org/wiki/BibTeX}{entrée sur \BibTeX}
+ dans Wikipedia fournit la liste des champs obligatoires et
+ optionnels pour chaque type d'entrée. La clé est laissée vacante
+ dans les réponses ci-dessous.
\begin{enumerate}
- \item On utilise le type \code{Article} pour cette entrée.
+ \item Cette entrée utilise le type \code{article}.
\begin{lstlisting}[language=]
-@Article{,
+@article{,
author = {Frank Mittelbach},
title = {How to Influence the Position of Float
Environments Like Figure and Table In
@@ -812,9 +779,9 @@ de \citeauthor{wikilivres:latex}.
language = {english}}
\end{lstlisting}
- \item On utilise le type \code{Book} pour cette entrée.
+ \item Cette entrée utilise le type \code{book}.
\begin{lstlisting}[language=]
-@Book{,
+@book{,
author = {Peter Wilson},
title = {The Memoir Class for Configurable
Typesetting},
@@ -822,23 +789,22 @@ de \citeauthor{wikilivres:latex}.
year = 2013,
edition = 8,
note = {Maintained by Lars Madsen},
- url = {https://www.ctan.org/pkg/memoir/},
+ url = {https://www.ctan.org/pkg/memoir},
language = {english}}
\end{lstlisting}
\item La réponse ci-dessous contient les prénoms des auteurs,
- simplement afin d'illustrer que {\BibTeX} sait les abréger au
- moment de composer la notice bibliographique. Remarquer
- l'utilisation des accolades \verb={ }= dans le titre pour
- préserver la casse de «PSTricks» et de «PostScript».
+ simplement afin d'illustrer que {\BibTeX} est en mesure de les
+ abréger. Des accolades \verb={ }= sont utilisées dans le titre
+ pour préserver la casse de «PSTricks» et de «PostScript».
\begin{lstlisting}[language=]
-@Manual{,
+@manual{,
author = {Timothy {V}an Zandt and Denis Girou and
Herbert Vo{\ss}},
title = {{PSTricks} --- {PostScript} Macros for
Generic {\TeX}},
year = 2014,
- url = {https://www.ctan.org/pkg/pstricks-base/},
+ url = {https://www.ctan.org/pkg/pstricks-base},
language = {english}}
\end{lstlisting}
\end{enumerate}
@@ -847,7 +813,7 @@ de \citeauthor{wikilivres:latex}.
\begin{exercice}[nosol]
Utiliser pour cet exercice le fichier
- \fichier{exercice\_gabarit.tex} ainsi que la base de données
+ \fichier{exercice-gabarit.tex} ainsi que la base de données
bibliographique crée à l'exercice précédent.
\begin{enumerate}
\item Créer un document simple comprenant des références à une ou