#' Bibliographic Records for INLPO Publications
#'
#' @description Bibliographic information for reports, articles, maps, and theses
#'   related to scientific monitoring and research conducted by the U.S. Geological
#'   Survey (USGS), Idaho Water Science Center, Idaho National Laboratory Project
#'   Office (INLPO).
#'
#' @format An object of class 'pub' that inherits from the 'data.frame' class and
#'   includes the following columns:
#'   \describe{
#'     \item{`pub_id`}{Unique identifier for the publication (the table's primary
#'       key), in upper camel case (for example, `"FisherOthers2012"`).}
#'     \item{`institution`}{Name of the institution that published and/or sponsored
#'       the report.}
#'     \item{`type`}{Type of publication, such as `"Open-File Report"`,
#'       `"Data Series"`, or `"Manual"`.}
#'     \item{`text_ref`}{Text reference (the in-text citation) excluding the year of
#'       publication, such as `"Dietz"` or `"Treinen and others"`.}
#'     \item{`year`}{Year of publication.}
#'     \item{`author_id`}{A named list of character vectors giving the identifier(s)
#'       of the contributing author(s), in author order; each value is a foreign key
#'       referencing the `author_id` primary key of the [`authors`] table. List names
#'       match `pub_id`.}
#'     \item{`title`}{Title of publication.}
#'     \item{`bibentry`}{A named list of [bibentry][utils::bibentry] objects holding
#'       the full bibliographic record, from which formatted citations and BibTeX
#'       entries are derived. List names match `pub_id`.}
#'     \item{`abstract`}{Abstract of publication, or `NA` when unavailable.}
#'     \item{`annotation`}{Annotation summarizing the publication, or `NA` when none
#'       is provided.}
#'     \item{`annotation_src`}{Identifier (`pub_id`) of the publication the annotation
#'       was taken from, or `NA` when not applicable
#'       (Knobel and others, 2005; Bartholomay, 2022).}
#'     \item{`files`}{A named list of character vectors naming the file(s) associated
#'       with the publication, primary document first, or `NULL` when no files are
#'       recorded. List names match `pub_id`.}
#'   }
#'
#' @source Many of these publications are available through the
#'   [USGS Publications Warehouse](https://pubs.usgs.gov/).
#'
#' @references Bartholomay, R.C., 2022, Historical development of the U.S. Geological Survey
#'   hydrological monitoring and investigative programs at the Idaho National Laboratory, Idaho, 2002-2020:
#'   U.S. Geological Survey Open-File Report 2022-1027 (DOE/ID-22256), 54 p., \doi{10.3133/ofr20221027}.
#' @references Knobel, L.L., Bartholomay, R.C., and Rousseau, J.P., 2005,
#'   Historical development of the U.S. Geological Survey hydrologic monitoring and investigative programs
#'   at the Idaho National Engineering and Environmental Laboratory, Idaho, 1949 to 2001:
#'   U.S. Geological Survey Open-File Report 2005--1223 (DOE/ID--22195), 93 p.,
#'   \doi{10.3133/ofr20051223}.
#'
#' @seealso [`authors`] for the contributing authors referenced by `author_id`,
#'   [`terms`] for term frequencies derived from publication text, and
#'   [`search_terms`] to query publications by term.
#'
#' @keywords datasets
#'
#' @examples
#' # Subset Fisher and others (2012) and display its structure:
#' id <- "FisherOthers2012"
#' pub <- pubs[id, ]
#' str(pub, max.level = 3, width = 75, strict.width = "cut")
#'
#' # Print the suggested citation:
#' attr(unclass(pub$bibentry[[1]])[[1]], which = "textVersion")
#'
#' # Print the authors' full names:
#' format(pub$bibentry[[1]]$author, include = c("given", "family"))
#'
#' # Print the abstract:
#' pub$abstract

"pubs"
