包发布到CRAN时缺少Vignette目录

Question

我最近发布了我的R包的1.1版本的小插图。小插曲的Rmd可以在here上找到。当我在本地创建vignette时，正如预期的那样，我在vignette的顶部看到了作者信息和目录。但是，当我向CRAN提交了这个包，并且vignette被创建为there时，我再也看不到目录或作者信息。有人知道为什么会发生这种情况吗？

谢谢。

Answer 1

我扫了一眼您的DESCRIPTION here，注意到VignetteBuilder字段没有包含rmarkdown。由于您使用knitr::rmarkdown作为引擎，我怀疑您需要：

VignetteBuilder: knitr, rmarkdown

以下是R-exts手册中的相关段落：

VignetteBuilder字段名称(在逗号分隔的列表中)包，这些包提供了构建小插曲的引擎。这些包可能包括当前的包，也可能是Depends、Suggests或Imports中列出的包。utils包始终是隐式附加的。有关详细信息，请参见Non-Sweave vignettes。注意，例如，如果一个vignette有引擎knitr::rmarkdown，那么knitr提供了引擎，但是使用它需要knitr和rmarkdown，所以这两个包都需要在VignetteBuilder字段中，并且至少是建议的(因为rmarkdown只由knitr建议，因此不会随其自动提供)。许多使用knitr的包也需要它建议的formatR包，因此用户包也需要这样做，并将其包含在VignetteBuilder中。

这不是一个保证修复，但它可能是第一步。