add_citation: Create a CITATION file

In rcompendium: Create a Package or Research Compendium Structure

Create a CITATION file

Description

This function creates a CITATION file in the folder ⁠inst/⁠. This file contains a BiBTeX entry to cite the package as a manual. User will need to edit by hand some information (title, version, etc.).

Usage

add_citation(
  given = NULL,
  family = NULL,
  organisation = NULL,
  open = TRUE,
  overwrite = FALSE,
  quiet = FALSE
)

Arguments

given	A character of length 1. The given name of the project maintainer.
family	A character of length 1. The family name of the project maintainer.
organisation	A character of length 1. The name of the GitHub organisation to host the package. If NULL (default) the GitHub account will be used. This argument is used to set the URL of the package (hosted on GitHub).
open	A logical value. If TRUE (default) the file is opened in the editor.
overwrite	A logical value. If this file is already present and overwrite = TRUE, it will be erased and replaced. Default is FALSE.
quiet	A logical value. If TRUE messages are deleted. Default is FALSE.

Value

No return value.

See Also

Other create files: add_code_of_conduct(), add_compendium(), add_contributing(), add_description(), add_dockerfile(), add_license(), add_makefile(), add_package_doc(), add_readme_rmd(), add_renv(), add_testthat(), add_vignette()

Examples

## Not run: 
add_citation()
readCitationFile("inst/CITATION")
citation("pkg")    # If you have installed your package <pkg>

## End(Not run)

rcompendium documentation built on Sept. 9, 2025, 5:29 p.m.