cite_r: Cite R and R Packages

In crsh/papaja: Prepare American Psychological Association Journal Articles with R Markdown

Cite R and R Packages

Description

Creates character strings to cite R and R packages.

Usage

cite_r(
  file = NULL,
  prefix = "R-",
  footnote = FALSE,
  pkgs = NULL,
  omit = TRUE,
  ...
)

Arguments

file	Character. Path and name of the .bib-file holding the references. If NULL, only R is cited.
prefix	Character. Prefix used for all R-package reference handles.
footnote	Logical. Indicates if packages should be cited in a footnote. Ignored if no package information is available.
pkgs	Character. Vector of package names to cite or omit depending on omit.
omit	Logical. If TRUE, pkgs constitutes a list of packages not to cite (a blacklist). If FALSE, pkgs constitutes a list of packages to cite (a whitelist).
...	Additional arguments, which are currently ignored.

Details

If footnote = FALSE, a character string citing R and R packages including version numbers is returned. Otherwise a named list with the elements r and pkgs is returned. The former element holds a character string citing R and a reference to a footnote; the latter element contains a character string that creates the footnote. For correct rendering, the footnote string needs to be a separate paragraph in the R Markdown document.

Value

If footnote = FALSE a character string is returned, otherwise a named list with the elements r and pkgs.

See Also

r_refs(), knitr::write_bib()

Examples

cite_r()

crsh/papaja documentation built on Feb. 21, 2024, 6:11 p.m.