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

14 KiB
Raw Blame History

title date creation_date id authors bibliography link-citations
Citer ses références et créer une bibliographie avec \LaTeX 2023-03-30 2023-03-24T08:25:47+01:00 20230324082557
Dimitri Donzé
Vincent Huber
Igor Milhit
references.bib true

Table des matières

  1. Objectifs.
  2. Principes généraux.
    1. BibTeX VS BibLaTeX
  3. Structure d'une référence dans un fichier .bib.
  4. Créer un fichier .bib via Zotero.
  5. Différences entre le format BibTeX et BibLaTeX.
  6. Le format BibLaTeX.
  7. Documentation.

Objectifs

Au terme de cet atelier, vous serez en mesure de :

  • Comprendre ce qu'est un fichier .bib.
  • Connaître la structure d'une référence.
  • Créer ou de générer un fichier .bib.
  • Charger les paquets nécessaires dans leur fichier .tex et utiliser les outils de composition pour générer le document final.
  • Utiliser les commandes \LaTeX pour :
    • Définir leur le style de citation et de bibliographie.
    • Insérer une citation et un appel de citation.
    • Créer une bibliographie.

Logo de la licence CC BY-SA 4.0
Ce document est sous licence CC BY-SA 4.0.

\newpage

Principes généraux

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 .bib, ce qui correspond :

  • soit selon la structure BibTeX,
  • soit selon la structure Biber pour BibLaTeX.

Ce fichier .bib se place le plus souvent dans le même dossier que le document .tex de travail.

BibTeX VS BibLaTeX

BibTex est le logiciel historique pour la gestion des références et des bibliographies dans un document .tex. Il est aussi le plus répandu dans les exigences des éditeurs scientifiques. Pourtant, ce logiciel n'est plus développé depuis de nombreuses décennies et n'offre pas les fonctionnalités auxquelles nous pouvons nous attendre actuellement, ou seulement avec difficulté.

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 biblatex, 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.

Débuter avec BibLaTeX n'empêche pas de passer à BibTeX ensuite, si nécessaire.

Structure d'une référence dans un fichier .bib

Une référence dans un fichier .bib au format BibLaTeX ressemble à cela :

