autolink {downlit} | R Documentation |
Automatically link inline code
Description
Automatically link inline code
Usage
autolink(text)
autolink_url(text)
Arguments
text |
String of code to highlight and link. |
Value
If text
is linkable, an HTML link for autolink()
, and or just
the URL for autolink_url()
. Both return NA
if the text is not
linkable.
Options
downlit provides a number of options to control the details of the linking. They are particularly important if you want to generate "local" links.
-
downlit.package
: name of the current package. Determines whentopic_index
andarticle_index
-
downlit.topic_index
anddownlit.article_index
: named character vector that maps from topic/article name to path. -
downlit.rdname
: name of current Rd file being documented (if any); used to avoid self-links. -
downlit.attached
: character vector of currently attached R packages. -
downlit.local_packages
: named character vector providing relative paths (value) to packages (name) that can be reached with relative links from the target HTML document. -
downlit.topic_path
anddownlit.article_path
: paths to reference topics and articles/vignettes relative to the "current" file.
Examples
autolink("stats::median()")
autolink("vignette('grid', package = 'grid')")
autolink_url("stats::median()")