Set individual keys in a configuration fileSource:
Set individual keys in a configuration file
a named character vector with keys as the names and the new values as the contents
TRUE, any new values in
pairswill be created and appended; defaults to
FALSE, which prevents typos from sneaking in. single key-pair values currently supported.
path to the lesson. Defaults to the current directory.
TRUE, the schedule will overwrite the schedule in the current file.
This function deals strictly with keypairs in the yaml. For lists, see
When you create a new lesson in sandpaper, there are a set of default keypairs that are pre-filled. To make sure contact information and links in the footer are accurate, please modify these values.
[character]one of cp, dc, swc, lab, incubator
[character]the lesson title (e.g.
'Introduction to R for Plant Pathologists'
[character]Date in ISO 8601 format (e.g.
[character]comma-separated list (e.g
'static site, R, tidyverse')
[character]one of pre-alpha, alpha, beta, stable
[character]a license for the lesson (e.g.
[character]the source repository URL
[character]the default branch (e.g.
[character]an email address of who to contact for more information about the lesson
The following keypairs are known by sandpaper, but are optional:
[character]custom URL if you are deploying to a URL that is not the default github pages io domain.
[boolean]for R Markdown lessons; fail the build if any chunks produce an error. Use
#| error: truein chunk options to allow the error to be displayed
[boolean]if truthy, this displays a banner on the site that indicates the site is in the workbench beta phase.
As the workbench becomes more developed, some of these optional keys may disappear.
To use a specific version of sandpaper or varnish locally, you would install
but to provision these versions on GitHub, you can provision these in the
[character]github string or version number of sandpaper version to use
[character]github string or version number of varnish version to use
For example, if you had forked your own version of varnish to modify the colourscheme, you could use:
If there is a specific branch of sandpaper or varnish that is being tested,
and you want to test it on your lesson temporarily, you could use the
symbol to refer to the specific branch or commit to use:
: carpentries/sandpaper@BRANCH-NAME sandpaper: carpentries/varnish@BRANCH-namevarnish