r - knitr .Rmd 小插图不会与 vignette() 一起出现

Question

在我使用 R Studio 开发的包中，我通过 devtools::use_vignette("mydoc.Rnw") 创建小插图，它提供了一个标准的小插图标题，例如

---
title: "Title"
author: "Michael Friendly"
date: "`r Sys.Date()`"
output: rmarkdown::html_vignette
vignette: >
  %\VignetteIndexEntry{Title}
  %\VignetteEngine{knitr::rmarkdown}
  %\VignetteEncoding{UTF-8}
---

我已遵循 http://yihui.name/knitr/demo/vignette/ 中的所有说明和 http://r-pkgs.had.co.nz/vignettes.html 。这些小插图列在该包的 CRAN 页面上，但在加载了该包的 R session 中似乎无法访问它们。

 > browseVignettes("matlib")
 No vignettes found by browseVignettes("matlib") 

> library(tools)
> names(vignetteEngine(package = 'matlib'))
Error in getEngine(name, package) : 
  None of packages ‘matlib’ have registered vignette engines

我知道其他带有 knitr 处理过的 .Rmd 小插图的包可以从该包访问，但不明白为什么我的不能。缺什么？

我的 vignettes/ 目录仅包含 .Rmd 文件(没有 PDF)，但这看起来与 https://github.com/yihui/knitr/tree/master/vignettes 相同。 .

Answer 1

注意，当您 devtools::install() 时，devtools 默认情况下不会构建小插图。 (对于某些 install_* 函数(如 install_github() )也是如此)目录中的包。您必须指定参数 build_vignettes = TRUE当您安装该软件包时。目前，如果您仅使用 RStudio 按钮，则无法使用 devtools 构建小插图 Build & Reload 。你必须Build Source Package ，然后运行 ​​R CMD INSTALL在压缩包上。或者运行devtools::install(build_vignettes = TRUE)在 R 控制台中。