Run Sweave (or other custom weave function)
texi2dvi, and/or Stangle
(or other custom tangle function) on one vignette.
This is the workhorse of R CMD Sweave.
buildVignette(file, dir = ".", weave = TRUE, latex = TRUE, tangle = TRUE,
quiet = TRUE, clean = TRUE, keep = character(),
engine = NULL, buildPkg = NULL, encoding, ...)character; the vignette source file
character; the working directory in which the intermediate and output files will be produced
logical; should weave be run?
logical; texi2pdf be run if weaving produces a .tex file?
logical; should tangle be run?
logical; run in quiet mode?
logical; whether to remove some newly created, often intermediate, files. See details below.
a list of file names to keep in any case when cleaning. Note that “target” files are kept anyway.
NULL or character; name of vignette engine to
use. Overrides any \VignetteEngine{} markup in the vignette.
NULL or character; an optional package in which to find
the vignette engine.
the encoding to assume for the file. If not specified, it will be inferred from the file contents.
Additional arguments passed to weave and tangle.
A character vector naming the files that have been produced.
This function determines the vignette engine for the vignette (default
utils::Sweave), then weaves and/or tangles the vignette using
that engine. Finally, if clean is TRUE, newly created
intermediate files (non “targets”, where these depend on the engine,
etc, and not any in keep) will be deleted. If clean is
NA, and weave is true, newly created intermediate output
files (e.g., .tex) will not be deleted even if a .pdf
file has been produced from them.
If buildPkg is specified, it will be loaded before the vignette
is processed, and will be used as the default package in the search
for a vignette engine, but an explicitly specified package in the
vignette source (e.g., using \VignetteEngine{utils::Sweave}
to specify the Sweave engine in the utils package) will
override it. In contrast, if the engine argument is given, it
will override the vignette source.
buildVignettes for building all vignettes in a package.