rmake (version 1.2.0)

knitrRule: Rule for building text documents by using the knitr package

Description

This rule is for execution of knitr in order to create the text file, as described in knitr::knit().

Usage

knitrRule(target, script, depends = NULL, params = list(), task = "all")

Value

Instance of S3 class rmake.rule

Arguments

target

Name of the output file to be created

script

Name of the RNW file to be rendered

depends

A vector of file names that the markdown script depends on, or NULL.

params

A list of R values that become available within the script in a params variable.

task

A character vector of parent task names. The mechanism of tasks allows to group rules. Anything different from 'all' will cause creation of a new task depending on the given rule. Executing make taskname will then force building of this rule.

Author

Michal Burda

Details

This rule executes the following command in a separate R process: library(knitr); params <- params; knitr::knit(script, output=target)

That is, parameters given in the params argument are stored into the global variable and then the script is processed with knitr. That is, the re-generation of the Makefile with any change to params will not cause the re-execution of the recipe unless any other script dependencies change.

Issuing make clean from the shell causes removal of all files specified in target parameter.

See Also

markdownRule(), rule(), makefile(), rRule()

Examples

r <- knitrRule(target='report.tex',
               script='report.Rnw',
               depends=c('data1.csv', 'data2.csv'))

# generate the content of a makefile (as character vector)
makefile(list(r))

# generate to file
tmp <- tempdir()
makefile(list(r), file.path(tmp, "Makefile"))