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>
|