The goal of grateful is to make it very easy to cite the R packages used in any report or publication. By calling a single function, it will scan the project for R packages used, and generate a document with citations in the desired output format (Word, PDF, HTML, Markdown). Importantly, these references can be formatted for a specific journal so that we can just paste them directly into the bibliography of our manuscript or report.
library(devtools)
install_github("Pakillo/grateful")Imagine a project where we are using the following packages: readr, dplyr, vegan, lme4, and ggplot2. Calling cite_packages will scan the project, find these packages, and generate a document with formatted citations.
library(grateful)
cite_packages()
This document can also be a Word document, or PDF, or markdown. And use the citation style of a particular journal:
cite_packages(style = "ecology", out.format = "docx")cite_packages is a wrapper function which internally performs the following steps:
1 Scan the project for packages
pkgs <- scan_packages()2 Get citations for each package
cites <- get_citations(pkgs)3 Create an rmarkdown document citing all these packages
rmd <- create_rmd(cites)4 Rendering the rmarkdown document to the desired output format
render_citations(rmd, output = "html")