igor
/
biblatex-zotero
1
0
Fork 0
Code Issues Pull Requests Packages Projects Releases 5 Wiki Activity
biblatex-zotero/sources/polycopié/polycopié.html

647 lines
33 KiB
HTML
Raw Normal View History

polycopié: prepare la version d'automne 2024 Co-Authored-by: iGor milhit <igor@milhit.ch>
2024-10-23 16:26:51 +02:00
<!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" />
<meta name="dcterms.date" content="2024-02-29" />
<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">2024-02-29</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 leur fichier <code>.tex</code>
et utiliser les outils de composition pour générer le document
final.</li>
<li>Utiliser les commandes LaTeX pour :
<ul>
<li>Définir leur le style de citation et de bibliographie.</li>
<li>Insérer une citation et un appel de citation.</li>
<li>Créer une bibliographie.</li>
</ul></li>
</ul>
<p> </p>
<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">Fauchié (<a
href="#ref-fauchieFabriquesPublicationLaTeX2020"
role="doc-biblioref">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
langage de balisage, afin de le structurer.</li>
<li>Compiler ce fichier avec un système (ou moteur) de composition, par
exemple LaTeX, PdfLaTeX ou XeLaTeX.</li>
</ul>
<p>Pour disposer d’un tel système de composition, le plus souvent on
installe un environnement ou une distribution 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> De plus en plus souvent, toutefois,
afin de faciliter le travail en 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 de texte est nécessaire pour travailler sur les
sources (le ou les fichiers <code>.tex</code>). N’importe quel éditeur
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.</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 nombreuses
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&#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 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="#fn2" class="footnote-ref"
id="fnref2" role="doc-noteref"><sup>2</sup></a> ou Zotero<a href="#fn3"
class="footnote-ref" id="fnref3" role="doc-noteref"><sup>3</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="#fn4"
class="footnote-ref" id="fnref4"
role="doc-noteref"><sup>4</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>LaTeX.</li>
<li>Biber.</li>
<li>LaTeX.</li>
<li>LaTeX.</li>
<li>Afficher le PDF.</li>
</ol>
<p>Heureusement Texmaker permet de configure une <em>Compilation
rapide</em> qui lance tout seul ces quatre itération :</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" />
<figcaption aria-hidden="true">Ajout des commandes</figcaption>
</figure>
<p>Les outils comme Overleaf ou <code>tectonic</code><a href="#fn5"
class="footnote-ref" id="fnref5" role="doc-noteref"><sup>5</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{&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 d’ajouter du texte
avant l’appel à citation. Par exemple <code>[voir]</code> permet
d’obtenir <code>(voir Auteur, date)</code>.</li>
<li><code>[&lt;post&gt;]</code>, optionnel, ajoute du texte après
l’appel à 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 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{&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 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><span>CTAN</span>: <span>Topic
BibLaTeX</span></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 <span>LaTeX</span> with
<span>Bibtex</span>/<span>Biblatex</span>, 2021. [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">
<span>CTAN</span>: <span>Topic BibLaTeX</span>, [sans date]. [en ligne].
[Consulté le 29 mars 2023]. Disponible à l'adresse: <a
href="https://ctan.org/topic/biblatex">https://ctan.org/topic/biblatex</a>Liste
de paquets pour BibLaTeX.
</div>
<div id="ref-fauchieFabriquesPublicationLaTeX2020" class="csl-entry"
role="listitem">
FAUCHIÉ, Antoine, 2020. Fabriques de publication : LaTeX. [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. [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-LaTeXBibliographiesBiblatex2022" class="csl-entry"
role="listitem">
<span>LaTeX</span>/<span>Bibliographies</span> with Biblatex and Biber,
2022. [en ligne]. 18 octobre 2022. [Consulté le 29 mars 2023].
Disponible à l'adresse: <a
href="https://en.wikibooks.org/wiki/LaTeX/Bibliographies_with_biblatex_and_biber">https://en.wikibooks.org/wiki/LaTeX/Bibliographies_with_biblatex_and_biber</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>
</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>Documentation
officielle de BibTex
</div>
<div id="ref-poulainLaTeXPourEnseignants2020" class="csl-entry"
role="listitem">
POULAIN, Nicolas mathématicien, 2020. <em>LaTeX pour les
enseignants</em>. <span>Paris</span>: <span>Ellipses</span>. 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><span>BibLaTeX</span>/<span>Biber</span>
<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>
<span>Tampere</span>: <span>Atramenta</span>. ISBN 978-952-273-073-2.
Billet de blog de l’auteur présentant le livre
:http://geekographie.maieul.net/Xe-LaTeX-applique-aux-sciences
</div>
<div id="ref-tailletBienDebuterLaTeX2022" class="csl-entry"
role="listitem">
TAILLET, Richard, 2022. <em>Bien débuter en LaTeX</em>.
<span>Louvain-la-Neue</span>: <span>De Boeck Supérieur</span>.
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>Logiciel multiplatforme et libre, BibTeX et Biber natif.
<a href="https://www.jabref.org/"
class="uri">https://www.jabref.org/</a><a href="#fnref2"
class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn3"><p>Logiciel multiplatforme et libre. <a
href="https://www.zotero.org/" class="uri">https://www.zotero.org/</a><a
href="#fnref3" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn4"><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="#fnref4"
class="footnote-back" role="doc-backlink">↩︎</a></p></li>
<li id="fn5"><p>Voir <a href="https://tectonic-typesetting.github.io"
class="uri">https://tectonic-typesetting.github.io</a>. L’intérêt de cet
outil 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. À
l’exception de Biber qui doit être installé sur le système.<a
href="#fnref5" class="footnote-back" role="doc-backlink">↩︎</a></p></li>
</ol>
</section>
</body>
</html>