litr project

创造litr

注意：如果您希望使用litr软件包，请访问此处的litr网站，您可以在其中了解该软件包。如果您对litr制作方法感兴趣，那么您来对地方了。

背景

litr R 包允许人们使用文字编程来编写 R 包。 litr的开发人员是文学编程的信徒，因此很自然地希望使用文学编程来开发litr 。由于显而易见的原因，在 litr 出现之前我们无法使用litr 。因此，我们以标准的非文字方式编写了最初的可行版本，并将其发布为 v0.0.1。我们可以将其视为“基本情况”。这是以传统方式编写的最后一个版本。 litr的每个后续版本都将使用litr的先前版本生成。特别是， litr的 v0.0.2 在功能上等同于 v0.0.1，但该包是在生成的 .Rmd 文件中定义的；对 v0.0.1 的litr::render()调用输出litr包 v0.0.2。这一切听起来可能很复杂，但人们可以将其视为操作系统开发人员如何在运行操作系统的先前稳定版本的计算机上编写代码。

如何使用以前的版本生成新版本的litr

要创建litr的新版本，我们首先安装最新版本，然后对create-litr.Rmd进行任何所需的更改，然后使用已安装版本的litr::render()创建新版本：

 remotes :: install_github( " jacobbien/litr-project@*release " , subdir = " litr " )
litr :: render( " create-litr/index.Rmd " )

在上面的代码中， @*release代表最新版本。例如，在创建版本0.0.2时，这将是v0.0.1 。

这将生成新版本的litr以及此 bookdown。从那里，您可以像任何其他包一样构建/安装。要检查包，请使用

 devtools :: check( " litr " , document = FALSE )

document = FALSE会阻止devtools在内部运行其版本的document() ，这会覆盖litr::document()所做的修改。

有关为litr做出贡献的更多说明，请参阅 CONTRIBUTING.md。