autolink_html: Automatically link references and articles in an HTML page

In Paradigm4/pkgdown: Make Static HTML Documentation for a Package

Description

The autolinker is built around two XPath expressions:

• //pre[contains(@class, 'r')]: this finds all <div>s with class sourceCode and r. The contents must be syntax-highlighted using pygments. (This is default in rmarkdown::html_document() when theme = NULL.)

• .//code[count(*) = 0]: this finds all <code> that contain only text (and no other tags).

Usage

autolink_html(input, output = input, local_packages = character())

Arguments

input, output	Input and output paths for HTML file
local_packages	A named character vector providing relative paths (value) to packages (name) that can be reached with relative links from the target HTML document.

Details

Currently the following expressions are linked:

• Function calls, foo()

• Function calls qualified with the package name, bar::foo()

• Symbols qualified with the package name, bar::baz

• library(), require() and requireNamespace() calls.

• Help calls, ?foo, package?foo, ?bar::foo, help(foo), help(foo, package = bar), help(package = bar).

• Vignette calls, vignette(baz), vignette(baz, package = "bar")

Calls to library() and require() are used to find the topics connected to unqualified references.

Examples

## Not run: 
autolink_html("path/to/file.html",
  local_packages = c(
    shiny = "shiny",
    shinydashboard = "shinydashboard"
  )
)

## End(Not run)

Paradigm4/pkgdown documentation built on June 3, 2020, 12:30 a.m.