我的包托管在github上,用户可以通过
devtools::install_github
安装它。
现在我使用 pkgdown 生成文档站点,它创建了一个 10M 的文档文件夹。然后我发现
devtools::install_github
总是下载整个主zip球,这变得相当慢。
我尝试通过这些尝试排除 docs 文件夹:
.Rbuildignore
,原来只是捆绑包,而install_github
正在安装源码包,所以不起作用。pkg
文件夹中,将生成的docs
文件夹放入pkg
文件夹中。然而,即使指定了 subdir = "pkg"
,整个主压缩球仍然会被下载。pkgdown
在该文件夹中创建网站,就像build_site(path = "../docsite/docs")
一样。这应该可以解决问题并且简单干净。唯一的缺陷是网站网址不是通常的模式。编辑:使用最新版本的
pkgdown
,不再有path
参数,您需要在站点配置yaml中指定它,这样效果更好(您不需要在每个命令中指定它)。
.gitattributes
文件添加到您的存储库,列出您不希望下载的文件夹(作为包的一部分),每个文件夹都具有“export-ignore”属性。
例如,如果您不想将文件夹“foldertoexclude”作为包的一部分下载,则文件
.gitattributes
将包含以下行:
foldertoexclude export-ignore
您可以在该文件夹中放入处理包所需的任何类型的脚本和对象,但它们不属于可下载包的一部分。
警告:这会影响您的存储库作为 tarball 下载的方式。如果有人想要下载您的存储库的副本 – 不是为了安装软件包,而只是为了修改您的项目 – 那么他们下载的 tarball 将不包含“foldertoexclude”文件夹。