Every render sets the genera and species in the titles of the reference
list in italics, and says – once per session – which cases it could not
settle and what to write in the .bib to settle them. This says it again,
without rendering. How the names are found is in italicize_species().
Arguments
- path
The project, or any folder inside it. Left out, the one
set_paper()named; with none named, this stops before writing: it writes into the project, and easypaper never takes the working directory for it.
Details
Unlike the checks of checks, which only read, this writes: what GBIF
and Wikipedia said about each name it looks up is kept in
references/species_cache.rds. Commit it: with it every computer renders
the same italics, offline, years from now. Delete it to have every name
looked up again. italicize-species: false in the easypaper: block of
_quarto.yml turns the italics off.
See also
italicize_species(), the same for any bibliography outside a
project.
Examples
dir <- file.path(tempdir(), "my_paper")
create_paper(dir, git = FALSE)
#> Project created: /tmp/Rtmp92gqjt/my_paper
#> 1. open my_paper.Rproj
#> 2. library(easypaper)
#> 3. set_paper(".") # the project to work on, once a session
#> 4. render_html() # see ?render for every command
# Offline: only the cache answers, and a name it does not know stays in
# roman, with a warning. Online, a render looks each new name up once.
old <- options(easypaper.species_offline = TRUE)
if (rmarkdown::pandoc_available()) try(check_species(dir))
#> Scientific names in italics (2): Maculinea rebeli, Myrmica
options(old)
unlink(dir, recursive = TRUE)