我想在我的R包中包含静态小插图,这些小插图将使用R函数browseVignettes()
向用户显示。
我需要使这些小插图是静态的,因为这些小插图的构建时间太长,如果它们是动态包含的,则会导致我无法对Win-Builder进行CRAN检查。
R.rsp
软件包似乎完全可以提供我想要的东西;在这里描述:https://cran.r-project.org/web/packages/R.rsp/vignettes/R_packages-Static_PDF_and_HTML_vignettes.pdf。
我遵循了R.rsp
的指示。我有一个vignettes
文件夹,其中包含一个.html文件以及一个相应的.Rmd文件和一个.html.asis文件。我在DESCRIPTION文件中也有适当的代码。通过这些设置,我通过了win-builder,travis等上的CRAN测试。但是,当我从github下载该程序包时,它说没有与程序包关联的小插曲。我是否缺少有关R.rsp软件包的信息?这种功能过时了吗?我是否需要将构建的小插图从Vignettes文件夹复制到inst / doc文件夹? (我已经看到有关vignettes文件夹与inst / doc文件夹的冲突信息)。
是否正在使用R.rsp ::: as这样的最佳方式来包含渐晕片,而这种渐晕片需要花费很长时间才能构建才能动态包含?我见过的另一种方法是在.Rbuildignore中包含vignettes文件夹,然后在README文件中包含一条注释,告诉用户他们可以与github分开构建vignettes以查看它们。我还考虑在自述文件中包含指向外部小插图的链接。这是更好的方法吗? CRAN可能更喜欢哪个?
答案 0 :(得分:2)
将build_vignettes=TRUE
添加到您的install_github
通话中。