2

我们小组将 R 包(供内部使用)发布到类似 CRAN 的存储库。用户(正确地)抱怨说,如果不启动 R 并以?function_name交互方式进行操作,他们就不能很容易地访问文档。

所以我想建立一个网站,其中包含我小组创建的所有版本的 R 包的文档。

如果我pkgdown::build_site()在包的顶级目录中执行此操作,则会创建一个很好的自包含树docs/,其中包含 HTML 文件以及该包的所有文档。它甚至在每一页的顶部都有一个突出的版本号,这很好。

现在我想将该文档树放在一个更大的站点中,以便用户可以浏览到他们正在寻找的包,查看以前的版本等。有人为此设置了解决方案吗?

我认为该docs/目录可以简单地rsync连接到网络服务器,从 info in 构建路径DESCRIPTION,例如:

Rscript -e 'pkgdown::build_site()'
mkdir -p r-docs/MyPackage        # Replace with real package name
mv docs r-docs/MyPackage/1.3.1   # Replace with real version
rsync -avz r-docs/ example.com:r-docs/

但这重复做有点尴尬——在pkgdown或其他类似的包中是否有对这个用例的支持(不一定与 相关pkgdown,会使用最合适的包)?

4

0 回答 0