652 lines
33 KiB
HTML
652 lines
33 KiB
HTML
<!DOCTYPE html>
|
||
<html xmlns="http://www.w3.org/1999/xhtml"
|
||
lang="fr"
|
||
xml:lang="fr">
|
||
<head>
|
||
<meta charset="utf-8" />
|
||
<meta name="generator" content="pandoc" />
|
||
<meta name="viewport"
|
||
content="width=device-width, initial-scale=1.0, user-scalable=yes" />
|
||
<title>Citer ses références et créer une bibliographie avec LaTeX et Zotero</title>
|
||
<style>
|
||
code{white-space: pre-wrap;}
|
||
span.smallcaps{font-variant: small-caps;}
|
||
div.columns{display: flex; gap: min(4vw, 1.5em);}
|
||
div.column{flex: auto; overflow-x: auto;}
|
||
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
|
||
/* The extra [class] is a hack that increases specificity enough to
|
||
override a similar rule in reveal.js */
|
||
ul.task-list[class]{list-style: none;}
|
||
ul.task-list li input[type="checkbox"] {
|
||
font-size: inherit;
|
||
width: 0.8em;
|
||
margin: 0 0.8em 0.2em -1.6em;
|
||
vertical-align: middle;
|
||
}
|
||
.display.math{display: block; text-align: center; margin: 0.5rem auto;}
|
||
/* CSS for syntax highlighting */
|
||
pre > code.sourceCode { white-space: pre; position: relative; }
|
||
pre > code.sourceCode > span { line-height: 1.25; }
|
||
pre > code.sourceCode > span:empty { height: 1.2em; }
|
||
.sourceCode { overflow: visible; }
|
||
code.sourceCode > span { color: inherit; text-decoration: inherit; }
|
||
div.sourceCode { margin: 1em 0; }
|
||
pre.sourceCode { margin: 0; }
|
||
@media screen {
|
||
div.sourceCode { overflow: auto; }
|
||
}
|
||
@media print {
|
||
pre > code.sourceCode { white-space: pre-wrap; }
|
||
pre > code.sourceCode > span { display: inline-block; text-indent: -5em; padding-left: 5em; }
|
||
}
|
||
pre.numberSource code
|
||
{ counter-reset: source-line 0; }
|
||
pre.numberSource code > span
|
||
{ position: relative; left: -4em; counter-increment: source-line; }
|
||
pre.numberSource code > span > a:first-child::before
|
||
{ content: counter(source-line);
|
||
position: relative; left: -1em; text-align: right; vertical-align: baseline;
|
||
border: none; display: inline-block;
|
||
-webkit-touch-callout: none; -webkit-user-select: none;
|
||
-khtml-user-select: none; -moz-user-select: none;
|
||
-ms-user-select: none; user-select: none;
|
||
padding: 0 4px; width: 4em;
|
||
color: #aaaaaa;
|
||
}
|
||
pre.numberSource { margin-left: 3em; border-left: 1px solid #aaaaaa; padding-left: 4px; }
|
||
div.sourceCode
|
||
{ }
|
||
@media screen {
|
||
pre > code.sourceCode > span > a:first-child::before { text-decoration: underline; }
|
||
}
|
||
code span.al { color: #ff0000; font-weight: bold; } /* Alert */
|
||
code span.an { color: #60a0b0; font-weight: bold; font-style: italic; } /* Annotation */
|
||
code span.at { color: #7d9029; } /* Attribute */
|
||
code span.bn { color: #40a070; } /* BaseN */
|
||
code span.bu { color: #008000; } /* BuiltIn */
|
||
code span.cf { color: #007020; font-weight: bold; } /* ControlFlow */
|
||
code span.ch { color: #4070a0; } /* Char */
|
||
code span.cn { color: #880000; } /* Constant */
|
||
code span.co { color: #60a0b0; font-style: italic; } /* Comment */
|
||
code span.cv { color: #60a0b0; font-weight: bold; font-style: italic; } /* CommentVar */
|
||
code span.do { color: #ba2121; font-style: italic; } /* Documentation */
|
||
code span.dt { color: #902000; } /* DataType */
|
||
code span.dv { color: #40a070; } /* DecVal */
|
||
code span.er { color: #ff0000; font-weight: bold; } /* Error */
|
||
code span.ex { } /* Extension */
|
||
code span.fl { color: #40a070; } /* Float */
|
||
code span.fu { color: #06287e; } /* Function */
|
||
code span.im { color: #008000; font-weight: bold; } /* Import */
|
||
code span.in { color: #60a0b0; font-weight: bold; font-style: italic; } /* Information */
|
||
code span.kw { color: #007020; font-weight: bold; } /* Keyword */
|
||
code span.op { color: #666666; } /* Operator */
|
||
code span.ot { color: #007020; } /* Other */
|
||
code span.pp { color: #bc7a00; } /* Preprocessor */
|
||
code span.sc { color: #4070a0; } /* SpecialChar */
|
||
code span.ss { color: #bb6688; } /* SpecialString */
|
||
code span.st { color: #4070a0; } /* String */
|
||
code span.va { color: #19177c; } /* Variable */
|
||
code span.vs { color: #4070a0; } /* VerbatimString */
|
||
code span.wa { color: #60a0b0; font-weight: bold; font-style: italic; } /* Warning */
|
||
/* CSS for citations */
|
||
div.csl-bib-body { }
|
||
div.csl-entry {
|
||
clear: both;
|
||
}
|
||
.hanging-indent div.csl-entry {
|
||
margin-left:2em;
|
||
text-indent:-2em;
|
||
}
|
||
div.csl-left-margin {
|
||
min-width:2em;
|
||
float:left;
|
||
}
|
||
div.csl-right-inline {
|
||
margin-left:2em;
|
||
padding-left:1em;
|
||
}
|
||
div.csl-indent {
|
||
margin-left: 2em;
|
||
} </style>
|
||
<link rel="stylesheet" href="style.css" />
|
||
<link href="interface.css" rel="stylesheet" type="text/css" />
|
||
<script src="https://unpkg.com/pagedjs/dist/paged.polyfill.js"></script>
|
||
|
||
</head>
|
||
<body>
|
||
<header id="title-block-header">
|
||
<h1 class="title">Citer ses références et créer une bibliographie avec
|
||
LaTeX et Zotero</h1>
|
||
<p class="date">Automne 2024</p>
|
||
<div class="logo">
|
||
<img src="../medias/latex-logo.svg" />
|
||
<img src="../medias/zotero-logo.svg" />
|
||
</div>
|
||
</header>
|
||
<nav id="TOC" role="doc-toc">
|
||
<ul>
|
||
<li><a href="#objectifs" id="toc-objectifs">Objectifs</a></li>
|
||
<li><a href="#first-section" id="toc-first-section">Principes
|
||
généraux</a></li>
|
||
<li><a href="#structure-dune-référence-dans-un-fichier-.bib"
|
||
id="toc-structure-dune-référence-dans-un-fichier-.bib">Structure d’une
|
||
référence dans un fichier <code>.bib</code></a></li>
|
||
<li><a href="#créer-un-fichier-.bib-via-zotero"
|
||
id="toc-créer-un-fichier-.bib-via-zotero">Créer un fichier
|
||
<code>.bib</code> via Zotero</a></li>
|
||
<li><a href="#configurer-la-compilation"
|
||
id="toc-configurer-la-compilation">Configurer la compilation</a></li>
|
||
<li><a href="#utilisation-de-biblatex"
|
||
id="toc-utilisation-de-biblatex">Utilisation de BibLaTeX</a></li>
|
||
<li><a href="#bibliographie"
|
||
id="toc-bibliographie">Bibliographie</a></li>
|
||
</ul>
|
||
</nav>
|
||
<h2 id="objectifs">Objectifs</h2>
|
||
<p>Au terme de cet atelier, vous serez en mesure de :</p>
|
||
<ul>
|
||
<li>Comprendre ce qu’est un fichier <code>.bib</code>.</li>
|
||
<li>Connaître la structure d’une référence.</li>
|
||
<li>Créer ou de générer un fichier <code>.bib</code>.</li>
|
||
<li>Charger les paquets nécessaires dans le préambule pour configurer
|
||
BibLaTeX.</li>
|
||
<li>Utiliser les commandes BibLaTeX pour :
|
||
<ul>
|
||
<li>Définir le style de citation et de bibliographie.</li>
|
||
<li>Insérer une citation et un appel de citation.</li>
|
||
<li>Insérer une bibliographie.</li>
|
||
</ul></li>
|
||
<li>Compiler le document final.</li>
|
||
</ul>
|
||
<div id="licence">
|
||
<p><img src="./static/by-sa.svg"
|
||
alt="Logo de la licence CC BY-SA 4.0" /><br />
|
||
<a href="https://creativecommons.org/licenses/by-sa/4.0/deed.fr"
|
||
title="Texte de la licence en français">CC BY-SA 4.0</a> — <a
|
||
href="https://git.milhit.ch/igor/biblatex-zotero"
|
||
title="Projet git du document">Sources</a></p>
|
||
</div>
|
||
<!-- références -->
|
||
<h2 id="first-section">Principes généraux</h2>
|
||
<blockquote>
|
||
<p>« Dans LaTeX il faut distinguer le langage de balisage, le système de
|
||
composition et la <em>distribution</em>. » <span class="citation"
|
||
data-cites="fauchieFabriquesPublicationLaTeX2020">(<a
|
||
href="#ref-fauchieFabriquesPublicationLaTeX2020"
|
||
role="doc-biblioref">Fauchié 2020</a>)</span></p>
|
||
</blockquote>
|
||
<p>Pour générer des documents avec LaTeX, il faut :</p>
|
||
<ul>
|
||
<li>Rédiger un document dans un fichier <code>.tex</code> à l’aide du
|
||
<em>langage de balisage</em>, afin de le structurer.</li>
|
||
<li>Compiler ce fichier avec un <em>système (ou moteur) de
|
||
composition</em>, par exemple LaTeX, PdfLaTeX ou XeLaTeX.</li>
|
||
</ul>
|
||
<p>Pour disposer d’un tel système de composition, le plus souvent on
|
||
installe un <em>environnement ou une distribution</em> LaTeX, par
|
||
exemple TeX Live pour Linux, MacTex pour Mac OS ou MiKTeX pour Windows<a
|
||
href="#fn1" class="footnote-ref" id="fnref1"
|
||
role="doc-noteref"><sup>1</sup></a>. Il est aussi possible d’installer
|
||
des distributions plus minimales, comme <code>tectonic</code> ou
|
||
TinyTeX<a href="#fn2" class="footnote-ref" id="fnref2"
|
||
role="doc-noteref"><sup>2</sup></a>.</p>
|
||
<p>Afin de faciliter la collaboration ou pour s’éviter une installation
|
||
parfois laborieuse, des services en ligne sont préférés, comme <a
|
||
href="https://www.overleaf.com/"
|
||
class="uri">https://www.overleaf.com/</a>.</p>
|
||
<p>Enfin, un éditeur est nécessaire pour travailler sur les sources (le
|
||
ou les fichiers <code>.tex</code>). N’importe quel éditeur de texte
|
||
suffit, mais des aides comme la coloration syntaxique, la complétion des
|
||
commandes ou la gestion de la compilation autrement que dans une console
|
||
sont très utiles. Parmi une liste plutôt riche, les éditeurs suivants
|
||
peuvent être mentionnés :</p>
|
||
<ul>
|
||
<li>Texmaker, libre, multiplatforme, <a
|
||
href="https://www.xm1math.net/texmaker/"
|
||
class="uri">https://www.xm1math.net/texmaker/</a>.</li>
|
||
<li>TeXworks, libre, multiplatforme, <a
|
||
href="https://www.tug.org/texworks/"
|
||
class="uri">https://www.tug.org/texworks/</a>.</li>
|
||
<li>Visual Studio Code, gratuit, multiplatforme, <a
|
||
href="https://code.visualstudio.com/"
|
||
class="uri">https://code.visualstudio.com/</a>, avec les extensions
|
||
nécessaires.</li>
|
||
</ul>
|
||
<p>Afin de pouvoir insérer des citations et créer des bibliographies
|
||
avec LaTeX, un fichier contenant les références bibliographiques est
|
||
nécessaire. Il s’agit d’un fichier dont l’extension est
|
||
<code>.bib</code>, ce qui correspond :</p>
|
||
<ul>
|
||
<li>soit à la structure BibTeX,</li>
|
||
<li>soit à la structure Biber pour BibLaTeX.</li>
|
||
</ul>
|
||
<p>Ce fichier <code>.bib</code> se place le plus souvent dans le même
|
||
dossier que le document <code>.tex</code> de travail, mais il est
|
||
possible de le placer n’importe où et de préciser le chemin où il se
|
||
trouve.</p>
|
||
<!-- références -->
|
||
<h3 id="bibtex-vs-biblatex">BibTeX VS BibLaTeX</h3>
|
||
<p>BibTex est le logiciel historique pour la gestion des références et
|
||
des bibliographies dans un document <code>.tex</code>. Il est aussi le
|
||
plus souvent mentionné dans les exigences des éditeurs scientifiques.
|
||
Pourtant, ce logiciel n’est plus développé depuis de plusieurs décennies
|
||
et n’offre pas facilement les fonctionnalités auxquelles nous pouvons
|
||
nous attendre actuellement.</p>
|
||
<p>Aussi Biber (et BibLaTeX) est fortement conseillé et c’est pourquoi
|
||
il n’est question que de cette option dans ce document. Il est plus
|
||
récent et évolue encore constamment. En ne chargeant que le paquet
|
||
<code>biblatex</code>, il est possible de définir le type d’appel de
|
||
citation (notes en bas de page, numéro, auteur-date, etc.) et différents
|
||
style de bibliographies.</p>
|
||
<p>Débuter avec BibLaTeX n’empêche pas de passer à BibTeX ensuite, si
|
||
nécessaire.</p>
|
||
<h2 id="structure-dune-référence-dans-un-fichier-.bib">Structure d’une
|
||
référence dans un fichier <code>.bib</code></h2>
|
||
<p>Une référence dans un fichier <code>.bib</code> au format BibLaTeX
|
||
ressemble à cela :</p>
|
||
<div class="sourceCode" id="cb1"><pre
|
||
class="sourceCode bib"><code class="sourceCode bibtex"><span id="cb1-1"><a href="#cb1-1" aria-hidden="true" tabindex="-1"></a><span class="va">@book</span>{<span class="ot">sauvayreMethodesEntretienSciences2013</span>,</span>
|
||
<span id="cb1-2"><a href="#cb1-2" aria-hidden="true" tabindex="-1"></a> <span class="dt">location</span> = {Paris},</span>
|
||
<span id="cb1-3"><a href="#cb1-3" aria-hidden="true" tabindex="-1"></a> <span class="dt">title</span> = {Les méthodes de l'entretien en sciences sociales},</span>
|
||
<span id="cb1-4"><a href="#cb1-4" aria-hidden="true" tabindex="-1"></a> <span class="dt">isbn</span> = {978-2-10-057970-9},</span>
|
||
<span id="cb1-5"><a href="#cb1-5" aria-hidden="true" tabindex="-1"></a> <span class="dt">series</span> = {Psycho sup. Psychologie sociale},</span>
|
||
<span id="cb1-6"><a href="#cb1-6" aria-hidden="true" tabindex="-1"></a> <span class="dt">pagetotal</span> = {138},</span>
|
||
<span id="cb1-7"><a href="#cb1-7" aria-hidden="true" tabindex="-1"></a> <span class="dt">publisher</span> = {Dunod},</span>
|
||
<span id="cb1-8"><a href="#cb1-8" aria-hidden="true" tabindex="-1"></a> <span class="dt">author</span> = {Sauvayre, Romy},</span>
|
||
<span id="cb1-9"><a href="#cb1-9" aria-hidden="true" tabindex="-1"></a> <span class="dt">date</span> = {2013},</span>
|
||
<span id="cb1-10"><a href="#cb1-10" aria-hidden="true" tabindex="-1"></a> <span class="dt">keywords</span> = {Enquêtes sociologiques, Entretiens, Sociologie},</span>
|
||
<span id="cb1-11"><a href="#cb1-11" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div>
|
||
<p>La première ligne définit le type de document, sous la forme
|
||
<code>@type</code> (<code>@book</code>, <code>@article</code>,
|
||
<code>@phdthesis</code>, etc.). Puis, après l’ouverture d’accolade, suit
|
||
la clé de citation (<em>Citekey</em>), c’est-à-dire l’identifiant unique
|
||
de la référence qui sera indiquée dans le document <code>.tex</code>,
|
||
afin d’insérer une référence.<br />
|
||
Les lignes suivantes correspondent aux champs de la référence, sous la
|
||
forme <code>champ = {valeur}</code>, séparés par une virgule.</p>
|
||
<p>La documentation BibLaTeX détaille l’ensemble des types et des champs
|
||
<span class="citation"
|
||
data-cites="lehmanBiblatexPackageProgrammable2023">(<a
|
||
href="#ref-lehmanBiblatexPackageProgrammable2023"
|
||
role="doc-biblioref">Lehman, Kime, Wemheuer 2023, p. 7</a>)</span>. Une
|
||
<em>cheatsheet</em> les liste également <span class="citation"
|
||
data-cites="reesBibLaTeXBiberCheat2017">(voir <a
|
||
href="#ref-reesBibLaTeXBiberCheat2017" role="doc-biblioref">Rees
|
||
2017</a>)</span>.</p>
|
||
<p>Il est possible de créer et de mettre à jour un fichier
|
||
<code>.bib</code> à la main, à l’aide d’un éditeur de texte. Un grand
|
||
nombre de bases de données, de sites de revues ou de catalogues de
|
||
bibliothèques permettent de télécharger une ou plusieurs références dans
|
||
un fichier <code>.bib</code>, mais le plus souvent dans la structure
|
||
BibTeX et non pas BibLaTeX.</p>
|
||
<p>Mais il est recommandé de déléguer la gestion du fichier
|
||
<code>.bib</code> à un logiciel de gestion de références
|
||
bibliographiques, comme JabRef<a href="#fn3" class="footnote-ref"
|
||
id="fnref3" role="doc-noteref"><sup>3</sup></a> ou Zotero<a href="#fn4"
|
||
class="footnote-ref" id="fnref4" role="doc-noteref"><sup>4</sup></a>.
|
||
L’intérêt de ces logiciels est d’éviter les erreurs et d’automatiser en
|
||
partie l’ajout de références dans sa base de données.</p>
|
||
<!-- références -->
|
||
<h2 id="créer-un-fichier-.bib-via-zotero">Créer un fichier
|
||
<code>.bib</code> via Zotero</h2>
|
||
<p>Avec Zotero, il est possible de générer un fichier
|
||
<code>.bib</code> :</p>
|
||
<ul>
|
||
<li>À partir d’une sélection de références.</li>
|
||
<li>En sélectionnant une collection, une sous-collection ou la
|
||
bibliothèque entière.</li>
|
||
</ul>
|
||
<p>Il suffit de :</p>
|
||
<ul>
|
||
<li>Sélectionner l’ensemble désiré.</li>
|
||
<li>Faire un clic-droit et sélectionner <em>Exporter la collection / les
|
||
documents</em>.</li>
|
||
<li>Choisir le format BibTeX ou BibLaTeX.<a href="#fn5"
|
||
class="footnote-ref" id="fnref5"
|
||
role="doc-noteref"><sup>5</sup></a></li>
|
||
</ul>
|
||
<p>Ce procédé très simple a néanmoins un inconvénient : le fichier créé
|
||
est statique. Il ne sera pas mis à jour automatiquement si la collection
|
||
est complétée, ou si les références sont corrigées dans Zotero. Il
|
||
faudra générer à nouveau et écraser le fichier <code>.bib</code> pour
|
||
qu’il soit à jour.</p>
|
||
<h3 id="lextension-better-bibtex-for-zotero">L’extension <em>Better
|
||
BibTeX for Zotero</em></h3>
|
||
<p>L’extension <em>Better BibTeX for Zotero</em> résout deux problèmes
|
||
des fichiers <code>.bib</code> générés par Zotero :</p>
|
||
<ol type="1">
|
||
<li>Elle permet d’exporter <strong>un fichier <code>.bib</code>
|
||
dynamique, c’est-à-dire que le contenu de celui-ci sera mis à jour
|
||
automatiquement lorsque la collection correspondante dans Zotero sera
|
||
modifiée</strong>. Pour cela, il faut choisir le format d’exportation
|
||
<em>Better BibTeX</em> ou <em>Better BibLaTeX</em> et sélectionner
|
||
l’option <em>Garder à jour</em>. (Figure 1)<br />
|
||
</li>
|
||
<li>Elle permet de <strong>modifier une clé de citation (citekey)
|
||
manuellement ou de créer un format de citekey par défaut.</strong></li>
|
||
</ol>
|
||
<figure>
|
||
<img src="../medias/better-bibtex-a-jour.png"
|
||
alt="Fenêtre de dialogue de Better BibTex" />
|
||
<figcaption aria-hidden="true">Fenêtre de dialogue de Better
|
||
BibTex</figcaption>
|
||
</figure>
|
||
<p>Pour installer l’extension (au format <code>.xpi</code>) <em>Better
|
||
BibTeX</em> :</p>
|
||
<ul>
|
||
<li>Se rendre sur <a
|
||
href="https://github.com/retorquere/zotero-better-bibtex/releases/latest"
|
||
class="uri">https://github.com/retorquere/zotero-better-bibtex/releases/latest</a>.</li>
|
||
<li>Télécharger le fichier
|
||
<code>Zotero-better-bibtex-X.X.X.xpi</code>.</li>
|
||
<li>Dans Zotero, choisir le menu <em>Outils / Extensions</em>. (Figure
|
||
2)<br />
|
||
</li>
|
||
<li>Cliquer sur la roue crantée en haut à droite et sélectionner
|
||
<em>Install Add-on from file</em>. (Figure 3)<br />
|
||
</li>
|
||
<li>Sélectionner le fichier téléchargé.</li>
|
||
</ul>
|
||
<figure>
|
||
<img src="../medias/menu-outils.png" alt="Menu « outils » de Zotero" />
|
||
<figcaption aria-hidden="true">Menu « outils » de Zotero</figcaption>
|
||
</figure>
|
||
<figure>
|
||
<img src="../medias/install-add-on.png"
|
||
alt="Installer un fichier .xpi" />
|
||
<figcaption aria-hidden="true">Installer un fichier
|
||
<code>.xpi</code></figcaption>
|
||
</figure>
|
||
<h3 id="autres-fonctionnalités-de-better-bibtex">Autres fonctionnalités
|
||
de Better BibTeX</h3>
|
||
<p><em>Better BibTeX</em> propose des fonctionnalités plus
|
||
avancées :</p>
|
||
<ul>
|
||
<li>Création et gestion de clés uniques.</li>
|
||
<li>Conversion des caractères UTF-8 et des éventuels balisages HTML
|
||
présents dans les références.</li>
|
||
<li>Génération de champs supplémentaires absents de Zotero.</li>
|
||
<li>Création de types de documents n’existant pas dans Zotero.</li>
|
||
</ul>
|
||
<p>Ces fonctionnalités ne seront pas décrites en détail dans ce
|
||
document. Les informations supplémentaires à ce sujet sont disponibles
|
||
sur le site <a href="https://retorque.re/zotero-better-BibTeX/"
|
||
class="uri">https://retorque.re/zotero-better-BibTeX/</a>.</p>
|
||
<h2 id="configurer-la-compilation">Configurer la compilation</h2>
|
||
<p>Pour générer le fichier PDF à partir des sources <code>.tex</code> et
|
||
<code>.bib</code>, il est nécessaire de configurer le système de
|
||
composition que l’on va utiliser. Il peut être appelé en ligne de
|
||
commande dans une console ou, à l’inverse, pris en charge presque
|
||
entièrement par une plateforme comme Overleaf. Et entre les deux, des
|
||
éditeurs de texte dédiés à LaTeX offrent un certain nombre d’options de
|
||
compilation ou de composition.</p>
|
||
<p>L’exemple donné ci-dessous est adapté à l’exercice et à l’utilisation
|
||
de l’éditeur Texmaker, mais le principe est similaire dans les
|
||
différents environnement.</p>
|
||
<p>Dans Texmaker, la fonction pour lancer BibTeX ou Biber est la même.
|
||
Il faut donc lui préciser lequel on utilise :</p>
|
||
<ol type="1">
|
||
<li>Menu Options.</li>
|
||
<li>Configurer Texmaker.</li>
|
||
<li>Dans l’onglet <em>Commandes</em>, chercher l’entrée
|
||
<em>Bib(la)tex</em> et entrer <code>biber %</code>. (Figure 4)<br />
|
||
</li>
|
||
</ol>
|
||
<figure>
|
||
<img src="../medias/texmaker-biber.png"
|
||
alt="Configuer Biber pour BibLaTeX dans Texmaker" />
|
||
<figcaption aria-hidden="true">Configuer Biber pour BibLaTeX dans
|
||
Texmaker</figcaption>
|
||
</figure>
|
||
<p>Lorsque l’on compile avec des références bibliographiques, il est
|
||
nécessaire de le faire quatre fois :</p>
|
||
<ol type="1">
|
||
<li>XeLaTeX.</li>
|
||
<li>Biber.</li>
|
||
<li>XeLaTeX.</li>
|
||
<li>XeLaTeX.</li>
|
||
<li>Afficher le PDF.</li>
|
||
</ol>
|
||
<p>Heureusement Texmaker permet de configure une <em>Compilation
|
||
rapide</em> qui lance automatiquement ces quatre itérations :</p>
|
||
<ol type="1">
|
||
<li>Menu Options.</li>
|
||
<li>Configurer Texmaker.</li>
|
||
<li>Onglet <em>Compil rapide</em>.</li>
|
||
<li>Choisir la suite de commande à lancer.</li>
|
||
</ol>
|
||
<p>Dans le cas de l’exercice présenté, une bonne solution est d’utiliser
|
||
XeLaTeX. Pour cela, il faut choisir l’option <em>Utilisateur</em> et
|
||
utiliser l’assistant.</p>
|
||
<figure>
|
||
<img src="../medias/compil-rapide-assistant.png"
|
||
alt="Assistant de configuration de compil rapide" />
|
||
<figcaption aria-hidden="true">Assistant de configuration de compil
|
||
rapide</figcaption>
|
||
</figure>
|
||
<p>Puis, dans l’assistant, sélectionner les commandes à ajouter, une à
|
||
une, dans l’ordre.</p>
|
||
<figure>
|
||
<img src="../medias/compil-rapide-liste.png"
|
||
alt="Ajout des commandes dans l’assistant" />
|
||
<figcaption aria-hidden="true">Ajout des commandes dans
|
||
l’assistant</figcaption>
|
||
</figure>
|
||
<p>Les services web comme Overleaf ou les outils comme
|
||
<code>tectonic</code><a href="#fn6" class="footnote-ref" id="fnref6"
|
||
role="doc-noteref"><sup>6</sup></a> prennent eux-mêmes en charge ce
|
||
genre de complexité.</p>
|
||
<h2 id="utilisation-de-biblatex">Utilisation de BibLaTeX</h2>
|
||
<h3 id="preambule">Préambule : options de style et lien avec les
|
||
références</h3>
|
||
<p>Voici un exemple de préambule avec le paquet <code>biblatex</code> et
|
||
quelques options :</p>
|
||
<div class="sourceCode" id="cb2"><pre
|
||
class="sourceCode latex"><code class="sourceCode latex"><span id="cb2-1"><a href="#cb2-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>[11pt,a4paper,french]{<span class="ex">article</span>}</span>
|
||
<span id="cb2-2"><a href="#cb2-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">lmodern</span>}</span>
|
||
<span id="cb2-3"><a href="#cb2-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[french]{<span class="ex">babel</span>}</span>
|
||
<span id="cb2-4"><a href="#cb2-4" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[utf8]{<span class="ex">inputenc</span>}</span>
|
||
<span id="cb2-5"><a href="#cb2-5" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[T1]{<span class="ex">fontenc</span>}</span>
|
||
<span id="cb2-6"><a href="#cb2-6" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">hyperref</span>}</span>
|
||
<span id="cb2-7"><a href="#cb2-7" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[style=vancouver,</span>
|
||
<span id="cb2-8"><a href="#cb2-8" aria-hidden="true" tabindex="-1"></a> backend=biber]{<span class="ex">biblatex</span>}</span>
|
||
<span id="cb2-9"><a href="#cb2-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\addbibresource</span>{references-exercice.bib}</span>
|
||
<span id="cb2-10"><a href="#cb2-10" aria-hidden="true" tabindex="-1"></a></span>
|
||
<span id="cb2-11"><a href="#cb2-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\author</span>{Dimitri Donzé, Vincent Hubert, Igor Milhit}</span>
|
||
<span id="cb2-12"><a href="#cb2-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\title</span>{Notre pseudo-article}</span></code></pre></div>
|
||
<p>Le paquet est chargé sous la forme
|
||
<code>\usepackage[options]{biblatex}</code>. Pour les options, il faut
|
||
se référer à la documentation ou à la <em>cheatsheet</em> citées plus
|
||
haut. L’exemple montre les options que vous allez le plus souvent
|
||
utiliser :</p>
|
||
<ul>
|
||
<li><code>backend=biber</code> détermine l’outil de composition, le plus
|
||
souvent Biber pour BibLaTeX. Cela suppose que Biber soit installé sur
|
||
votre machine, par exemple dans la distribution LaTeX que vous avez
|
||
choisie.</li>
|
||
<li><code>style</code> détermine le style dans lequel les références
|
||
seront rédigées.</li>
|
||
</ul>
|
||
<p>Pour plus de finesse, existent les options <code>citestyle</code>
|
||
pour définit le style de citation et <code>bibstyle</code> pour le style
|
||
bibliographique. Le plus souvent l’option <code>style</code> suffit.</p>
|
||
<p>La commande <code>\addbibresource{<nom-du-fichier>.bib}</code>
|
||
permet de définir le fichier contenant les références bibliographiques.
|
||
Le plus simple, est de le placer dans le même répertoire que le fichier
|
||
<code>.tex</code>.</p>
|
||
<h3 id="insérer-des-citations">Insérer des citations</h3>
|
||
<p>Pour insérer des citations, il existe un ensemble de commandes
|
||
possibles (voir la <em>cheatsheet</em>), pour les différents cas. La
|
||
syntaxe est la suivante :</p>
|
||
<div class="sourceCode" id="cb3"><pre
|
||
class="sourceCode latex"><code class="sourceCode latex"><span id="cb3-1"><a href="#cb3-1" aria-hidden="true" tabindex="-1"></a><span class="kw">\cite</span>[<pre>][<post>]{<span class="ex"><key></span>}</span></code></pre></div>
|
||
<ul>
|
||
<li><code>\cite</code> est la commande proprement dite, qui détermine le
|
||
type de citation utilisée.</li>
|
||
<li><code>[<pre>]</code>, optionnel, permet d’ajouter du texte
|
||
avant l’appel à citation. Par exemple <code>[voir]</code> permet
|
||
d’obtenir <code>(voir Auteur, date)</code>.</li>
|
||
<li><code>[<post>]</code>, optionnel, ajoute du texte après
|
||
l’appel à citation, comme un numérotation de pages.</li>
|
||
<li><code>{<key>}</code>, obligatoire, est la clé de citation
|
||
indiquant de quelle référence il s’agit. Par exemple
|
||
<code>{slaweckiParadigmsQualitativeResearch2018}</code>.</li>
|
||
</ul>
|
||
<p>Voici les appels de citation les plus utiles :</p>
|
||
<ul>
|
||
<li><code>\autocite</code> est dépendante du style utilisé, aussi elle
|
||
s’adapte automatiquement au style de citation.</li>
|
||
<li><code>\textcite</code> insère l’appel à citation dans le texte.</li>
|
||
<li><code>\parencite</code> insère l’appel à citation dans des
|
||
parenthèses.</li>
|
||
</ul>
|
||
<p>Ces commandes possèdent des versions pour appeler plusieurs
|
||
références simultanément :
|
||
<code>\autocites{<key1>}{<key2>}</code>.</p>
|
||
<h3 id="créer-une-bibliographie">Créer une bibliographie</h3>
|
||
<p>La commande <code>\printbibliography</code> insère la bibliographie.
|
||
Elle se place généralement à la fin du document, mais ce n’est pas
|
||
obligatoire.</p>
|
||
<p>Elle peut prendre un certain nombre d’options :</p>
|
||
<div class="sourceCode" id="cb4"><pre
|
||
class="sourceCode latex"><code class="sourceCode latex"><span id="cb4-1"><a href="#cb4-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\printbibliography</span>[title=Bibliographie]</span></code></pre></div>
|
||
<p>Cet exemple définit le titre de la bibliographie. Par défaut, le
|
||
titre est <em>Références</em> en français.</p>
|
||
<p>À l’aide de la <em>cheatsheet</em> ou de la documentation il est
|
||
possible de comprendre comment réaliser une bibliographie pour une
|
||
section du document, ou une bibliographie ne contenant que les
|
||
références liées à un mot clé particulier.</p>
|
||
<h3 id="enrichir-biblatex">Enrichir BibLaTeX</h3>
|
||
<p>Dans la bibliographie est indiqué une ressource en ligne qui liste
|
||
des paquets pouvant être installés afin d’enrichir BibLaTeX <span
|
||
class="citation" data-cites="CTANTopicBibLaTeX">(<a
|
||
href="#ref-CTANTopicBibLaTeX" role="doc-biblioref"><em>CTAN: Topic
|
||
BibLaTeX</em> [sans date]</a>)</span>. Dans ces paquets, on trouve par
|
||
exemple des styles bibliographiques. Or, pour les installer, il faut
|
||
savoir dans quel répertoire il faut ajouter les fichiers, si nécessaire.
|
||
Pour cela, une commande peut être tapée dans une console (par exemple
|
||
Powershell pour Windows, iterm pour Mac OS ou votre terminal
|
||
Linux) :</p>
|
||
<div class="sourceCode" id="cb5"><pre
|
||
class="sourceCode bash"><code class="sourceCode bash"><span id="cb5-1"><a href="#cb5-1" aria-hidden="true" tabindex="-1"></a><span class="ex">kpsewhich</span> <span class="at">--var-value</span> TEXMFLOCAL</span>
|
||
<span id="cb5-2"><a href="#cb5-2" aria-hidden="true" tabindex="-1"></a><span class="ex">/usr/local/share/texmf:/usr/share/texmf</span></span></code></pre></div>
|
||
<p>La deuxième ligne est le chemin correspondant à l’installation de
|
||
LaTeX où les répertoires et fichiers peuvent être ajoutés.</p>
|
||
<p>Sous Windows la commande ne prend qu’un tiret pour le paramètre :</p>
|
||
<div class="sourceCode" id="cb6"><pre
|
||
class="sourceCode bash"><code class="sourceCode bash"><span id="cb6-1"><a href="#cb6-1" aria-hidden="true" tabindex="-1"></a><span class="ex">kpsewhich</span> <span class="at">-var-value</span> TEXMFLOCAL</span></code></pre></div>
|
||
<h2 class="unnumbered" id="bibliographie">Bibliographie</h2>
|
||
<div id="refs" class="references csl-bib-body" role="list">
|
||
<div id="ref-BibliographyLaTeXBibtex2021" class="csl-entry"
|
||
role="listitem">
|
||
Bibliography in LaTeX with Bibtex/Biblatex, 2021.
|
||
<em>LaTeX-Tutorial.com</em>. [en ligne]. 19 juillet 2021.
|
||
[Consulté le 23 mars 2023]. Disponible à l'adresse: <a
|
||
href="https://latex-tutorial.com/tutorials/bibtex/">https://latex-tutorial.com/tutorials/bibtex/</a>
|
||
</div>
|
||
<div id="ref-CTANTopicBibLaTeX" class="csl-entry" role="listitem">
|
||
CTAN: Topic BibLaTeX, [sans date]. <em>CTAN: Comprehensive TeX Archive
|
||
Network</em>. [en ligne]. [Consulté le 29 mars 2023]. Disponible à
|
||
l'adresse: <a
|
||
href="https://ctan.org/topic/biblatex">https://ctan.org/topic/biblatex</a>
|
||
</div>
|
||
<div id="ref-fauchieFabriquesPublicationLaTeX2020" class="csl-entry"
|
||
role="listitem">
|
||
FAUCHIÉ, Antoine, 2020. Fabriques de publication : LaTeX.
|
||
<em>quaternum.net</em>. [en ligne]. 29 avril 2020.
|
||
[Consulté le 23 mars 2023]. Disponible à l'adresse: <a
|
||
href="https://www.quaternum.net/2020/04/29/fabriques-de-publication-latex/">https://www.quaternum.net/2020/04/29/fabriques-de-publication-latex/</a>
|
||
</div>
|
||
<div id="ref-grolimundZoteroLaTeX2019" class="csl-entry"
|
||
role="listitem">
|
||
GROLIMUND, Raphaël, 2019. Zotero et LaTeX. <em>Le blog Zotero
|
||
francophone</em>. [en ligne]. 24 septembre 2019.
|
||
[Consulté le 29 mars 2023]. Disponible à l'adresse: <a
|
||
href="https://zotero.hypotheses.org/762">https://zotero.hypotheses.org/762</a>
|
||
</div>
|
||
<div id="ref-lehmanBiblatexPackageProgrammable2023" class="csl-entry"
|
||
role="listitem">
|
||
LEHMAN, Philipp, KIME, Philip et WEMHEUER, Moritz, 2023. <em>The
|
||
biblatex package: programmable bibliographies and citations</em>.
|
||
[en ligne]. 5 mars 2023. Disponible à l'adresse: <a
|
||
href="https://ctan.org/pkg/biblatex">https://ctan.org/pkg/biblatex</a>Version
|
||
3.19
|
||
</div>
|
||
<div id="ref-OverleafDocumentation" class="csl-entry" role="listitem">
|
||
Overleaf documentation, [sans date]. [en ligne].
|
||
[Consulté le 29 mars 2023]. Disponible à l'adresse: <a
|
||
href="https://www.overleaf.com/learn">https://www.overleaf.com/learn</a>
|
||
</div>
|
||
<div id="ref-patashnikBibtexing1988" class="csl-entry" role="listitem">
|
||
PATASHNIK, Oren, 1988. <em>Bibtexing</em>. [en ligne]. 8 février 1988.
|
||
[Consulté le 28 mars 2023]. Disponible à l'adresse: <a
|
||
href="https://ctan.org/pkg/bibtex">https://ctan.org/pkg/bibtex</a>Version
|
||
0.99b
|
||
</div>
|
||
<div id="ref-poulainLaTeXPourEnseignants2020" class="csl-entry"
|
||
role="listitem">
|
||
POULAIN, Nicolas mathématicien, 2020. <em>LaTeX pour les
|
||
enseignants</em>. Paris: Ellipses. Références sciences.
|
||
ISBN 978-2-340-03671-0.
|
||
</div>
|
||
<div id="ref-reesBibLaTeXBiberCheat2017" class="csl-entry"
|
||
role="listitem">
|
||
REES, Clea F., 2017. <em>BibLaTeX/Biber <span>« cheat
|
||
sheet »</span></em>. [en ligne]. 24 juin 2017.
|
||
[Consulté le 23 mars 2023]. Disponible à l'adresse: <a
|
||
href="https://ctan.org/pkg/biblatex-cheatsheet">https://ctan.org/pkg/biblatex-cheatsheet</a>
|
||
</div>
|
||
<div id="ref-rouquetteXeLaTeXApplique2017" class="csl-entry"
|
||
role="listitem">
|
||
ROUQUETTE, Maïeul, 2017. <em>(Xe)LaTeX appliqué aux sciences humaines :
|
||
le seul livre sur LaTeX sans une seule équation !</em> Tampere:
|
||
Atramenta. ISBN 978-952-273-073-2.
|
||
</div>
|
||
<div id="ref-tailletBienDebuterLaTeX2022" class="csl-entry"
|
||
role="listitem">
|
||
TAILLET, Richard, 2022. <em>Bien débuter en LaTeX</em>. Louvain-la-Neue:
|
||
De Boeck Supérieur. Informatique. ISBN 978-2-8073-3989-7.
|
||
</div>
|
||
</div>
|
||
<section id="footnotes" class="footnotes footnotes-end-of-document"
|
||
role="doc-endnotes">
|
||
<hr />
|
||
<ol>
|
||
<li id="fn1"><p>Voir le site <a
|
||
href="https://www.latex-project.org/get/"
|
||
class="uri">https://www.latex-project.org/get/</a>.<a href="#fnref1"
|
||
class="footnote-back" role="doc-backlink">↩︎</a></p></li>
|
||
<li id="fn2"><p>Voir le site <a
|
||
href="https://tectonic-typesetting.github.io"
|
||
class="uri">https://tectonic-typesetting.github.io</a> ou le site <a
|
||
href="https://yihui.org/tinytex/"
|
||
class="uri">https://yihui.org/tinytex/</a>.<a href="#fnref2"
|
||
class="footnote-back" role="doc-backlink">↩︎</a></p></li>
|
||
<li id="fn3"><p>Logiciel multiplatforme et libre, BibTeX et Biber natif.
|
||
<a href="https://www.jabref.org/"
|
||
class="uri">https://www.jabref.org/</a><a href="#fnref3"
|
||
class="footnote-back" role="doc-backlink">↩︎</a></p></li>
|
||
<li id="fn4"><p>Logiciel multiplatforme et libre. <a
|
||
href="https://www.zotero.org/" class="uri">https://www.zotero.org/</a><a
|
||
href="#fnref4" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
|
||
<li id="fn5"><p>Il est également possible d’exporter une bibliothèque au
|
||
format BibTeX depuis d’autres logiciels bibliographiques, notamment
|
||
EndNote. Pour cela, dans ce dernier, il faut aller dans les options de
|
||
styles <em>Tools / Output Styles / Open Style Manager</em> et cocher le
|
||
style <em>BibTeX Export</em>. Une fois cela fait, il faut cliquer sur
|
||
<em>File Export</em>, sélectionner le style <em>BibTeX Export</em> et
|
||
sauvegarder le fichier au format <code>.bib</code>.<a href="#fnref5"
|
||
class="footnote-back" role="doc-backlink">↩︎</a></p></li>
|
||
<li id="fn6"><p>Voir <a href="https://tectonic-typesetting.github.io"
|
||
class="uri">https://tectonic-typesetting.github.io</a>. L’intérêt de
|
||
<code>tectonic</code> est qu’il s’occupe de télécharger à la volée des
|
||
logiciels nécessaires en fonction de ce qui est indiqué dans le
|
||
préambule, ce qui évite d’installer une distribution de LaTeX
|
||
volumineuse. À l’exception de Biber qui doit être installé sur le
|
||
système.<a href="#fnref6" class="footnote-back"
|
||
role="doc-backlink">↩︎</a></p></li>
|
||
</ol>
|
||
</section>
|
||
</body>
|
||
</html>
|