r - 在哪里放置用于CRAN提交的小插曲？

Question

从Writing R Extensions Manual，我读到

As from R 2.14.0 the preferred location for the Sweave sources is the subdirectory vignettes of the source packages, but for compatibility with earlier versions of R, vignette sources will be looked for in inst/doc if vignettes does not exist.

但是，当我创建包源的 vignettes子目录时，当我运行 devtools::check()或 R CMD check时，会收到 Package vignette(s) without corresponding PDF的警告。如果我将小插图(.Rnw和.pdf)放在 inst/doc中，则检查会完成而不会产生投诉。我尝试在我的库中查看已安装的打包文件，但没有看到任何名为 vignettes的目录。我是否仍应使用已弃用的位置？

Answer 1

您可以像以前一样将.Rnw源代码放入vignettes/中，但是却错过了关键步骤。不要检查源代码树。预期的工作流程是构建源tarball，然后检查该tarball。构建tarball将创建小插图PDF。

R CMD build ../foo/pkg
R CMD check ./pkg-0.4.tar.gz

例如，将根据 ../foo/pkg中的源代码构建源代码包tarball，并在当前目录中创建 .tar.gz软件包，并在其中添加软件包名称和版本。然后，您在该源包上运行 R CMD check。

如果要为您的小插图构建，请将其放入 vignettes/并构建源包。在将来的某个日期，R Core可能会从 inst/doc中删除构建小插图的功能，因此请立即使用建议的位置，并避免直接检查源代码。