Comment insérer des références bibliographiques dans un document Rmarkdown ?

bibliographie, rstudio, rmarkdown

Rédiger ses documents (Manuscript de thèse, rapport de stage, rapport d’analyses statistiques, article de blog, etc..) en Rmarkdown sous R Studio pésente de nombreux avantages. Cela permet, notamment :

  • de générer les documents sous différents formats : html, docx, pdf , sans voir à tout refaire, même pas des copier coller !
  • permet d’utiliser le versionnage avec git : donc plus besoin de faire de multiples versions du documents au cours de sa rédaction (seulement des commits).
    De son coté Mendeley est extrêmement pratique, et performant pour la gestion de références bibliographiques. Ce logiciel gratuit permet entre autre :

  • d’importer directement des références bibliographiques à partir du web

  • de gérer ses références bibliographiques
  • de générer des citations et des bibliographie directement dans des traitements de texte mais aussi dans des documents Rmarkdown.

 

Le couplage Rmarkdown-Mendeley est donc extrêmement intéressant, puisqu’il va nous permettre de générer des citations et une bibliographie de façon automatique dans un document Rmarkdown. Et en plus c’est très simple.

Au pire, ça va vous prendre 5 min !

Je vous montre comment faire.

1 Consitutuez votre bibliographie dans Mendeley

Si vous n’utilisez pas encore ce logiciel, faites en l’une de vos bonne résolutions pour 2018, et lisez ce mode d’emploi extrêmement bien fait, rédigé par la Bibliothèque universitaire de Lyon 1.

Mendeley se télécharge ici

Ensuite, créer votre bibliographie, comme expliqué ci dessous.

1.1 Les références bibliographiques classiques (articles, livres, etc..)

Vous pouvez importer directement des références depuis internet, enutilisant l’outil de recherche de Mendeley. Vous pouvez aussi le faire à partir de pubmed en utilisant un pluggin Mendeley web importer qui se place sur votre navigateur. Vous pouvez encore importer des références à partir d’un pdf.

Tout cela est extrêmement bien expliqué dans le mode d’emploi de Mendeley.

1.2 Les références bibliographiques des packages R

Si vous souhaitez inclure une référence bibliographique relative à un package R, pas de panique, vous n’allez pas la rentrer à la main dans Mendeley !

Ouvrez une session R, charger le package en question avec la fonctionlibrary() et utilisez la fonction citation().

Ici un exemple avec le package drc développé par mon collègue danois
Christian Ritz.

Ensuite ouvrez un document texte, à partir de RStudio ou en utilisant le bloc note, puis copiez coller la sortie que vous venez d’obtenir, depuis @Article{ , jusqu’à la fermeture de l’accolade.

Nommez ce document de façon intelligible (Ref_supper_rapport par exemple), puis enregistrer le au format .bib, sur le bureau ou ailleurs.

Aller ensuite dans Mendeley –> File –> Add file, et choisissez votre document.

Et voila, la référence est importée dans Mendeley.

1.3 Créer un dossier Mendeley spécifique à votre document

Vous allez créer, sous Mendeley, un dossier spécifique qui contiendra toutes les références bibliographiques que vous souhaitez utiliser dans le document que vous êtes en train de rédiger.

Pour cela, aller dans Mendeley –> Edit –> New Folder. Nommez le de façon intelligible. Ensuite, à partir du dossier All document faites glisser les références vers votre nouveau dossier.

2) Exporter les références bibliographiques du nouveau dossier

Il s’agit d’exporter, dans un fichier.bib les références bibliographiques qui nous intéresse. Et de le placer dans le working directory du document Rmarkdown en cours de rédaction.

Pour exporter vos références bibliographiques, allez dans le dossier que vous avez créé dans Mendeley –> CTRL + A –> File –> Exportez.

Donnez un nom intelligible à ce fichier .bib et sauvegarder le dans le working directory relatif au document Rmarkdown que vous êtes en train de rédiger. Pour plus de détails sur la notion de working directory, vous pouvez consulter le chapitre Organisez votre espace de travail sous la forme d’un projet R de cet article

 

3) Compléter votre document Rmarkdown

3.1 Le fichier bib

Ouvrez votre document Rmarkdown sous R Studio et ajouter la ligne bibliography: Le_nom_de_mon_fichier.bib dans la partie YAML du document.

biblio yaml Rstudio Rmarkdown

 

3.2 Les citations

Pour citer une référence bibliographique, utilisez la synthaxe [@Citation Key] visible dans la partie Details (fenêtre de droite) de Mendeley.

Par exemple, pour la référence du package drc, lorsque je clique dessus dans Mendeley une fenêtre Details s’ouvre à droite. Dans cette fenêtre, il y a une section Citation Key avec la mention
“Ritz2015”.

bibliographie Mendeley

 

Lorsque je veux citer cette référence il suffit d’écrire [@Ritz2015],comme cela :

Citation rmarkdown

 

Ce qui donne ensuite, lorsque je transforme mon document Rmarkdown en html, par exemple, avec knitr:

Rmarkdown

 

3.3 Les références bibliographiques

La bibliographie sers automatiquement insérée à la fin du document. Il suffit donc de rajouter un titre ‘References’ à votre document, comme ceci, avec un autre exemple :

bibliographie R markdown

 

Ce qui devient ensuite :

Rmarkdown

 

Pour aller plus loin

Il existe d’autres possibilité de citations, et d’autres styles sont possibles. Pour plus d’infos, consultez la page d’aide sur le site de R studio dédié à Rmarkdown

 

J’espère que cet article vous aidera à rédiger de façon encore plus efficace vos document sur Rmarkdown.

Si vous avez d’autres astuces, indiquez les moi en commentaire.

Et si vous cet article vous a plu, partagez le !

Crédit photo : Peta Hopkins

Partager l'article
  •  
  •  
  •  
  •  
  •  
    1
    Partage
  • 1
  •  
  •  
  •  
  •  

2 commentaires

Laisser un commentaire

Votre adresse de messagerie ne sera pas publiée. Les champs obligatoires sont indiqués avec *