@book{sauvayreMethodesEntretienSciences2013,
  location = {Paris},
  title = {Les méthodes de l'entretien en sciences sociales},
  isbn = {978-2-10-057970-9},
  series = {Psycho sup. Psychologie sociale},
  pagetotal = {138},
  publisher = {Dunod},
  author = {Sauvayre, Romy},
  date = {2013},
  note = {Book Title: Les méthodes de l'entretien en sciences sociales},
  keywords = {Enquêtes sociologiques, Entretiens, Sociologie},
}

La première ligne définit le type de document, sous la forme @type (@book, @article, @phdthesis, etc.). Puis, après l'ouverture d'accolade, suit la clé de citation (Citekey), c'est-à-dire l'identifiant unique de la référence qui sera indiquée dans le document .tex, afin d'insérer une référence.
Les lignes suivantes correspondent aux champs de la référence, sous la forme champ = {valeur}, séparés par une virgule.

La documentation BibLaTeX détaille l'ensemble des types et des champs [@lehmanBiblatexPackageProgrammable2023, p. 7].

Il est possible de créer et de mettre à jour un fichier .bib à 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 .bib, mais le plus souvent dans la structure BibTeX et non pas BibLaTeX.

Mais il est bien plus facile de déléguer la gestion du fichier .bib à un logiciel de gestion de références bibliographiques, comme [JabRef]1 ou [Zotero][]. 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.

Créer un fichier .bib via Zotero

Avec Zotero, il est possible de générer un fichier .bib :

  • À partir d'une sélection de références.
  • En sélection une collection, une sous-collection ou la bibliothèque entière.

Il suffit de :

  • Sélectionner l'ensemble désiré.
  • Faire un clic-droit et sélectionner Exporter la collection / les documents.
  • Choisir le format BibTeX ou BibLaTeX.2

Ce procédé très simple a néanmoins un inconvénient, qui est que le fichier créé est statique, c'est-à-dire qu'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 .bib pour qu'il soit à jour.

L'extension Better BibTeX for Zotero

L'extension Better BibTeX for Zotero résout deux problèmes des fichiers .bib générés par Zotero :

  1. Elle permet d'exporter un fichier .bib dynamique, c'est-à-dire que le contenu de celui-ci sera mis à jour automatiquement lorsque la collection correspondante dans Zotero sera modifiée. Pour cela, il faut choisir le format d'exportation Better BibTeX ou Better BibLaTeX et sélectionner l'option Garder à jour.
    Dialogue Better BibTex
  2. Elle permet de modifier une clé de citation (citekey) manuellement ou de créer un format de citekey par défaut.

Pour installer l'extension (au format .xpi) Better BibTeX :

Autres fonctionnalités de Better BibTeX

Better BibTeX propose des fonctionnalités plus avancées :

  • Création et gestion de clés uniques.
  • Conversion des caractères UTF-8 et des éventuels balisages HTML présents dans les références.
  • Génération de champs supplémentaires absents de Zotero.
  • Création de types de documents n'existant pas dans Zotero.

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 https://retorque.re/zotero-better-BibTeX/.

Différences entre le format BibTeX et BibLaTeX

{width="7.095138888888889in" height="5.945833333333334in"}

{width="1.1079965004374452in" height="0.3184951881014873in"}

Un fichier bibliographique .bib peut être créé dans deux formats : BibTeX ou BibLaTeX. Il est important de choisir le bon type de format dès le départ car chacun d'eux aura ses avantages et inconvénients et devra être utilisé avec des packages et des moteurs de compilation propre à chacun. Voici ci-dessous, en résumé, le processus pour chacun d'eux :

Préambule

Voici un exemple de préambule avec le paquet biblatex et quelques options :

\documentclass[11pt,a4paper]{article}
\usepackage{lmodern}
\usepackage[french]{babel}
\usepackage[utf8]{inputenc}
\usepackage[T1]{fontenc}
\usepackage{hyperref}
\usepackage[citestyle=numeric,
            style=vancouver,
            backend=biber]{biblatex}
\addbibresource{references-exercice.bib}

\author{Dimitri Donzé, Vincent Hubert, Igor Milhit}
\title{Notre pseudo-article}

Le paquet est chargé sous la forme \usepackage[options]{biblatex}. Pour les options, il faut se référer à la documentation (@lehmanBiblatexPackageProgrammable2023) ou à la cheatsheet (@reesBibLaTeXBiberCheat2017). L'exemple montre les options que vous allez le plus souvent utiliser :

  • backend=biber 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.
  • citestyle définit le style d'appel à citation et comment la bibliographie est ordonnée.
  • style détermine le style dans lequel les références seront rédigées.

La commande \addbibresource{<nom-du-fichier>.bib} 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 .tex.

Choisir un style bibliographique et de citation

Le choix du style de bibliographie et/ou de citation se fait en ajoutant des options lors de la commande du package, p.ex :

  • \usepackage[backend=biber,[style=apa]{.underline}]{biblatex} où le style général choisi est apa.

Il est également possible de spécifier des styles différents pour la bibliographie et pour les citations :

  • \usepackage[backend=biber, [bibstyle=alphabetic, citestyle=authoryear]{.underline}] {biblatex}

où le style bibliographique est bibliographic et le style de citation authoryear

Citer une référence

Comme pour les commandes natbib, BibTeX propose de nombreuses formes de citation de références (voir feuilles annexes). En voici quelques exemples :

  • \cite{citekey} citation par défaut selon le style pour un style numérique notamment

  • \parencite{citekey} citation entre parenthèses : (Smith et al., 1990)

  • \textcite citation dans le texte (pour une paraphrase p.ex.) : Smith et al. (1990)

  • \footcite{citekey} référence en pieds de page abrégée

  • \footfullcite{citekey} référence en pieds de page complète

Créer la bibliographie

Enfin, la création de la bibliographie à la fin du document se fait avec la commande :

  • \printbibliography

Résumé des commandes de base pour BibLaTeX

Documentation

Bibliographies avec LaTeX en général

Bibliographies avec BibLaTeX

Bibliographies avec BibTeX et natbib

En savoir plus sur Better BibTeX

Ouvrages cités

  1. Logiciel multiplatforme et libre, BibTeX et Biber natif. https://www.jabref.org/ ↩︎

  2. 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 Tools / Output Styles / Open Style Manager et cocher le style BibTeX Export. Une fois cela fait, il faut cliquer sur File Export, sélectionner le style BibTeX Export et sauvegarder le fichier au format .bib. ↩︎