如何以多种格式生成R包装晕影？

Question

我使用knitr和rmarkdown为R包编写晕影.由于pandoc的神奇之处,很容易将这些文档转换为各种格式.我想通过提供HTML和PDF的插图来利用这一点.rmarkdown支持在文档元数据块中指定多种输出格式的参数.例如,我可能会有这样的事情:

output:
  html_document:
    standalone: true
    smart: true
    normalize: true
    toc: true
    highlight: tango
    self-contained: true
    theme: cerulean
  pdf_document:
    toc: true
    highlight: tango
geometry: margin=2cm
documentclass: article
classoption: a4paper

从R命令行我可以rmarkdown::render用来构建一个或两个输出文档没有困难.但是,在构建包时,仅使用首先列出的输出格式.我试图包含一个Makefile,它通过包含一些东西来构建

all: %.Rmd
    $(R_HOME)/bin/Rscript -e "rmarkdown::render('$*.Rmd', 'all')"

并且这是成功的,因为生成了所有输出文件但是其中只有一个被R识别为晕影.要获得包含的其他输出,docs/必须将它们添加到.install_extras.虽然这确保它们可以通过HTML索引访问,但它们与小插图分开列出,我认为不能从R(via vignette())中访问它们.

有没有更好的方法(或任何自动方式)来做到这一点？

Answer 1

两件事情：

1. 您可以“包含”公共内容并拥有两个具有不同标头的源文件，或者，

2. 如果额外的小插图确实没有出现在索引中，请编写自己的小插图。来自编写 R 扩展：“在安装时，将自动从 \VignetteIndexEntry 语句创建包中所有小插图的 HTML 索引，除非目录 inst/doc 中存在文件 index.html。此索引链接自 HTML 帮助索引包裹。” 小插图索引条目也可能是一个线索，让您可能同名的小插图被识别为不同的。