reprex() behaviour can be controlled via an option, providing a way
for the user to set personal defaults. The pattern for such option names is
<arg> is an argument of
reprex(). Here are the main
A few more options exist, but are only relevant to specific situations:
reprex.venue: Can be used to control the
venueused by the
reprex.current_venue: Read-only option that is set during
reprex_render(). Other packages that want to generate reprex-compatible output can consult it via
getOption("reprex.current_venue"), if they want to tailor their output to the
FALSE, reprex makes no attempt to access the user's clipboard, ever. This exists mostly for internal use, i.e. we set it to
FALSEwhen we detect use from RStudio Server. But a user could set this to
FALSEto explicitly opt-out of clipboard functionality. A Linux user with no intention of installing
xselmight also do this.
reprex.highlight.hl_style: Only relevant to
venue = "rtf. Details are in the article reprex venue RTF.
reprex.highlight.font: See above.
reprex.highlight.font_size: See above.
reprex.highlight.other: See above.
Here's code you could put in
.Rprofile to set reprex options. It would be
rare to want non-default behaviour for all of these! We only do so here for
the sake of exposition:
options( reprex.advertise = FALSE, reprex.session_info = TRUE, reprex.style = TRUE, reprex.html_preview = FALSE, reprex.comment = "#;-)", reprex.tidyverse_quiet = FALSE, reprex.std_out_err = TRUE, reprex.venue = "html", # NOTE: only affects reprex_selection()! reprex.highlight.hl_style = "acid", # NOTE: only affects RTF venue reprex.highlight.font = "Andale Mono Regular", reprex.highlight.font_size = 35, reprex.highlight.other = "--line-numbers" )
usethis::edit_r_profile() is handy for creating and/or opening
Arguments that appear like so in
reprex(..., arg = opt(DEFAULT), ...)
get their value according to this logic:
-specified value or, if not given, usergetOption("reprex.arg") or, if does not exist, DEFAULT
It's shorthand for:
f(..., arg = getOption("reprex.arg", DEFAULT), ...)
This is not an exported function and should not be called directly.