PDF documentation of local R package

2019-07-24 07:02发布

问题:

I created a local R package using roxygen2 and devtools. It seem work well but I would like to know how I get the complete PDF documentation then. Since the DESCRIPTION and .Rd files are created by roxygen2 automatically, I'd think there's a easy way to translate them into a single PDF document.

回答1:

I think there's a command here for you: R CMD Rd2pdf. From its help:

edd@max:~$ R CMD Rd2pdf --help
Usage: R CMD Rd2pdf [options] files

Generate PDF output from the Rd sources specified by files, by
either giving the paths to the files, or the path to a directory with
the sources of a package, or an installed package.

Unless specified via option '--output', the basename of the output file
equals the basename of argument 'files' if this specifies a package
or a single file, and 'Rd2' otherwise.

The Rd sources are assumed to be ASCII unless they contain \encoding
declarations (which take priority) or --encoding is supplied or if using
package sources, if the package DESCRIPTION file has an Encoding field.
The output encoding defaults to the package encoding then to 'UTF-8'.

Files are listed in the order given: for a package they are in alphabetic
order of the \name sections.

Options:
  -h, --help            print short help message and exit
  -v, --version         print version info and exit
      --batch           no interaction
      --no-clean        do not remove created temporary files
      --no-preview      do not preview generated PDF file
      --encoding=enc    use 'enc' as the default input encoding
      --outputEncoding=outenc
                        use 'outenc' as the default output encoding
      --os=NAME         use OS subdir 'NAME' (unix or windows)
      --OS=NAME         the same as '--os'
  -o, --output=FILE     write output to FILE
      --force           overwrite output file if it exists
      --title=NAME      use NAME as the title of the document
      --no-index        don't index output
      --no-description  don't typeset the description of a package
      --internals       typeset 'internal' documentation (usually skipped)

The output papersize is set by the environment variable R_PAPERSIZE.
The PDF previewer is set by the environment variable R_PDFVIEWER.

Report bugs at bugs.r-project.org .
edd@max:~$ 


标签: r package