© 2025 Tous droits réservés
Dans ce tutoriel, je vais vous guider, pas à pas, pour insérer des citations et générer automatiquement une bibliographie dans un document Quarto. Ce processus est à la fois simple et très pratique. Une fois adopté, vous ne pourrez plus vous en passer
L’idée est d’utiliser l’éditeur visuel de Quarto (accessible via le bouton Visual en haut à gauche de la fenêtre). Cet éditeur offre la possibilité d’accéder à une interface graphique qui permet de rechercher des références bibliographiques, soit dans votre bibliothèque Zotero, si vous en avez une, soit dans des bases de données comme PubMed. Il vous suffira alors de sélectionner les références souhaitées pour les insérer directement dans votre texte. Et le meilleur dans tout ça : la bibliographie se génère automatiquement à la fin de votre document !
Ça semble merveilleux ? Eh bien, ça l’est vraiment ! Ça l’est réellement ! Et pour en tirer tous les avantages, je vous recommande d’utiliser Zotero, un logiciel gratuit de gestion bibliographique.
Zotero vous permet de collecter, organiser et citer facilement des références bibliographiques. Il peut être utilisé à la fois en local, via une application installée sur votre ordinateur (https://www.zotero.org/download/), et en ligne (https://www.zotero.org/).
La version en ligne synchronise vos données sur le cloud, vous offrant ainsi un accès à vos références depuis n’importe quel appareil, et la possibilité de les partager avec d’autres utilisateurs .
Pour rechercher des références directement dans votre bibliothèque Zotero (si vous en avez une), il est nécessaire de l’associer à RStudio. Pour ce faire, rendez-vous dans File > Global Options > R Markdown > Citations.
Vous aurez alors le choix d’utiliser Zotero en local ou en ligne. Si vous optez pour la version locale, il se peut que vous deviez indiquer manuellement le chemin vers l’application, bien que cela se fasse généralement automatiquement.
Personnellement, je choisis l’option web
, car le mode local
ne fonctionne pas toujours de manière fiable (sans que je sache vraiment pourquoi).
Pour utiliser Zotero en ligne (web
), vous devrez fournir une clé API à RStudio. Voici comment l’obtenir :
Rendez-vous sur l’application web de Zotero.
Connectez-vous avec votre identifiant et mot de passe.
Cliquez sur votre nom en haut à droite.
Allez dans Settings > Security.
Dans l’onglet Security, éditez la clé liée à RStudio si elle existe déjà, ou créez-en une nouvelle si nécessaire.
Enfin, copiez-la dans la fenêtre de RStudio :
En haut à droite, cliquez sur le bouton Visual
pour activer l’éditeur visuel de Quarto. Une fois en mode visuel, ouvrez le menu Insert
, puis sélectionnez @ Citation
.
Vous accéderez ainsi à l’interface dédiée à la gestion des citations et des références bibliographiques :
En cliquant sur le bouton plus, vous ajoutez des citations qui seront ensuite insérées dans le texte (à l’endroit où vous aviez positionné le curseur avant de passer en mode Visual).
Dans votre document Quarto, en mode Source, la citation apparaîtra entre crochets, suivie d’un @, du nom de l’auteur et de l’année, comme ceci : [@gomes2022]
Vous pouvez ensuite ajouter du texte devant, comme dans l’exemple suivant :
Voici ce que vous obtiendrez dan le document rendu :
Par défaut, la citation sera cliquable. Si vous préférez désactiver cette fonctionnalité, ajoutez la méta donnée link-citations: false
dans l’entête YAML, sous le format de sortie souhaité, comme ceci :
Voici la fin du document rendu de mon exemple :
Si vous souhaitez remplacer le titre “References” par “Références bibliographiques”, par exemple, il vous suffit d’ajouter un titre de niveau 1 (ou un autre niveau) à la fin du document. Si vous ne voulez pas que ce titre soit numéroté, ajoutez la balise {-}
juste après, comme ceci :
Voici le rendu :
Lorsque vous insérez une citation, RStudio effectue plusieurs actions.
Tout d’abord, il crée un fichier references.bib
dans le dossier contenant votre script Quarto (.qmd), qui inclut les références des documents cités. Par exemple, si votre fichier Quarto est à la racine du projet, le fichier references.bib
sera également créé à la racine. Si votre script se trouve dans un dossier “scripts”, alors le fichier references.bib
sera ajouté dans ce même dossier.
Voici ce que ce fichier contient :
Ensuite, RStudio spécifie ce fichier references.bib
dans l’entête YAML du document Quarto, au niveau de la métadonnée bibliography
:
Remarque : Si vous déplacez le fichier references.bib
dans un autre dossier, vous devrez spécifier son chemin d’accès dans l’en-tête YAML.
Par exemple, si vous créez un dossier “biblio” à la racine du projet et que vous y déplacez le fichier references.bib
, vous devrez alors indiquer dans l’en-tête : bibliography: biblio/references.bib
.
Par défaut, Pandoc utilise le style Chicago Manual of Style
, mais il est très facile de le changer.
Pour cela :
.csl
correspondant (attention, il se télécharge dans le dossier “styles” du répertoire Zotero sur votre ordinateur).csl
, comme ceci :Render
) et observez les modifications de style de la bibliographie.Cet article complète celui consacré aux légendes et renvois dans Quarto, en abordant cette fois la gestion des citations et références bibliographiques. L’intégration de Zotero dans RStudio permet de fluidifier le travail de rédaction scientifique en automatisant la gestion des sources, ce qui rend l’ensemble du processus à la fois rapide et efficace.
N’hésitez pas à partager vos propres expériences ou astuces en commentaires, cela enrichira la discussion et bénéficiera à l’ensemble de la communauté.
Retrouvez le programme de ma formation d’initiation à Quarto ainsi que le planning des prochaines session en cliquant ici
C’est possible en faisant un don sur la page Tipeee du blog
© 2025 Tous droits réservés
Enregistrez vous pour recevoir gratuitement mes fiches « aide mémoire » (ou cheat sheets) qui vous permettront de réaliser facilement les principales analyses biostatistiques avec le logiciel R et pour être informés des mises à jour du site.
2 réponses
Bonjour,
je ne comprends pas pour l’etape 2 , ou est ce que je trouve le bouton « visual »? sur Zotero online? sur R ?
Merci
Bonjour Camille,
Le mode Visual est sur RStudio.