drat

drat: Drat R 存档模板

drat

可爱的人生气时说的话

"哎呀,我丢了钱包"

城市词典

特别注意

请不要复刻_这个_仓库来快速创建你的drat，请改为复刻这个仓库。详情见下文。

背景

R包生态系统是R语言成功的基石之一。截至2020年7月，CRAN上有超过16000个包，BioConductor上还有约一千个。

R对多个仓库的支持深深植根于其中，主要通过(默认的)utils包实现。update.packages函数(以及utils包中的其他几个函数)可以轻松用于这三个默认仓库以及许多其他仓库。但似乎缺少对_简单创建和使用_本地仓库的支持。

Drat试图在这里提供帮助，支持两种主要模式：

• 通过利用gh-pages的GitHub模式
• 通过使用其他可写入并提供html访问的存储的其他仓库模式

请查看下一节了解如何入门，包文档，drat包页面或关于drat的博客部分以获取更多信息。

入门

请不要复刻_这个_仓库来快速创建你的drat，请改为复刻这个仓库。详情见下文。

请参阅以下小册子：

• Drat常见问题
• 面向包作者的Drat
• 面向包用户的Drat
• Drat逐步指南
• 为什么选择Drat？
• 结合Drat和Travis
• useR!2015上的Drat闪电演讲

了解常见问题、两个主要用例、基本动机和概述/介绍。包文档提供了更多细节。drat包页面有更长的教程，关于drat的博客部分有更多内容。

包文档、帮助页面、小册子等也可在这里找到。

安装

首选方法是通过标准命令从 CRAN 安装已发布的软件包：

install.packages("drat")

快速开始创建您自己的 Drat

drat 自带了一个存储库创建助手函数 initRepo，但更快捷的方式可能是 fork 一个现有的存储库。这已经在原始存储库上多次完成。然而，随着时间的推移，这个存储库积累了代码改进和更多文档，使其变得有些笨重。因此，我们设置了一个专用存储库，只是为了方便 drat 的 fork。克隆它，您就会得到一个可以直接使用的 drat 存储库。

状态

该软件包自 2015 年春季起已在 CRAN 上提供，并开始得到一些使用。可能的改进、添加和下一步计划列在 TODO.md 文件中。

一些 drat 存储库开始出现（除了这个之外）。以下是一个不完整的列表（查看直接 fork 以及 GitHub 搜索）：

• yutannihilation
• gschofl
• csgillespie
• shabbychef
• RcppCore
• arilamstein
• piccolbo
• ghrr
• cloudyr
• dmlc
• thospfuller

rOpenSci 项目使用 drat 分发他们的代码，并写了一篇很好的博客文章介绍它。

Travis 集成

Colin Gillespie 将 Travis CI 与 drat 集成，详情请参见他的 dratTravis 存储库，以及贡献的小文章 Combining Drat and Travis。

GitHub Actions

Mike Mahoney 在 GitHub Actions 的 'push' 设置中使用 drat，而 Zhian Kamvar 则在 GitHub Actions 的 'pull' 设置中使用 drat。

作者

Dirk Eddelbuettel，以及 Felix Ernst、Neal Fultz、Colin Gillespie、Christoph Stepper、Thomas Leeper、Mark van der Loo、Jan Gorecki 等人的贡献。

许可证

GPL (>= 2)