litr project

Criando litr

Nota: Se você deseja usar o pacote litr , visite o site litr aqui, onde poderá aprender mais sobre o pacote. Se você está interessado em saber como litr é feito, você está no lugar certo.

Fundo

O pacote litr R permite escrever pacotes R usando programação alfabetizada. Os desenvolvedores do litr acreditam na programação alfabetizada e, portanto, naturalmente, desejam usar a programação alfabetizada para desenvolver litr . Por razões óbvias, não podíamos usar litr antes de ele existir. Então, escrevemos a versão inicial viável de uma forma padrão e não alfabetizada e a lançamos como v0.0.1. Podemos pensar nisso como o “caso base”. Esta é a última versão escrita da forma tradicional. Cada versão subsequente de litr será gerada usando a versão anterior de litr . Em particular, v0.0.2 de litr é funcionalmente equivalente a v0.0.1, mas o pacote é definido em um arquivo gerador .Rmd; uma chamada para litr::render() da v0.0.1 gera o pacote litr v0.0.2. Tudo isso pode parecer complicado, mas pode-se pensar nisso como a forma como os desenvolvedores de um sistema operacional provavelmente escrevem seu código em um computador que está executando a versão estável anterior do sistema operacional.

Como gerar uma nova versão do litr usando a versão anterior

Para criar uma nova versão de litr , primeiro instalamos a versão mais recente, depois fazemos as alterações desejadas em create-litr.Rmd e então usamos litr::render() da versão instalada para criar a nova versão:

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

No código acima, @*release representa a versão mais recente. Por exemplo, no momento da criação da versão 0.0.2 , esta seria v0.0.1 .

Isso irá gerar a nova versão do litr junto com este bookdown. A partir daí, você pode compilar/instalar como faria com qualquer outro pacote. Para verificar o pacote, use

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

O document = FALSE impede que devtools executem sua versão de document() internamente, o que substituiria as modificações que litr::document() fez.

Para obter mais notas sobre como contribuir para litr , consulte CONTRIBUTING.md.