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

17 KiB
Raw Blame History

title date creation_date id authors bibliography
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

Table des matières

  1. Objectifs.
  2. Principes généraux : citer ses sources et créer une bibliographie avec LaTeX.
  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 BibTeX (avec package natbib).
  7. Le format BibLaTeX.
  8. 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.

Principes généraux : citer ses sources et créer une bibliographie avec LaTeX

{width="2.1041666666666665in" height="1.1770833333333333in"}

La citation de références et la création de bibliographie dans un fichier LaTeX se font à l'aide d'un fichier aux formats BibTeX ou BibLaTeX (les deux ont l'extension .bib) qui contient les références que l'on souhaite citer. Ce fichier .bib, que l'on va « appeler » à chaque fois que l'on cite une référence, est sauvegardé dans le même dossier que le fichier LaTeX utilisé. Ainsi, le dossier doit, au minimum, comporter ces deux fichiers (d'autres éléments s'y ajouteront éventuellement) :

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

{width="3.5819444444444444in" height="1.8784722222222223in"}Les références dans le fichier .bib ressemblent à cela :

http://aispiration.com/ingest-data/ingest-BibTeX.html

La première ligne correspond au type de document dont il s'agit (@book, @article, @phdthesis, etc.) accompagné de la clé de citation (Citekey), c'est-à-dire l'identifiant unique de la référence qui sera appelé dans le fichier LaTeX lorsque l'on désirera citer cette référence.

Les lignes suivantes correspondent aux champs d'information de la référence. On y trouve notamment le champs title, author, journal, volume (volume d'une revue), number (info additionnelle, p.ex. issue numéro d'une revue), pages, date, etc.

La présence de ces champs d'information dépend à la fois de la complétion de la référence à l'origine ainsi que du format du fichier .bib. En effet, le format BibLaTeX permet d'ajouter des champs d'information supplémentaires (notamment concernant les données) par rapport à BibTeX. Pour autant, les deux formats comprennent les champs principaux d'une référence bibliographique.

Il est possible de créer et de mettre à jour un fichier .bib à la main. Pour cela, il faut télécharger une référence au format .bib depuis le web. De nombreuses bases de données telles que Web of Science, PubMed ou Google Scholar le permettent. Il suffit alors de copier le contenu de ce fichier .bib dans votre bibliothèque .bib stockée dans le dossier du fichier LaTeX.

Cette manière de gérer sa bibliothèque est longue et fastidieuse. Passé quelques références dans le fichier, il est nécessaire d'utiliser un logiciel de gestion des références pour créer un fichier .bib.

Créer un fichier .bib via Zotero1

Pour créer un fichier .bib depuis Zotero il suffit de sélectionner les références ou une collection entière et faire un clic-droit Exporter la collection / les documents choisir le format BibTeX ou BibLaTeX. 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 dans Zotero. Il faudra recréer et écraser le fichier .bib pour qu'il soit à jour.

Créer un fichier .bib via Better BibTeX for Zotero

L'add-on Better BibTeX résout deux problèmes liés aux fichiers .bib :

  • {width="2.6381944444444443in" height="1.7993055555555555in"}Premièrement, il permet de sauvegarder 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.

  • Deuxièmement, Better BibTeX permet de modifier une clé de citation (citekey) manuellement ou de créer un format de citekey par défaut.

{width="4.865972222222222in" height="1.3840277777777779in"}{width="4.865972222222222in" height="1.3840277777777779in"}L'extension (au format .xpi) Better BibTeX peut être téléchargée à l'adresse : https://retorque.re/zotero-better-BibTeX/. Pour l'installer, depuis Zotero, cliquer sur Outils Extensions Route crantée en haut à droite Install Add-on from file sélectionnerz le fichier téléchargé*.*

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 :

Le format BibTeX (avec package natbib)

Le format BibTeX est le format traditionnel servant à gérer les bibliothèques bibliographiques dans LaTeX. BibTeX datant de 1985, son format est parfois daté, d'autant plus qu'il n'est plus vraiment mis à jour. Ainsi, les fichiers BibTeX manquent de champs d'information pertinents pour certains types de documents. Pour autant, sa stabilité et sa large diffusion le rend toujours intéressant, notamment dans l'optique de la publication du document chez un éditeur scientifique. En effet, BibTeX est plus largement répandu, et donc accepté, que son alter-ego BibLaTeX.

Package natbib

Le fichier BibTeX est généralement associé au package natbib. Celui-ci n'est pas obligatoire mais il propose de nombreuses options supplémentaires, nécessaires selon les besoins en matière de citation. natbib définira quelles commandes pourront être utilisées pour personnaliser et citer les citations et la bibliographie. Il faut donc utiliser la commande ci-dessous au début du document LaTeX :

  • \usepackage[backend=bibtex]{natbib}

Moteur de compilation bibtex

{width="5.946527777777778in" height="1.7236111111111112in"}{width="5.946527777777778in" height="1.7236111111111112in"}Le format BibTeX et le package natbib se compilent via le moteur bibtex. Il peut être appelé au lancement de la commande du pack natbib comme ci-dessus, ou être choisi par défaut comme moteur de compilation dans les paramètres de la suite LaTeX :

Définir un style de bibliographie et de citation

Commande pour choisir un style de bibliographie :

  • \bibliographystyle{nomdustyle}

Pour définir un style bibliographique, se référer à la fiche de synthèse.

Par défaut, le style de citation est similaire au style pour la bibliographie. Il est néanmoins possible d'en paramétrer un soi-même via une commande telle que celle-ci :

  • \setcitestyle {authoryear,open={((},close={))}}

dans laquelle il faut définir manuellement la forme de citation, les parenthèses utilisées, etc. (voir feuille annexe).

Créer une bibliographie

  • \bibliography{nomdufichier}

Cette dernière commande créera la bibliographie à l'endroit choisi dans le document LaTeX. Elle se situera donc plutôt à la fin de celui-ci. De plus, elle sert également à appeler le fichier .bib correspondant. Ainsi, contrairement aux commandes BibLaTeX, il n'y a pas besoin d'une commande propre à l'appel du fichier bibliographique.

Citer une référence

Il existe de nombreuses commandes pour citer une référence, permettant de les adapter à ses besoins. En voici quelques exemples :

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

  • \citet{citekey} citation dans le texte (pour une paraphrase p. ex.) : Smith et al. (1990)

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

  • \nocite{citekey} citation non visible afin d'ajouter une référence automatiquement dans la bibliographie

Résumé des commandes de base pour natbib

Adapté de : https://tex.stackexchange.com/questions/5091/what-to-do-to-switch-to-BibLaTeX

Le format BibLaTeX

BibLaTeX est un format de fichier plus récent et plus complet que BibTeX. Les champs d'information sont possiblement plus complets et il est possible d'en ajouter des personnalisés. Cependant, ce format étant plus récent, il est moins universellement accepté par les éditeurs. Il faut donc se renseigner auprès de ceux-ci si nécessaire.

Package BibLaTeX

Le fichier BibLaTeX est généralement associé au package biblatex. Celui-ci définira quelles commandes pourront être utilisées pour personnaliser et citer les citations et la bibliographie. Il faut donc utiliser la commande ci-dessous au début de votre document LaTeX :

  • \usepackage[backend=biber]{biblatex}

Moteur de compilation Biber

{width="6.060416666666667in" height="1.7395833333333333in"}{width="6.060416666666667in" height="1.7395833333333333in"}Le format BibLaTeX et le package biblatex se compilent via le moteur biber qui peut être appelé avec le pack natbib comme ci-dessus, ou être choisi par défaut comme moteur de compilation dans les paramètres de la suite LaTeX :

Sélectionner le fichier .bib

Contrairement aux commandes natbib, il est nécessaire avec biblatex d'ajouter une commande précisant quel est le fichier .bib à utiliser pour citer les références :

  • \addbibresource{nomdufichier.bib}

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

  1. 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. ↩︎