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。