dataset (version 0.4.1)

bibrecord: Create a Modern Metadata Object Compatible with bibentry

Description

Constructs a utils::bibentry() object extended with Dublin Core and DataCite-compatible fields. This unified structure supports use with functions such as dublincore() and datacite(), and is the internal format for storing rich metadata with datasets.

Usage

bibrecord(
  title,
  author,
  contributor = NULL,
  publisher = NULL,
  year = NULL,
  date = Sys.Date(),
  identifier = NULL,
  subject = NULL,
  ...
)

Value

An object of class "bibrecord" and "bibentry", suitable for citation and embedding in metadata-aware structures such as dataset_df().

Arguments

title

A character string specifying the dataset title.

author

A utils::person() or list/vector of person objects. Mapped to creator in DataCite and DCMI.

contributor

Optional list or vector of utils::person() objects. Contributor roles are merged if duplicated.

publisher

A character string or utils::person() representing the publishing entity.

year

Publication year. Automatically derived from date if not provided explicitly.

date

A Date object or character string in ISO format.

identifier

A persistent identifier (e.g., DOI or URL).

subject

Optional keyword, tag, or controlled vocabulary term.

...

Additional fields such as language, format, rights, or description.

See Also

Learn more in the vignette: bibrecord

Other bibrecord functions: as_datacite(), as_dublincore()

Examples

bibrecord(
  title = "Gross domestic product, volumes",
  author = person("Eurosat"),
  publisher = person("Eurostat"),
  identifier = "https://doi.org/10.2908/TEINA011",
  date = as.Date("2025-05-20")
)