Generate a bibentry from a Data Catalogue Record

Generate a "TechReport" bibentry object directly from a catalogue record. The primary use of this function is as a helper to create a .bib file for use in reference management software to cite data from the B.C. Data Catalogue. This function is likely to be starting place for this process and manual adjustment will often be needed. The bibentries are not designed to be authoritative and may not reflect all fields required for individual citation requirements.

Usage

bcdc_get_citation(record)

Arguments

record

either a bcdc_record object (from the result of bcdc_get_record()), a character string denoting the name or ID of a resource (or the URL)

It is advised to use the permanent ID for a record rather than the human-readable name to guard against future name changes of the record. If you use the human-readable name a warning will be issued once per session. You can silence these warnings altogether by setting an option: options("silence_named_get_data_warning" = TRUE) - which you can set in your .Rprofile file so the option persists across sessions.

See also

utils::bibentry()

Examples

try(
 bcdc_get_citation("76b1b7a3-2112-4444-857a-afccf7b20da8")
)
#> GeoBC Branch (2024). “BC Airports.” Province of
#> British Columbia, Joy Sinnett & Nancy Liesch. Open
#> Government Licence - British Columbia,
#> <https://catalogue.data.gov.bc.ca/dataset/76b1b7a3-2112-4444-857a-afccf7b20da8>.
#> 
#> A BibTeX entry for LaTeX users is
#> 
#>   @TechReport{,
#>     title = {BC Airports},
#>     author = {{GeoBC Branch}},
#>     address = {Joy Sinnett & Nancy Liesch},
#>     institution = {Province of British Columbia},
#>     year = {2024},
#>     howpublished = {Record accessed 2024-12-12},
#>     url = {https://catalogue.data.gov.bc.ca/dataset/76b1b7a3-2112-4444-857a-afccf7b20da8},
#>     note = {Open Government Licence - British Columbia},
#>   }

## Or directly on a record object
try(
 bcdc_get_citation(bcdc_get_record("76b1b7a3-2112-4444-857a-afccf7b20da8"))
)
#> GeoBC Branch (2024). “BC Airports.” Province of
#> British Columbia, Joy Sinnett & Nancy Liesch. Open
#> Government Licence - British Columbia,
#> <https://catalogue.data.gov.bc.ca/dataset/76b1b7a3-2112-4444-857a-afccf7b20da8>.
#> 
#> A BibTeX entry for LaTeX users is
#> 
#>   @TechReport{,
#>     title = {BC Airports},
#>     author = {{GeoBC Branch}},
#>     address = {Joy Sinnett & Nancy Liesch},
#>     institution = {Province of British Columbia},
#>     year = {2024},
#>     howpublished = {Record accessed 2024-12-12},
#>     url = {https://catalogue.data.gov.bc.ca/dataset/76b1b7a3-2112-4444-857a-afccf7b20da8},
#>     note = {Open Government Licence - British Columbia},
#>   }