我想在我的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 :: asis这样的最佳方式来包含需要花费很长时间才能构建而无法动态包含的小插图?我见过的另一种方法是在.Rbuildignore中包含vignettes文件夹,然后在README文件中包含一条注释,告知用户可以与github分开构建vignettes以便查看它们。我还考虑在自述文件中包含指向外部小插图的链接。这是更好的方法吗? CRAN更喜欢哪个?

最佳答案

build_vignettes=TRUE添加到您的install_github呼叫中。

09-03 18:50