Create a month-to-month bibliography of selected units

Create a bibliography in a newsletter format from month-to-month From either a specified unit or a set of units (e.g., A University -> Faculties -> Departments -> Groups).

CristinMonthly(
  zotero,
  unit.id,
  unit.recursive = TRUE,
  sdg.host = NULL,
  sdg.batch = 20,
  get.unpaywall = FALSE,
  get.ezproxy = FALSE,
  ezproxy.host = "inn.no",
  local.storage = NULL,
  style = "apa-single-spaced",
  locale = "nn-NO",
  start.date = Sys.Date(),
  end.date = NULL,
  use.filter = TRUE,
  filter = NULL,
  nvi = TRUE,
  check.items = TRUE,
  use.identifiers = TRUE,
  use.multisession = FALSE,
  min.multisession = 25,
  n.workers = NULL,
  handler = NULL,
  restore.defaults = TRUE,
  use.citeproc = FALSE,
  citeproc.host = NULL,
  full.update = FALSE,
  lang = "nn",
  post.lang = "nn",
  post = FALSE,
  post.only = FALSE,
  silent = FALSE,
  cristin.silent = TRUE,
  log = list()
)

Arguments

zotero

What Zotero library to use

unit.id

What unit to search for

unit.recursive

Find subunits of defined unit key, Default: TRUE

sdg.host

host conducting SDG predictions, Default: NULL

sdg.batch

The batch size for each API call to the SDG host, specifying the number of items to be processed per request., Default: 20

get.unpaywall

Find Unpaywall resources, Default: FALSE

get.ezproxy

Use ezproxy, Default: FALSE

ezproxy.host

ezproxy host, Default: 'inn.no'

local.storage

Path to local storage of collections, items and bibliography, Default: 'NULL'

style

Citation style to use for appended bibliography and/or citations, Default: 'apa-single-spaced'

locale

Desired language format of bibliography, Default: 'nn-NO'

start.date

Results created from specified date (YYYY-MM), Default: Sys.Date()

end.date

Results created before specified date (YYYY-MM), Default: NULL

use.filter

Filter out specific items (otherwise supported by `CristinWrangler`), Default: TRUE

filter

Filter out specific item types, will default to item types usually associated with NVI, Default: NULL

nvi

Filter out Cristin items not 1/2 in NVI, Default: TRUE

check.items

Examine items for duplicates and multidepartemental publications, Default: TRUE

use.identifiers

Use if ISBN/DOI identifiers if enabled, Default: TRUE

use.multisession

Logical. If TRUE (default), parallel processing using multisession is employed; otherwise, processing is sequential.

min.multisession

Minimum number of results for using multisession. Default: 25

n.workers

Optional integer for the number of workers to be used in multisession mode. If NULL, it defaults to the number of available cores minus one (with a minimum of one).

handler

The progress handler to be used by the progressr package. If NULL and silent is FALSE, it defaults to "txtprogressbar". When silent is TRUE, the handler is set to "void".

restore.defaults

Logical. If TRUE (default), the current future plan is saved and restored upon exit.

use.citeproc,

Use local citeproc and translator to create bibliography, Default: FALSE

citeproc.host

host for creating citeproc bibliography, Default: NULL

full.update

Update bibliography for all items in library, Default: FALSE'

lang

Define bibliography language (nn, nb, en), Default: 'nn'

post.lang

Define language for Zotero collections (nn, nb, en), Default: 'nn'

post

Post new items to specified Zotero library, Default: FALSE

post.only

Post new items and nothing more, Default: FALSE

silent

c2z is noisy, tell it to be quiet, Default: FALSE

cristin.silent

keep queries to Cristin quiet Default: TRUE

log

A list for storing log elements, Default: list()

Value

A list with bibliography and information for defined units

Details

Used with `CristinUnits` to create month-to-month bibliography of selected units

See also

filter, arrange, mutate, bind_rows, bind_cols, select, group_by, case_when, context, distinct, pull, mutate-joins, join_by, rename, across, reexports, mutate_all pmap, map tibble setNames

Examples

# \donttest{
  # Create monthlies for unit 209.5.10.0
  example <- CristinMonthly(
    c2z::Zotero(
      id = "4827927",
      api = "Io1bwAiOjB1jPgUNegjJhJxF",
      user = FALSE
    ),
    unit.id = "209.5.10.0",
    start.date = "2023-07",
    post = TRUE,
    silent = TRUE
  ) |>
  c2z:::GoFish(type = NULL)

  # Print the three first individual pages (if any)
  if (!is.null(example$monthlies)) {
    example$monthlies |>
      dplyr::select(title) |>
      print(n = 3, width = 80)
  }
# }