biblatex-zotero/sources/polycopié/polycopié.html

652 lines
33 KiB
HTML
Raw Normal View History

<!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 dune
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 quest un fichier <code>.bib</code>.</li>
<li>Connaître la structure dune 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> à laide 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 dun 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 dinstaller
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>). Nimporte 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 sagit dun fichier dont lextension 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 nimporte 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 nest plus développé depuis de plusieurs décennies
et noffre pas facilement les fonctionnalités auxquelles nous pouvons
nous attendre actuellement.</p>
<p>Aussi Biber (et BibLaTeX) est fortement conseillé et cest pourquoi
il nest 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 dappel de
citation (notes en bas de page, numéro, auteur-date, etc.) et différents
style de bibliographies.</p>
<p>Débuter avec BibLaTeX nempêche pas de passer à BibTeX ensuite, si
nécessaire.</p>
<h2 id="structure-dune-référence-dans-un-fichier-.bib">Structure dune
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&#39;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 louverture daccolade, suit
la clé de citation (<em>Citekey</em>), cest-à-dire lidentifiant unique
de la référence qui sera indiquée dans le document <code>.tex</code>,
afin dinsé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 lensemble 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, à laide dun é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>.
Lintérêt de ces logiciels est déviter les erreurs et dautomatiser en
partie lajout 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 dune 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 lensemble 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
quil soit à jour.</p>
<h3 id="lextension-better-bibtex-for-zotero">Lextension <em>Better
BibTeX for Zotero</em></h3>
<p>Lextension <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 dexporter <strong>un fichier <code>.bib</code>
dynamique, cest-à-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 dexportation
<em>Better BibTeX</em> ou <em>Better BibLaTeX</em> et sélectionner
loption <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 lextension (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 nexistant 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 lon va utiliser. Il peut être appelé en ligne de
commande dans une console ou, à linverse, 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 doptions de
compilation ou de composition.</p>
<p>Lexemple donné ci-dessous est adapté à lexercice et à lutilisation
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 longlet <em>Commandes</em>, chercher lentré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 lon 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 lexercice présenté, une bonne solution est dutiliser
XeLaTeX. Pour cela, il faut choisir loption <em>Utilisateur</em> et
utiliser lassistant.</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 lassistant, sélectionner les commandes à ajouter, une à
une, dans lordre.</p>
<figure>
<img src="../medias/compil-rapide-liste.png"
alt="Ajout des commandes dans lassistant" />
<figcaption aria-hidden="true">Ajout des commandes dans
lassistant</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. Lexemple montre les options que vous allez le plus souvent
utiliser:</p>
<ul>
<li><code>backend=biber</code> détermine loutil 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 loption <code>style</code> suffit.</p>
<p>La commande <code>\addbibresource{&lt;nom-du-fichier&gt;.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>[&lt;pre&gt;][&lt;post&gt;]{<span class="ex">&lt;key&gt;</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>[&lt;pre&gt;]</code>, optionnel, permet dajouter du texte
avant lappel à citation. Par exemple <code>[voir]</code> permet
dobtenir <code>(voir Auteur, date)</code>.</li>
<li><code>[&lt;post&gt;]</code>, optionnel, ajoute du texte après
lappel à citation, comme un numérotation de pages.</li>
<li><code>{&lt;key&gt;}</code>, obligatoire, est la clé de citation
indiquant de quelle référence il sagit. 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
sadapte automatiquement au style de citation.</li>
<li><code>\textcite</code> insère lappel à citation dans le texte.</li>
<li><code>\parencite</code> insère lappel à citation dans des
parenthèses.</li>
</ul>
<p>Ces commandes possèdent des versions pour appeler plusieurs
références simultanément:
<code>\autocites{&lt;key1&gt;}{&lt;key2&gt;}</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 nest pas
obligatoire.</p>
<p>Elle peut prendre un certain nombre doptions:</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>À laide 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 denrichir 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 à linstallation de
LaTeX où les répertoires et fichiers peuvent être ajoutés.</p>
<p>Sous Windows la commande ne prend quun 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 dexporter une bibliothèque au
format BibTeX depuis dautres 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>. Lintérêt de
<code>tectonic</code> est quil soccupe 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 dinstaller une distribution de LaTeX
volumineuse. À lexception 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>